Reklam şeffaflığı URL'sini yapılandırma

Reklam şeffaflığı URL'si, belirli reklamlarda gösterilen AdChoices simgesini özelleştirmenize olanak tanır. Bu simge, varsayılan olarak kullanıcılarınıza reklamveren ve reklamın kendisi gibi bilgileri içeren, Google tarafından oluşturulan bir Reklam Şeffaflığı ve Kontrolü (AT&C) deneyimi aracılığıyla gösterilir.

Google Mobile Ads SDK'sına reklam isteğinde bulunarak reklam şeffaflığı URL'sini alabilir ve reklam şeffaflığı URL'si içeren bir yanıt alabilirsiniz. Uygulamanızda URL'yi aldıktan sonra, reklamlarınızın tasarımına uygun ve kullanıcılarınıza kendi AT&C deneyiminizi sunabilecek kişiselleştirilmiş bir simge entegre edebilirsiniz.

Bu sayfada, reklam şeffaflığı URL'sinin nasıl isteneceği, ayrıştırılacağı ve doğrulanacağı açıklanmaktadır.

Ön koşullar

Devam etmeden önce aşağıdakileri tamamladığınızdan emin olun:

  • Uygulamanızda yerel reklamlar ayarlayın. Yerel reklamlarla ilgili ayrıntılı bilgi için Yerel reklamlar başlıklı makaleyi inceleyin.
  • Bu özelliğe izin verilenler listesi erişimi isteyin. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.
    • Erişiminiz yoksa yanıtlarınızda reklam şeffaflığı URL'si döndürülmez ve varsayılan simge beklendiği gibi oluşturulur.

URL'yi isteyin

GMA Next-Gen SDK'nın reklam şeffaflığı URL'sini döndürmesi için doğal reklam isteklerinize ek bir istek parametresi eklersiniz. Bu parametre, uygulamanızın kişiselleştirilmiş bir simgeyi işlemeye hazır olduğunu belirtir.

İsteğinizde, ağ ekstraları paketinize "ad_transparency_url_requested" anahtarını "1" değeriyle birlikte eklemeniz gerekir. Ağ ekstralarıyla ilgili ayrıntılı bilgi için setGoogleExtrasBundle başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, reklam şeffaflığı URL'si istenmesi için bu anahtar ve değer ayarlanır:

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

AD_UNIT_ID yerine reklam birimi kimliğinizi yazın. Örneğin, doğal reklamlar için ca-app-pub-3940256099942544/2247696110.

URL'yi ayrıştırma

URL'yi istedikten sonra, yanıt bilgileri nesnesinde reklam şeffaflığı URL'si bulunan bir reklam yanıtı alırsınız. Yanıt bilgisi nesnesiyle ilgili ayrıntılar için Yanıt bilgileri başlıklı makaleyi inceleyin.

Reklam şeffaflığı URL'sine, yanıt ekstralarındaki "ad_transparency_url" anahtarından erişebilirsiniz. Aşağıdaki örnek, yanıt bilgileri nesnesindeki reklam şeffaflığı URL'sini alır:

Java 

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

Kotlin 

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

URL'yi doğrulama

Reklam şeffaflığı URL'sini test edip doğrulamak için yerel reklamınızda Google tarafından sağlanan varsayılan simge yerine kişiselleştirilmiş simgenizi gördüğünüzü doğrulayın. AT&C deneyimini görüntülemek için simgeyi tıklayın.

Ayrıca, yanıt bilgileriniz nesnesindeki yanıt ekstralarından reklam şeffaflığı URL'sini gördüğünüzü doğrulayın. Reklam şeffaflığı URL'sini görmüyorsanız kişiselleştirilmiş simgenizin yerine varsayılan Google simgesi oluşturulur. Aşağıda örnek bir reklam şeffaflık URL'si verilmiştir:

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