Hedefleme

Platform seçin: Android iOS Unity Flutter

Bu kılavuzda, Google Mobile Ads SDK'sına hedefleme bilgilerinin nasıl sağlanacağı açıklanmaktadır.

Çalışan bir örnek için Android API Demo uygulamasını indirin.

API demosunu indirin

Ön koşul

RequestConfiguration

RequestConfiguration her reklam isteğine genel olarak uygulanan hedefleme bilgilerini toplar. Kullanılabilir hedefleme etiketleri için RequestConfiguration.Builder belgelerine bakın.

İstek yapılandırmasını güncellemek için mevcut yapılandırmadan bir oluşturucu alın, istediğiniz güncellemeleri yapın ve aşağıdaki gibi ayarlayın:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Tüm reklam isteklerinin istek yapılandırması değişikliklerini uyguladığından emin olmak için Google Mobile Ads SDK'sını başlatmadan önce istek yapılandırmasını ayarlayın.

Çocuklara yönelik ayar

Çocukların Çevrimiçi Gizliliğini Koruma Yasası (COPPA) kapsamında "çocuklara yönelik olarak değerlendirme için etiketleme" adlı bir ayar bulunur. Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulama sahibi adına işlem yapmaya yetkili olduğunuzu onaylarsınız. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesine yol açabileceğini anlıyorsunuz.

Uygulama geliştiricisi olarak, reklam isteğinde bulunduğunuzda Google'ın içeriğinizi çocuklara yönelik olarak değerlendirmesini isteyip istemediğinizi belirtebilirsiniz. Google'ın içeriğinizi çocuklara yönelik olarak değerlendirmesini istediğinizi belirtirseniz bu reklam isteğinde IBA ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli adımları atarız.

Çocuklara yönelik ayarı aşağıdaki yöntemlerle uygulayabilirsiniz: setTagForChildDirectedTreatment():

  • İçeriğinizin COPPA kapsamında çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtmek için setTagForChildDirectedTreatment ile TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE işlevini çağırın. Bu, Android reklam kimliğinin (AAID) iletilmesini engeller.

  • İçeriğinizin COPPA kapsamında çocuklara yönelik olarak değerlendirilmesini istemediğinizi belirtmek için setTagForChildDirectedTreatment ile TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE işlevini çağırın.

  • Reklam isteklerinde içeriğinizin COPPA kapsamında nasıl değerlendirilmesini istediğinizi belirtmek istemiyorsanız setTagForChildDirectedTreatment ile TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED çağrısı yapın.

Aşağıdaki örnek, COPPA kapsamında içeriğinizin çocuklara yönelik olarak değerlendirilmesini istediğinizi gösterir:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Reklam isteklerinizi, Avrupa Ekonomik Alanı'nda (AEA) bulunan, reşit olmayan kullanıcılara yönelik olarak değerlendirilmesi için işaretleyebilirsiniz. Bu özellik, Genel Veri Koruma Yönetmeliği'ne (GDPR) uygunluğu kolaylaştırmak için tasarlanmıştır. GDPR kapsamında başka yasal yükümlülüklerinizin de olabileceğini unutmayın. Avrupa Birliği yönergelerini inceleyin ve kendi yasal danışmanınıza başvurun. Google'ın araçlarının, uyumluluğu kolaylaştırmak için tasarlandığını ve yayıncının hukuki yükümlülüklerini azaltmadığını lütfen unutmayın. GDPR'nin yayıncıları nasıl etkilediği hakkında daha fazla bilgi edinin.

Bu özellik kullanılırken reklam isteğine Avrupa'da Reşit Olmayan Kullanıcılar İçin Etiket (TFUA) parametresi eklenir. Bu parametre, yeniden pazarlama dahil olmak üzere tüm reklam istekleri için kişiselleştirilmiş reklamcılığı devre dışı bırakır. Reklam ölçüm pikselleri ve üçüncü taraf reklam sunucuları gibi üçüncü taraf reklam sağlayıcılarına gönderilen istekleri de devre dışı bırakır.

Çocuklara yönelik ayarlar gibi, RequestConfiguration.Builder içinde TFUA parametresini ayarlamak için bir yöntem vardır: setTagForUnderAgeOfConsent(), aşağıdaki seçeneklerle birlikte.

  • Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) bulunan ve reşit olmayan kullanıcılara yönelik olarak değerlendirilmesini istediğinizi belirtmek için setTagForUnderAgeOfConsent() işlevini TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE ile çağırın. Bu, Android reklam kimliğinin (AAID) iletilmesini de engeller.

  • Reklam isteğinin Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmemesini istediğinizi belirtmek için TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE ile setTagForUnderAgeOfConsent() işlevini çağırın.

  • Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilip değerlendirilmeyeceğini belirtmediğinizi ifade etmek için setTagForUnderAgeOfConsent() ile TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED işlevini çağırın.

Aşağıdaki örnek, reklam isteklerinize TFUA'nın dahil edilmesini istediğinizi gösterir:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Çocuklara yönelik olarak değerlendirme ayarını ve setTagForUnderAgeOfConsent() etiketlerini etkinleştiren etiketler aynı anda true olarak ayarlanmamalıdır. Bu şekilde ayarlanırlarsa çocuklara yönelik olma ayarı öncelikli olur.

Reklam içeriğini filtreleme

Google Play'in Uygunsuz Reklam Politikası'na (bir reklamdaki ilişkili teklifler dahil) uymak için, içeriğin kendisi Google Play'in politikalarına uygun olsa bile uygulamanızda gösterilen tüm reklamlar ve bunlarla ilişkili teklifler, uygulamanızın içerik derecelendirmesine uygun olmalıdır.

Maksimum reklam içeriği derecelendirmesi gibi araçlar, kullanıcılarınıza gösterilen reklamların içerikleri üzerinde daha fazla kontrole sahip olmanıza yardımcı olabilir. Platform politikalarına uygunluğu sağlamak için maksimum içerik derecelendirmesi ayarlayabilirsiniz.

Uygulamalar, reklam istekleri için maksimum reklam içeriği derecelendirmesini setMaxAdContentRating yöntemini kullanarak ayarlayabilir. Bu ayar yapılandırıldığında döndürülen AdMob reklamlarının içerik derecelendirmesi bu düzeyde veya daha düşüktür. Bu ağ ekstrası için olası değerler dijital içerik etiketi sınıflandırmalarına dayanır ve aşağıdaki dizelerden biri olmalıdır:

  • MAX_AD_CONTENT_RATING_G
  • MAX_AD_CONTENT_RATING_PG
  • MAX_AD_CONTENT_RATING_T
  • MAX_AD_CONTENT_RATING_MA

Aşağıdaki kod, döndürülen reklam içeriğinin G'den yüksek olmayan bir dijital içerik etiketi atamasına karşılık gelmesi gerektiğini belirtmek için bir RequestConfiguration nesnesi yapılandırır:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Aşağıdaki konular hakkında daha fazla bilgi edinin:

Yayıncı Gizlilik Değerlendirmesi (Beta)

Publisher Privacy Treatment (PPT) API, uygulamaların setPublisherPrivacyPersonalizationState() yöntemini kullanarak tüm reklam istekleri için reklam kişiselleştirmeyi devre dışı bırakıp bırakmayacağını belirtmesine olanak tanıyan isteğe bağlı bir araçtır. Bu özellik kullanılırken oturumun geri kalanı için gelecekteki tüm reklam isteklerine bir yayıncı gizlilik işleme (PPT) parametresi eklenir.

Varsayılan olarak, Google'a yapılan reklam istekleri sonucunda kişiselleştirilmiş reklamlar yayınlanır. Aşağıdaki kod, tüm reklam istekleri için reklam kişiselleştirmeyi devre dışı bırakır:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Reklam isteği

AdRequest nesnesi, reklam isteğiyle gönderilecek hedefleme bilgilerini toplar.

Ağ ekstraları ekleme

Ağ ekstraları, bir reklam isteğiyle gönderilen ve tek bir reklam kaynağına özgü ek ayrıntılardır.

Aşağıdaki kod snippet'i, Google'a collapsible değerine sahip ekstra bir parametre anahtarı bottom ayarlar:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()
adLoader.loadAd(adRequest)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();
adLoader.loadAd(adRequest);