Menyegmentasikan data iklan dengan penempatan

Pilih platform: Android (beta) Baru dipilih Android iOS

Untuk menyegmentasikan data pelaporan performa iklan, gunakan fitur penempatan iklan. Penempatan memungkinkan Anda menyegmentasikan data tayangan iklan dalam laporan tanpa memerlukan unit iklan tambahan. Untuk menggunakan fitur penempatan, Anda memerlukan ID penempatan. Untuk mengetahui detail penempatan, lihat Tentang penempatan.

Panduan ini membahas cara menyetel ID penempatan di GMA Next-Gen SDK dan melihat laporan performa iklan.

Prasyarat

Sebelum Anda melanjutkan, lakukan hal berikut:

  • Selesaikan Siapkan GMA Next-Gen SDK.
  • Memiliki GMA Next-Gen SDK versi atau yang lebih baru.
  • Mendapatkan akses ke fitur ID penempatan. Untuk meminta akses, hubungi account manager Anda.
  • Buat ID penempatan untuk aplikasi Anda.

Menetapkan ID penempatan

Untuk menyegmentasikan data performa iklan, Anda menetapkan ID penempatan dengan salah satu cara berikut:

  • Saat memuat iklan.
  • Sebelum menampilkan iklan.

Anda dapat memperbarui ID penempatan sesuai kebutuhan. Saat GMA Next-Gen SDK mencatat tayangan iklan, GMA Next-Gen SDK menggunakan ID penempatan set terbaru.

Menetapkan ID penempatan saat waktu pemuatan

Bagian ini membahas cara menetapkan ID penempatan pada waktu pemuatan. Alur kerja ini berlaku untuk semua format iklan.

Contoh berikut menetapkan ID penempatan untuk iklan interstisial pada waktu pemuatan:

Kotlin 

private fun loadInterstitial() {
  val adRequest = AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    adRequest,
    object : AdLoadCallback<InterstitialAd> {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

AdPlacementsSnippets.kt

Java 

private void loadInterstitial() {
  AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      adRequest,
      new AdLoadCallback<>() {
        @Override
        public void onAdLoaded(InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

AdPlacementsSnippets.java

Ganti nilai berikut:

  • AD_UNIT_ID dengan ID unit iklan Anda.
  • PLACEMENT_ID dengan ID penempatan Anda.

Menetapkan ID penempatan pada waktu penayangan

Bagian ini membahas cara menyetel ID penempatan pada waktu penayangan untuk semua format iklan. Pilih format iklan pilihan Anda dari bagian berikut:

Untuk iklan banner, Anda menetapkan ID penempatan sebelum menempatkan tampilan iklan dalam hierarki tampilan. Contoh berikut menetapkan ID penempatan untuk iklan banner pada waktu penayangan:

Kotlin 

private fun showBannerView(ad: BannerAd, parentView: ViewGroup, activity: Activity) {
  ad.placementId = PLACEMENT_ID
  parentView.addView(ad.getView(activity))
}

AdPlacementsSnippets.kt

Java 

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}

AdPlacementsSnippets.java

Iklan layar penuh

Untuk format iklan layar penuh, Anda menetapkan ID penempatan sebelum menampilkan iklan. Alur kerja ini berlaku untuk format berikut:

Contoh berikut menetapkan ID penempatan untuk iklan interstisial pada waktu tampilan:

Kotlin 

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}

AdPlacementsSnippets.kt

Java 

private void showAd(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}

AdPlacementsSnippets.java

Iklan native

Untuk iklan native, Anda menetapkan ID penempatan setelah memuat iklan native dan sebelum mendaftarkan iklan ke tampilan iklan.

Contoh berikut menetapkan ID penempatan untuk iklan native pada waktu penayangan:

Kotlin 

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd, mediaView: MediaView) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.registerNativeAd(nativeAd, mediaView)
}

AdPlacementsSnippets.kt

Java 

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd, MediaView mediaView) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.registerNativeAd(nativeAd, mediaView);
}

AdPlacementsSnippets.java

Melihat laporan penempatan

Setelah menetapkan ID penempatan, Anda akan melihat laporan dimensi ID penempatan di UI AdMob. Untuk melihat laporan, ikuti langkah-langkah di artikel Melihat penempatan Anda.