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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ทำดังนี้

การผสานรวม

หากคุณวางแผนที่จะใช้การวัดผลแบบเปิดกับรูปแบบโฆษณาเนทีฟที่กำหนดเองซึ่งไม่มีชิ้นงานวิดีโอ คุณจะต้องเป็นผู้เรียกใช้ Open Measurement API ด้วยตนเอง

หากคุณใช้รูปแบบโฆษณาเนทีฟที่กำหนดเองที่มีชิ้นงานวิดีโอ คุณไม่จำเป็นต้องทำตามคู่มือนี้ เนื่องจาก Mobile Ads SDK จะติดตามการมองเห็นโฆษณาของชิ้นงานวิดีโอในนามของคุณ

โหลดโฆษณา

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

Java

private void loadCustomNativeAd(Context context, ViewGroup nativeCustomFormatAdContainer) {

  AdLoader adLoader =
      new AdLoader.Builder(context, "AD_UNIT_ID")
          .forCustomFormatAd(
              "CUSTOM_TEMPLATE_ID",
              new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
                @Override
                public void onCustomFormatAdLoaded(@NonNull NativeCustomFormatAd ad) {
                  // Show the ad first and then register your view and begin open measurement.
                  // Make sure to do this on the main thread.

                  // ...
                  // Show ad
                  // ...

                  startOpenMeasurement(ad, nativeCustomFormatAdContainer);
                }
              },
              new NativeCustomFormatAd.OnCustomClickListener() {
                @Override
                public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
                  // Handle the click action
                }
              })
          .build();
  adLoader.loadAd(new AdRequest.Builder().build());
}

Kotlin

private fun loadCustomNativeAd(context: Context, nativeCustomFormatAdContainer: ViewGroup) {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forCustomFormatAd(
        "CUSTOM_TEMPLATE_ID",
        NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->
          // Show the ad first and then register your view and begin open measurement. Make sure
          // to do this on the main thread.

          // ...
          // Show ad
          // ...

          startOpenMeasurement(ad, nativeCustomFormatAdContainer)
        },
        NativeCustomFormatAd.OnCustomClickListener { ad, assetName ->
          // Handle the click action.
        },
      )
      .build()

  adLoader.loadAd(AdRequest.Builder().build())
}

แทนที่ AD_UNIT_ID และ CUSTOM_TEMPLATE_ID ด้วยรหัสหน่วยโฆษณาและรหัสเทมเพลตที่กำหนดเอง

ลงทะเบียนการแสดงผลและเริ่มวัดผล

หากต้องการเปิดใช้การวัดผลแบบเปิดในโฆษณาเนทีฟที่กำหนดเอง ให้แสดงโฆษณาก่อน แล้วลงทะเบียนการแสดงผลโฆษณาที่กำหนดเองด้วยออบเจ็กต์ DisplayOpenMeasurement ที่เชื่อมโยงกับโฆษณาเนทีฟที่กำหนดเอง ออบเจ็กต์ DisplayOpenMeasurement มีเมธอด setView() สำหรับลงทะเบียนการแสดงผลคอนเทนเนอร์กับการวัดผลแบบเปิด

นอกจากนี้ คุณยังต้องบอกให้ SDK เริ่มวัดผลโฆษณาอย่างชัดแจ้งด้วย โดยเรียกใช้เมธอด start() ในออบเจ็กต์ DisplayOpenMeasurement ของโฆษณาเนทีฟที่กำหนดเอง คุณต้องเรียกใช้เมธอด start() จากเธรดหลัก และการเรียกใช้ครั้งต่อๆ ไปจะไม่มีผล

นี่คือลักษณะของแท็บ

Java

private void startOpenMeasurement(
    NativeCustomFormatAd ad, ViewGroup nativeCustomFormatAdContainer) {
  DisplayOpenMeasurement displayOpenMeasurement = ad.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer);
    displayOpenMeasurement.start();
  }
}

Kotlin

private fun startOpenMeasurement(
  ad: NativeCustomFormatAd,
  nativeCustomFormatAdContainer: ViewGroup,
) {
  ad.getDisplayOpenMeasurement()?.let { displayOpenMeasurement ->
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer)
    displayOpenMeasurement.start()
  }
}

โปรดทราบว่าคุณควรแสดงโฆษณาก่อนลงทะเบียนการแสดงผล เราได้อธิบายวิธีแสดงโ101}ฆษณาไว้ใน รูปแบบโฆษณาเนทีฟที่กำหนดเอง101}Formats

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

รับการรับรองกับ IAB

เมื่อเผยแพร่แอปแล้ว คุณจะเริ่มได้รับข้อมูลการวัดผล แต่ ข้อมูลจะไม่ได้รับการรับรองจนกว่าคุณจะดำเนินการตาม กระบวนการรับรองของ IAB เสร็จสมบูรณ์