Mengonfigurasi URL transparansi iklan

URL transparansi iklan memungkinkan Anda menyesuaikan ikon AdChoices yang ditampilkan di iklan tertentu. Secara default, ikon ini muncul kepada pengguna Anda melalui pengalaman Transparansi dan Kontrol Iklan (AT&C) yang dirender Google yang mencakup informasi, seperti pengiklan dan iklan itu sendiri.

Anda bisa mendapatkan URL transparansi iklan dengan membuat permintaan iklan ke Google Mobile Ads SDK, dan menerima respons dengan URL transparansi iklan. Setelah menerima URL dalam aplikasi, Anda dapat mengintegrasikan ikon yang dipersonalisasi yang dapat mematuhi desain iklan dan menyajikan pengalaman AT&C Anda sendiri kepada pengguna.

Halaman ini membahas cara meminta, mengurai, dan memvalidasi URL transparansi iklan.

Prasyarat

Sebelum melanjutkan, pastikan Anda menyelesaikan hal berikut:

  • Siapkan iklan native di aplikasi Anda. Untuk mengetahui detail tentang iklan native, lihat Iklan native.
  • Minta akses daftar yang diizinkan ke fitur ini. Untuk meminta akses, hubungi Account Manager Anda.
    • Jika Anda tidak memiliki akses, respons Anda tidak akan menampilkan URL transparansi iklan, dan ikon default akan dirender sesuai yang diinginkan.

Minta URL

Agar GMA Next-Gen SDK menampilkan URL transparansi iklan, Anda menambahkan parameter permintaan tambahan dalam permintaan iklan native. Parameter ini menandakan bahwa aplikasi Anda sudah siap dan dipersiapkan untuk menangani ikon yang dipersonalisasi.

Dalam permintaan, Anda harus menambahkan kunci "ad_transparency_url_requested" dengan nilai "1" ke paket ekstra jaringan. Untuk mengetahui detail tentang ekstra jaringan, lihat setGoogleExtrasBundle .

Contoh berikut menetapkan kunci dan nilai ini untuk meminta URL transparansi iklan:

Java 

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin 

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

Ganti AD_UNIT_ID dengan ID unit iklan Anda. Misalnya, ca-app-pub-3940256099942544/2247696110, untuk iklan native.

Mengurai URL

Setelah meminta URL, Anda akan menerima respons iklan dengan URL transparansi iklan di objek info respons. Untuk mengetahui detail objek info respons, lihat Info respons.

Anda dapat mengakses URL transparansi iklan dalam kunci "ad_transparency_url" dari ekstra respons. Contoh berikut mendapatkan URL transparansi iklan dalam objek info respons:

Java 

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin 

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

Validasi URL

Untuk menguji dan memvalidasi URL transparansi iklan, pastikan Anda tidak melihat ikon default yang disediakan Google di iklan native Anda, melainkan ikon yang dipersonalisasi. Klik ikon untuk melihat pengalaman AT&C.

Selain itu, verifikasi bahwa Anda melihat URL transparansi iklan dari ekstra respons di objek info respons Anda. Jika Anda tidak melihat URL transparansi iklan, ikon Google default akan dirender sebagai pengganti ikon yang dipersonalisasi. Berikut adalah contoh URL transparansi iklan:

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID