Format iklan native kustom jenis Display dan Pengukuran Terbuka

Panduan ini menjelaskan cara mengintegrasikan format iklan native kustom dengan pengukuran terbuka.

Prasyarat

Sebelum melanjutkan, lakukan hal berikut:

Integrasi

Jika Anda berencana menggunakan pengukuran terbuka dengan format iklan native kustom yang tidak berisi aset video, Anda akan bertanggung jawab untuk memanggil Open Measurement API sendiri.

Jika Anda menggunakan format iklan native kustom dengan aset video, Anda tidak perlu mengikuti panduan ini; Mobile Ads SDK melacak keaktifan aset video atas nama Anda.

Memuat iklan

Pemuatan iklan sama saja, baik Anda menggunakan pengukuran terbuka atau tidak. Berikut adalah metode yang menunjukkan cara meminta iklan native kustom:

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());
}

CustomNativeOMIDSnippets.java

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())
}

CustomNativeOMIDSnippets.kt

Ganti AD_UNIT_ID dan CUSTOM_TEMPLATE_ID dengan ID unit iklan dan ID template kustom Anda.

Mendaftarkan tampilan dan mulai mengukur

Untuk mengaktifkan pengukuran terbuka pada iklan native kustom, tampilkan iklan terlebih dahulu, lalu daftarkan tampilan iklan kustom Anda dengan objek DisplayOpenMeasurement yang terkait dengan iklan native kustom. Objek DisplayOpenMeasurement menyediakan metode setView() untuk mendaftarkan tampilan penampung Anda dengan pengukuran terbuka.

Anda juga harus secara eksplisit memberi tahu SDK untuk mulai mengukur iklan Anda. Untuk melakukannya, panggil metode start() pada objek DisplayOpenMeasurement dari iklan native kustom Anda. Metode start() harus dipanggil dari thread utama, dan panggilan berikutnya tidak berpengaruh.

Berikut ini tampilannya:

Java

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

Kotlin

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

CustomNativeOMIDSnippets.kt

Perhatikan bahwa Anda harus menampilkan iklan sebelum mendaftarkan penayangan. Menampilkan iklan Anda dibahas dalam Format Iklan Native Kustom.

Tata letak customTemplateAdFrame adalah penampung iklan untuk iklan native kustom dan harus berisi semua aset dalam kotak pembatas tampilan.

Mendapatkan sertifikasi dari IAB

Setelah merilis aplikasi, Anda akan mulai menerima data pengukuran; namun, data Anda tidak akan disertifikasi hingga Anda menyelesaikan proses sertifikasi IAB.