Sampaikan masukan Anda tentang GMA Next-Gen SDK di saluran Discord #gma-next-gen-sdk di server Komunitas Google Advertising and Measurement.

Menerapkan iklan ikon

Iklan ikon adalah penempatan ikon aplikasi kecil yang melengkapi pengalaman pengguna sistem operasi dan fleksibel untuk menyertai sebagian besar aktivitas tingkat OS, seperti layar kunci dan layar berbagi. Anda dapat menampilkan iklan ikon satu per satu, atau dalam beberapa grup. Setiap iklan menyediakan serangkaian elemen teks dan string yang harus dirender oleh aplikasi Anda. Gambar berikut menampilkan iklan ikon yang ditampilkan di folder aplikasi:

Panduan ini menunjukkan cara meminta dan menampilkan iklan ikon.

Prasyarat

Sebelum memulai, Anda harus memiliki GMA Next-Gen SDK 0.8.0-alpha01 atau yang lebih tinggi.

Selalu melakukan pengujian dengan iklan percobaan

Saat membangun dan menguji aplikasi, pastikan Anda menggunakan iklan percobaan, bukan iklan produksi langsung. Jika Anda tidak menggunakan iklan percobaan, akun Anda dapat ditangguhkan.

Gunakan unit iklan Anda dan aktifkan perangkat pengujian untuk mendapatkan iklan percobaan, atau ID unit iklan percobaan khusus berikut untuk iklan ikon Android:

ca-app-pub-3940256099942544/1476272466

Untuk mengetahui detail tentang iklan percobaan GMA Next-Gen SDK, lihat bagian Mengaktifkan iklan percobaan.

Memuat iklan ikon

Muat iklan ikon dengan permintaan iklan ikon Anda, dan tangani peristiwa pemuatan iklan:

Kotlin

private fun loadIconAd() {
  val request =
    IconAdRequest.Builder(AD_UNIT_ID)
      // The "AdChoices" badge is rendered at the top right corner of the icon ad
      // if left unspecified.
      .setAdChoicesPlacement(AdChoicesPlacement.BOTTOM_RIGHT)
      // It is recommended to specify the placement of your icon ad
      // to help Google optimize your icon ad performance.
      .setIconAdPlacement(IconAdPlacement.BROWSER)
      .build()

  IconAd.load(
    request,
    object : AdLoadCallback<IconAd> {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.w(Constant.TAG, "Icon ad failed to load: $adError")
        showToast("Icon ad failed to load.")
      }

      override fun onAdLoaded(ad: IconAd) {
        Log.d(Constant.TAG, "Icon ad loaded")
        // Always call destroy() on ads on removal.
        iconAd?.destroy()
        iconAd = ad
        setAdEventCallback(ad)
        displayIconAd(ad)
      }
    },
  )
}
IconAdFragment.kt

Java

private void loadIconAd() {
  IconAdRequest request =
      new IconAdRequest.Builder(AD_UNIT_ID)
          // The "AdChoices" badge is rendered at the top right corner of the icon ad
          // if left unspecified.
          .setAdChoicesPlacement(AdChoicesPlacement.BOTTOM_RIGHT)
          // It is recommended to specify the placement of your icon ad
          // to help Google optimize your icon ad performance.
          .setIconAdPlacement(IconAdPlacement.BROWSER)
          .build();

  IconAd.load(
      request,
      new AdLoadCallback<IconAd>() {
        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.w(Constant.TAG, "Icon ad failed to load :" + adError);
          showToast("Icon ad failed to load with error code: " + adError.getCode());
        }

        @Override
        public void onAdLoaded(@NonNull IconAd ad) {
          Log.d(Constant.TAG, "Icon ad loaded.");

          // Always call destroy() on ads on removal.
          if (iconAd != null) {
              iconAd.destroy();
          }
          iconAd = ad;
          setAdEventCallback(ad);
          displayIconAd(ad);
        }
      });
}
IconAdFragment.java

Membuat tampilan iklan ikon

Iklan ikon harus menggunakan IconAdView sebagai elemen root untuk asetnya. Dalam tampilan iklan ikon, tempatkan semua elemen visual untuk iklan Anda.

Contoh berikut menunjukkan tata letak untuk membuat tampilan iklan ikon:

<?xml version="1.0" encoding="utf-8"?>
<com.google.android.libraries.ads.mobile.sdk.iconad.IconAdView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

  <LinearLayout
      android:id="@+id/icon_ad_container"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_gravity="center"
      android:background="#00FFC107"
      android:orientation="vertical">

    <LinearLayout
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="horizontal">
      <TextView
          android:id="@+id/ad_badge"
          android:width="15dp"
          android:height="15dp"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:background="#FFC107"
          android:text="Ad"
          android:textColor="#FFFFFF"
          android:textSize="12sp" />
      <TextView
          android:id="@+id/ad_headline"
          android:textStyle="normal"
          android:layout_width="match_parent"
          android:layout_height="wrap_content"
          android:layout_gravity="center"
          android:autoText="true"
          android:inputType="text|textMultiLine"
          android:textColor="#808080"
          android:textSize="12sp" />
    </LinearLayout>

    <com.google.android.material.imageview.ShapeableImageView xmlns:app="http://schemas.android.com/apk/res-auto"
        android:id="@+id/ad_icon"
        android:layout_width="100dp"
        android:layout_height="100dp"
        android:layout_gravity="center"
        android:adjustViewBounds="true"
        android:background="@android:color/holo_green_light"
        android:contentDescription="@string/content_description_icon_ad"
        android:theme="@style/Theme.AppCompat.Light"
        app:shapeAppearanceOverlay="@style/roundedCorners"
        app:strokeColor="@null" />

    <RatingBar
        android:id="@+id/ad_stars"
        style="?android:attr/ratingBarStyleSmall"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:isIndicator="true"
        android:numStars="5"
        android:stepSize="0.5" />
    <Button
        android:id="@+id/ad_call_to_action"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:gravity="center"
        android:textSize="12sp" />
  </LinearLayout>

</com.google.android.libraries.ads.mobile.sdk.iconad.IconAdView>

Menampilkan iklan ikon di layar

Untuk menampilkan iklan ikon di layar, selesaikan langkah-langkah berikut:

Kembangkan tampilan iklan ikon dan tambahkan ke hierarki tampilan Anda.
Isi setiap tampilan turunan dengan aset iklan ikon yang sesuai.

Contoh berikut mencakup langkah-langkah sebelumnya untuk menampilkan iklan ikon di layar:

Kotlin

val iconAdViewBinding = IconAdBinding.inflate(layoutInflater)
// Add the ad view to the active view hierarchy.
binding.iconAdContainer.addView(iconAdViewBinding.root)
val iconAdView = iconAdViewBinding.root

// Populate the view elements with their respective icon ad asset.
iconAdView.callToActionView = iconAdViewBinding.adCallToAction
iconAdView.headlineView = iconAdViewBinding.adHeadline
iconAdView.iconView = iconAdViewBinding.adIcon
iconAdView.starRatingView = iconAdViewBinding.adStarsIconAdFragment.kt

Java

IconAdBinding iconAdViewBinding = IconAdBinding.inflate(getLayoutInflater());
// Add the ad view to the active view hierarchy.
binding.iconAdContainer.addView(iconAdViewBinding.getRoot());
IconAdView iconAdView = iconAdViewBinding.getRoot();

// Populate the view elements with their respective icon ad asset.
iconAdView.setCallToActionView(iconAdViewBinding.adCallToAction);
iconAdView.setHeadlineView(iconAdViewBinding.adHeadline);
iconAdView.setIconView(iconAdViewBinding.adIcon);
iconAdView.setStarRatingView(iconAdViewBinding.adStars);IconAdFragment.java

Membuat iklan ikon dapat diklik

GMA Next-Gen SDK mendaftarkan pemroses klik untuk setiap tampilan aset yang dipetakan saat registerIconAd() dipanggil. Petakan properti tampilan iklan ikon ke tampilan yang sesuai dalam hierarki tampilan Anda sebelum mendaftarkan iklan ikon:

Kotlin

// Map each asset view property to the corresponding view in your view hierarchy.
iconAdViewBinding.adCallToAction.text = iconAd.callToAction
iconAdViewBinding.adHeadline.text = iconAd.headline
iconAdViewBinding.adIcon.setImageDrawable(iconAd.icon.drawable)
iconAd.starRating?.toFloat().also { value ->
  if (value != null) {
    iconAdViewBinding.adStars.rating = value
  }
}

// Register the icon ad with the view presenting it.
iconAdView.registerIconAd(iconAd)IconAdFragment.kt

Java

// Map each asset view property to the corresponding view in your view hierarchy.
iconAdViewBinding.adCallToAction.setText(iconAd.getCallToAction());
iconAdViewBinding.adHeadline.setText(iconAd.getHeadline());
iconAdViewBinding.adIcon.setImageDrawable(iconAd.getIcon().getDrawable());

if (iconAd.getStarRating() != null) {
  iconAdViewBinding.adStars.setRating(iconAd.getStarRating().floatValue());
}

// Register the icon ad with the view presenting it.
iconAdView.registerIconAd(iconAd);IconAdFragment.java

Opsional: Tetapkan callback peristiwa iklan ikon

Untuk menangani peristiwa siklus proses iklan ikon, tetapkan callback peristiwa:

Kotlin

iconAd.adEventCallback =
  object : IconAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Icon ad showed full screen content.
    }

    override fun onAdDismissedFullScreenContent() {
      // Icon ad dismissed full screen content.
    }

    override fun onAdFailedToShowFullScreenContent(
      fullScreenContentError: FullScreenContentError
    ) {
      // Icon ad failed to show full screen content.
    }

    override fun onAdImpression() {
      // Icon ad recorded an impression.
    }

    override fun onAdClicked() {
      // Icon ad recorded a click.
    }

    override fun onAdPaid(value: AdValue) {
      // Icon ad estimated to have earned money.
    }
  }IconAdFragment.kt

Java

iconAd.setAdEventCallback(
    new IconAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Icon ad showed full screen content.
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Icon ad dismissed full screen content.
      }

      @Override
      public void onAdFailedToShowFullScreenContent(
          @NonNull FullScreenContentError fullScreenContentError) {
        // Icon ad failed to show full screen content.
      }

      @Override
      public void onAdImpression() {
        // Icon ad recorded an impression.
      }

      @Override
      public void onAdClicked() {
        // Icon ad recorded a click.
      }

      @Override
      public void onAdPaid(@NonNull AdValue value) {
        // Icon ad estimated to have earned money.
      }
    });IconAdFragment.java

Mengoptimalkan performa

Bagian berikut mencakup langkah-langkah penerapan opsional untuk mengoptimalkan performa iklan ikon.

Menggunakan korelatif untuk memuat beberapa iklan

Saat memuat beberapa iklan ikon untuk ditampilkan bersama, buat permintaan berurutan menggunakan nilai korelator yang sama untuk memastikan bahwa iklan yang dimuat unik. Masa aktif korelator adalah 10 detik. Server tidak menganggap permintaan yang dibuat dengan selisih lebih dari 10 detik sebagai berkorelasi.

Contoh berikut menunjukkan cara menyetel nilai korelasion pada permintaan iklan:

Kotlin

val correlator = Correlator.generateCorrelator()
val request =
      IconAdRequest.Builder("ca-app-pub-3940256099942544/1476272466")
        .setCorrelator(correlator)
        .build()

Java

Correlator correlator = Correlator.generateCorrelator();
IconAdRequest request =
    new IconAdRequest.Builder("ca-app-pub-3940256099942544/1476272466")
        .setCorrelator(correlator)
        .build();

Menetapkan penempatan iklan ikon

Untuk membantu Google memahami penempatan iklan ikon Anda guna mengoptimalkan performa iklan ikon, sebaiknya tentukan tempat Anda ingin menampilkan iklan ikon pada waktu permintaan.

Gunakan nilai enum IconAdPlacement yang paling sesuai dengan kasus penggunaan Anda:

Kotlin

val request =
  IconAdRequest.Builder("ca-app-pub-3940256099942544/1476272466")
    .setIconAdPlacement(IconAdPlacement.BROWSER)
    .build()

Java

IconAdRequest request =
    new IconAdRequest.Builder("ca-app-pub-3940256099942544/1476272466")
        .setIconAdPlacement(IconAdPlacement.BROWSER)
        .build();

Menerapkan iklan ikon Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Prasyarat

Selalu melakukan pengujian dengan iklan percobaan

Memuat iklan ikon

Kotlin

Java

Membuat tampilan iklan ikon

Menampilkan iklan ikon di layar

Kotlin

Java

Membuat iklan ikon dapat diklik

Kotlin

Java

Opsional: Tetapkan callback peristiwa iklan ikon

Kotlin

Java

Mengoptimalkan performa

Menggunakan korelatif untuk memuat beberapa iklan

Kotlin

Java

Menetapkan penempatan iklan ikon

Kotlin

Java

Menerapkan iklan ikon