Format iklan native kustom jenis Display dan Pengukuran Terbuka

Panduan ini menjelaskan cara mengintegrasikan format iklan native kustom dengan open measurement.

Prasyarat

Sebelum melanjutkan, lakukan hal berikut:

Integrasi

Jika Anda berencana menggunakan open measurement dengan format iklan native kustom yang tidak berisi aset video, Anda 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 visibilitas aset video atas nama Anda.

Memuat iklan

Memuat iklan sama saja, baik Anda menggunakan open measurement 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());
}

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

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

Mendaftarkan tampilan dan mulai mengukur

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

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

Berikut ini tampilannya:

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

Perhatikan bahwa Anda harus menampilkan iklan sebelum mendaftarkan tampilan. 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 Anda merilis aplikasi, Anda akan mulai menerima data pengukuran; namun, data Anda tidak akan disertifikasi hingga Anda menyelesaikan proses sertifikasi IAB.