รูปแบบโฆษณาเนทีฟที่กําหนดเอง

รูปแบบโฆษณาเนทีฟที่กำหนดเอง

นอกเหนือจากรูปแบบโฆษณาเนทีฟที่ระบบกำหนดแล้ว ผู้เผยแพร่โฆษณาของ Ad Manager ยังมีตัวเลือกในการสร้างรูปแบบโฆษณาเนทีฟของตนเองโดยกำหนดรายการเนื้อหาที่กำหนดเอง รูปแบบเหล่านี้เรียกว่ารูปแบบโฆษณาเนทีฟที่กำหนดเอง และใช้กับโฆษณาที่จองไว้ได้ วิธีนี้ช่วยให้ผู้เผยแพร่โฆษณาส่งผ่านข้อมูลที่มีโครงสร้างที่กำหนดเองไปยังแอปของตนได้ โฆษณาเหล่านี้จะแสดงด้วยออบเจ็กต์ NativeCustomFormatAd

โหลดรูปแบบโฆษณาเนทีฟที่กำหนดเอง

คู่มือนี้จะอธิบายวิธีโหลดและแสดงรูปแบบโฆษณาเนทีฟที่กำหนดเอง

สร้าง AdLoader

รูปแบบโฆษณาเนทีฟที่กำหนดเองจะโหลดโดยใช้คลาส AdLoader เช่นเดียวกับโฆษณาเนทีฟ

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
          @Override
          public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
              // Show the custom format and record an impression.
          }
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/6499/example/native")
        .forCustomFormatAd("10063170",
            { ad ->
                // Show the custom format and record an impression.
            },
            { ad, s ->
            // Handle the click action
            })
        .withAdListener( ... )
        .withNativeAdOptions( ... )
        .build()

เมธอด forCustomFormatAd จะกำหนดค่า AdLoader ให้ขอรูปแบบโฆษณาเนทีฟที่กำหนดเอง มีพารามิเตอร์ 3 ตัวที่ส่งผ่านไปยังเมธอด ได้แก่

• รหัสของรูปแบบโฆษณาเนทีฟที่กำหนดเองที่ AdLoader ควรขอ รูปแบบโฆษณาเนทีฟที่กำหนดเองแต่ละรูปแบบจะมีรหัสเชื่อมโยงอยู่ พารามิเตอร์นี้ระบุรูปแบบที่แอปต้องการให้ AdLoader ขอ
• ระบบจะเรียกใช้ OnCustomFormatAdLoadedListener เมื่อโฆษณาโหลดสำเร็จ
• OnCustomClickListener (ไม่บังคับ) ที่จะเรียกใช้เมื่อผู้ใช้แตะหรือคลิกที่โฆษณา หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับการฟังนี้ ให้ดูส่วน "การจัดการการคลิกและการแสดงผล" ด้านล่าง

เนื่องจากหน่วยโฆษณา 1 รายการสามารถตั้งค่าให้แสดงรูปแบบครีเอทีฟโฆษณาได้มากกว่า 1 รูปแบบ ระบบจึงอาจเรียกใช้ forCustomFormatAd ได้หลายครั้งด้วยรหัสรูปแบบที่ไม่ซ้ำกัน เพื่อเตรียมตัวโหลดโฆษณาสำหรับรูปแบบโฆษณาเนทีฟที่กำหนดเองที่เป็นไปได้มากกว่า 1 รูปแบบ

หมายเหตุ: คุณใช้ forNativeAd และ forCustomFormatAd พร้อมกันกับ AdLoader รายการเดียวได้หากคุณมีหน่วยโฆษณาที่กำหนดค่าให้แสดงโฆษณาหลายรูปแบบ

รหัสรูปแบบโฆษณาเนทีฟที่กำหนดเอง

รหัสรูปแบบที่ใช้ระบุรูปแบบโฆษณาเนทีฟที่กำหนดเองจะอยู่ใน UI ของ Ad Manager ในส่วนโฆษณาเนทีฟภายในเมนูแบบเลื่อนลงการแสดงโฆษณา ดังนี้

รหัสรูปแบบโฆษณาเนทีฟที่กำหนดเองแต่ละรหัสจะปรากฏข้างชื่อโฆษณา การคลิกชื่อใดชื่อหนึ่งจะนำคุณไปยังหน้าจอรายละเอียดที่แสดงข้อมูลเกี่ยวกับช่องของรูปแบบ ดังนี้

คุณจะเพิ่ม แก้ไข และนำช่องแต่ละช่องออกได้จากที่นี่ จดชื่อของแต่ละเนื้อหา ชื่อเป็นคีย์ที่ใช้รับข้อมูลของเนื้อหาแต่ละรายการ เมื่อแสดงรูปแบบโฆษณาเนทีฟที่กำหนดเองของคุณ

รูปแบบโฆษณาเนทีฟที่กำหนดเองในเครือข่ายดิสเพลย์

รูปแบบโฆษณาเนทีฟที่กำหนดเองแตกต่างจากรูปแบบที่ระบบกำหนดตรงที่ผู้เผยแพร่โฆษณาจะมีอำนาจในการกำหนดรายการเนื้อหาที่ประกอบขึ้นเป็นโฆษณาของตนเอง ดังนั้น กระบวนการแสดงโฆษณาจึงแตกต่างจากรูปแบบที่ระบบกำหนดใน 2-3 รูปแบบ ดังนี้

1. เนื่องจากคลาส NativeCustomFormatAd มีไว้เพื่อจัดการรูปแบบโฆษณาเนทีฟที่กำหนดเองซึ่งคุณกำหนดไว้ใน Ad Manager จึงไม่ได้ตั้งชื่อว่า "getters" สำหรับเนื้อหา แต่จะมีเมธอดอย่างเช่น getText และ getImage ที่ใช้ชื่อช่องเป็นพารามิเตอร์
2. ไม่มีคลาสการดูโฆษณาเฉพาะอย่าง NativeAdView เพื่อใช้กับ NativeCustomFormatAd คุณสามารถใช้เลย์เอาต์ใดก็ได้ที่เหมาะกับประสบการณ์ของผู้ใช้
3. เนื่องจากไม่มีคลาส ViewGroup โดยเฉพาะ คุณจึงไม่จำเป็นต้องบันทึกมุมมองใดๆ ที่คุณใช้เพื่อแสดงเนื้อหาของโฆษณา ทำให้ประหยัดโค้ดได้ 2-3 บรรทัดเมื่อแสดงโฆษณา แต่ก็หมายความว่าคุณจะต้องทำงานเพิ่มเติมอีกเล็กน้อยเพื่อรองรับการคลิกในภายหลัง

ต่อไปนี้คือฟังก์ชันตัวอย่างที่แสดง NativeCustomFormatAd

Java

public void displayCustomFormatAd (ViewGroup parent,
                                     NativeCustomFormatAd customFormatAd) {
    // Inflate a layout and add it to the parent ViewGroup.
    LayoutInflater inflater = (LayoutInflater) parent.getContext()
            .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    View adView = inflater.inflate(R.layout.custom_format_ad, parent);

    // Locate the TextView that will hold the value for "Headline" and
    // set its text.
    TextView myHeadlineView = (TextView) adView.findViewById(R.id.headline);
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    Button myMainImageView = (ImageView) adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").getDrawable());

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

Kotlin

public fun displayCustomFormatAd (parent: ViewGroup,
                                customFormatAd: NativeCustomFormatAd) {
    val adView = layoutInflater
            .inflate(R.layout.ad_simple_custom_format, null)

    val myHeadlineView = adView.findViewById<TextView>(R.id.headline)
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    val myMainImageView = adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").drawable;

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

วิดีโอเนทีฟสำหรับรูปแบบโฆษณาเนทีฟที่กำหนดเอง

เมื่อสร้างรูปแบบที่กำหนดเอง คุณจะมีตัวเลือกในการทำให้รูปแบบดังกล่าวมีสิทธิ์แสดงในวิดีโอ

เมื่อใช้งานแอป คุณสามารถใช้ NativeCustomFormatAd.getMediaContent() เพื่อรับเนื้อหาสื่อ จากนั้นเรียก setMediaContent() เพื่อตั้งค่าเนื้อหาสื่อในมุมมองสื่อของคุณ หากโฆษณาไม่มีเนื้อหาวิดีโอ ให้เลือกแผนอื่นเพื่อแสดงโฆษณาโดยไม่มีวิดีโอ

หมายเหตุ: มุมมองสื่อของโฆษณาเนทีฟที่กำหนดเองจะไม่มีเนื้อหาหากไม่มีวิดีโอ ซึ่งต่างจากโฆษณาเนทีฟซึ่งมีรูปภาพในมุมมองสื่อเมื่อวิดีโอไม่พร้อมใช้งาน

ตัวอย่างด้านล่างจะตรวจสอบว่าโฆษณามีเนื้อหาวิดีโอหรือไม่ และแสดงรูปภาพแทนที่ในกรณีที่วิดีโอไม่พร้อมใช้งาน

Java

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(final NativeCustomFormatAd ad) {

  MediaContent mediaContent = ad.getMediaContent();

  // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
  FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
    mediaView.setMediaContent(mediaContent);
    mediaPlaceholder.addView(mediaView);

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    VideoController vc = mediaContent.getVideoController();
    vc.setVideoLifecycleCallbacks(
        new VideoController.VideoLifecycleCallbacks() {
          @Override
          public void onVideoEnd() {
            // Publishers should allow native ads to complete video playback before
            // refreshing or replacing them with another ad in the same UI location.
            super.onVideoEnd();
          }
        });
  } else {
    ImageView mainImage = new ImageView(this);
    mainImage.setAdjustViewBounds(true);
    mainImage.setImageDrawable(ad.getImage("MainImage").getDrawable());
    mediaPlaceholder.addView(mainImage);
    mainImage.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View view) {
            ad.performClick("MainImage");
          }
        });
  }
}

Kotlin

// Called when a custom native ad loads.
NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->

  val mediaContent = ad.mediaContent

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    val mediaView = MediaView(mediaPlaceholder.getContest())
    mediaView.mediaContent = mediaContent

    val videoController = mediaContent.videoController

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    if (videoController != null) {
      videoController.videoLifecycleCallbacks =
        object : VideoController.VideoLifecycleCallbacks() {
          override fun onVideoEnd() {
            // Publishers should allow native ads to complete video playback before refreshing
            // or replacing them with another ad in the same UI location.
            super.onVideoEnd()
          }
        }
    }
  } else {
    val mainImage = ImageView(this)
    mainImage.adjustViewBounds = true
    mainImage.setImageDrawable(ad.getImage("MainImage")?.drawable)

    mainImage.setOnClickListener { ad.performClick("MainImage") }
    customTemplateBinding.simplecustomMediaPlaceholder.addView(mainImage)
  }
}

ดูวิธีปรับแต่งประสบการณ์การใช้งานวิดีโอของโฆษณาเนทีฟที่กำหนดเองได้ที่ MediaContent

ดาวน์โหลดตัวอย่างการแสดงผลที่กำหนดเองของ Ad Manager เพื่อดูตัวอย่างการทำงานของวิดีโอเนทีฟที่ใช้งานได้

จำนวนคลิกและการแสดงผลของรูปแบบโฆษณาเนทีฟที่กำหนดเอง

เมื่อใช้รูปแบบโฆษณาเนทีฟที่กำหนดเอง แอปของคุณจะเป็นผู้รับผิดชอบการบันทึกการแสดงผลและการรายงานกิจกรรมการคลิกไปยัง SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

บันทึกการแสดงผล

หากต้องการบันทึกการแสดงผลสำหรับโฆษณารูปแบบที่กำหนดเอง ให้เรียกเมธอด recordImpression ใน NativeCustomFormatAd ที่เกี่ยวข้อง ดังนี้

myCustomFormatAd.recordImpression();

หากแอปเรียกใช้เมธอด 2 ครั้งสำหรับโฆษณาเดียวกันโดยไม่ได้ตั้งใจ SDK จะป้องกันไม่ให้มีการบันทึกการแสดงผลที่ซ้ำกันสำหรับคำขอเดียวโดยอัตโนมัติ

รายงานการคลิก

หากต้องการรายงานไปยัง SDK ว่ามีการคลิกในเนื้อหา ให้เรียกเมธอด performClick ใน NativeCustomFormatAd ที่เกี่ยวข้อง แล้วส่งผ่านชื่อของเนื้อหาที่มีการคลิก ตัวอย่างเช่น หากคุณมีเนื้อหาในรูปแบบที่กำหนดเองชื่อ "MainImage" และต้องการรายงานการคลิก ImageView ที่ตรงกับเนื้อหานั้น โค้ดของคุณจะมีลักษณะดังนี้

myCustomFormatAd.performClick("MainImage");

โปรดทราบว่าคุณไม่จำเป็นต้องเรียกใช้เมธอดนี้สำหรับทุกข้อมูลพร็อพเพอร์ตี้ที่เชื่อมโยงกับโฆษณาของคุณ หากคุณมีช่องอีกช่องหนึ่งชื่อ "คำบรรยายภาพ" ซึ่งกำหนดให้แสดงแต่ผู้ใช้ไม่ได้คลิกหรือแตะ แอปก็ไม่จำเป็นต้องเรียกใช้ performClick สำหรับการดูเนื้อหานั้น

ตอบสนองต่อการดำเนินการคลิกที่กำหนดเอง

เมื่อมีการคลิกในโฆษณารูปแบบที่กำหนดเอง SDK จะมีการตอบสนองที่เป็นไปได้ 3 แบบ โดยจะพยายามตามลำดับต่อไปนี้

1. เรียกใช้ OnCustomClickListener จาก AdLoader หากระบุไว้
2. สำหรับ URL แบบ Deep Link แต่ละรายการของโฆษณาแต่ละรายการ ให้พยายามค้นหาตัวแปลค่าเนื้อหา แล้วเริ่มรีโซลเวอร์รายการแรกที่แก้ปัญหาได้
3. เปิดเบราว์เซอร์และไปที่ URL ปลายทางแบบเดิมของโฆษณา

เมธอด forCustomFormatAd ยอมรับ OnCustomClickListener หากคุณส่งออบเจ็กต์ Listener เข้ามา SDK จะเรียกใช้เมธอด onCustomClick แทนและไม่ดําเนินการใดๆ เพิ่มเติม อย่างไรก็ตาม หากส่งค่า Null มาเป็นผู้ฟัง SDK จะกลับไปที่ URL Deep Link และ/หรือ URL ปลายทางที่ลงทะเบียนกับโฆษณา

Listener การคลิกที่กำหนดเองอนุญาตให้แอปเลือกการดำเนินการที่ดีที่สุดเพื่อตอบสนองต่อการคลิก ไม่ว่าจะเป็นการอัปเดต UI, การเปิดตัวกิจกรรมใหม่ หรือแค่การบันทึกการคลิก ตัวอย่างที่บันทึกข้อมูลว่ามีการคลิกเกิดขึ้นมีดังนี้

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
        // Display the ad.
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
            Log.i("MyApp", "A custom click just happened for " + assetName + "!");
          }
      }).build();

Kotlin

val adLoader = AdLoader.Builder(this, "/6499/example/native")
    .forCustomFormatAd("10063170",
        { ad ->
            // Display the ad.
        },
        { ad, assetName ->
                Log.i("MyApp", "A custom click just happened for $assetName!")
    }).build()

ตอนแรกอาจฟังดูแปลกๆ ที่มี Listener การคลิกที่กำหนดเองอยู่ จริงๆ แล้ว แอปของคุณเพิ่งบอก SDK ว่าเกิดการคลิก แล้วเหตุใด SDK จึงควรดำเนินการ และรายงานเรื่องนี้ให้แอปทราบ

การรับส่งข้อมูลแบบนี้มีประโยชน์ด้วยเหตุผล 2-3 ประการ แต่ที่สำคัญที่สุดคือช่วยให้ SDK ยังคงควบคุมการตอบสนองต่อการคลิกได้ เช่น ใช้คำสั่ง ping กับ URL ติดตามของบุคคลที่สามที่ตั้งค่าไว้สำหรับครีเอทีฟโฆษณาโดยอัตโนมัติ และจัดการงานอื่นๆ เบื้องหลังได้โดยไม่ต้องใช้โค้ดเพิ่มเติม