Hedefleme

Platform seçin: Android iOS Unity Flutter Android (Eski)

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

Devam etmeden önce Google Mobile Ads SDK (Legacy)'ı kurun.

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, seçilen güncellemeleri yapın ve aşağıdaki gibi ayarlayın:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Tüm reklam isteklerinin istek yapılandırması değişikliklerini uyguladığından emin olmak için Initialize Google Mobile Ads SDK (Legacy) işleminden önce istek yapılandırmasını ayarlayın.

Yaş deneyini ayarlama

Google Mobile Ads SDK (Legacy), çocuklara ve gençlere ilişkin geçerli gizlilikle ilgili yönetmeliklere uygunluğunuzu yönetmenize yardımcı olmak için bir yaş değerlendirme ayarı sunar. Yaş değerlendirmesi ayarı, Google Mobile Ads SDK (Legacy)'nın çocuklar, gençler veya belirtilmemiş bir yaş için belirli reklam sunma korumalarını uygulayıp uygulamayacağını belirtmenize olanak tanır.

setAgeRestrictedTreatment() yöntemiyle RequestConfiguration.Builder API'si ile yaşa göre değerlendirme ayarlayabilirsiniz.

Aşağıdaki örnekte, reklam isteklerinin çocuk yaştakilere yönelik olarak değerlendirilmesi gerektiği belirtilmektedir:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Gençlere yönelik veya belirtilmemiş bir yaş değerlendirmesini belirtmek için CHILD ayarını aşağıdakilerle değiştirin:

• TEEN
• UNSPECIFIED

Bu ayar kullanılırken Google Mobile Ads SDK (Legacy), reklam isteklerine bir tfat parametresi ekler. Yasal ve düzenleyici yükümlülüklerinize göre kullanıcılarınız için uygun yaş işleme ayarlarını belirlemek üzere hukuk danışmanınıza başvurun. Daha fazla bilgi için Bir uygulamadan gelen reklam isteğini yaş sınırına tabi işlem olarak etiketleme başlıklı makaleyi inceleyin.

TFCD ve TFUA'dan yaş değerlendirmesine geçiş

Yaşa göre değerlendirme ayarı, desteği sonlandırılan .setTagForChildDirectedTreatment() (TFCD) ve .setTagForUnderAgeOfConsent() (TFUA) ayarlarının yerini almıştır.

Aşağıdaki tabloda TFCD ve TFUA ayarları ile bunların yaş değerlendirmesi karşılıkları gösterilmektedir:

TFCD

TFCD	Yaş deneyleri
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Değer atanmadı .setTagForChildDirectedTreatment()	AgeRestrictedTreatment.UNSPECIFIED
Eşdeğeri yok	AgeRestrictedTreatment.TEEN

TFUA

TFUA	Yaş deneyleri
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Değer atanmadı .setTagForUnderAgeOfConsent()	AgeRestrictedTreatment.UNSPECIFIED
Eşdeğeri yok	AgeRestrictedTreatment.TEEN

TFCD ve TFUA ile yaş değerlendirmesi etkileşimlerini anlama

Yaş değerlendirmesi ayarını ve TFCD veya TFUA ayarlarını belirlerseniz Google, koruma düzeyi en yüksek olan değerlendirme yöntemini uygular.

Not: Aileler İçin Tasarlandı Programı'ndaki uygulamalar (öncelikli olarak çocuklara yönelik uygulamalar) ve Family Link ile yönetilen Google Hesaplarında oturum açan kullanıcılar için tüm reklam isteklerinde tüm içerikler otomatik olarak çocuklara yönelik olarak değerlendirilir.

AdMob Uyumlulaştırması ile yaşa göre değerlendirmeyi iletme

Google Mobile Ads SDK (Legacy) kullanarak yaşa göre değerlendirmeyi ayarlarsanız, uyumlulaştırma bağdaştırıcıları, yaşa göre değerlendirme sinyalini uyumlulaştırılmış üçüncü taraf SDK'larına iletir.

Aşağıdaki tabloda, yaş kısıtlamalı değerlendirme sinyalinin uyumlulaştırılmış üçüncü taraf SDK'sına yönlendirilmesini destekleyen uyumlulaştırma bağdaştırıcı sürümleri listelenmiştir:

Aracılık bağdaştırıcısının adı	Desteklenen minimum sürüm
AppLovin	13.6.3.0
BidMachine	3.7.1.1
Bigo	5.9.0.1
Chartboost	9.12.1.1
DTExchange (Fyber)	8.4.5.1
i-mobile	2.3.2.4
InMobi	11.3.0.1
IronSource	9.4.3.0
Liftoff Monetize (Vungle)	7.7.4.2
LY (Line)	3.1.1.1
maio	2.0.9.0
Meta (Facebook)	6.21.0.4
Mintegral	17.1.61.1
Moloco	4.10.0.0
MyTarget	5.47.1.1
Pangle	8.1.0.3.1
PubMatic	5.1.2.2
Verve	3.9.0.0

Çocuklara yönelik olarak değerlendirilme

Uyarı: setTagForChildDirectedTreatment() yönteminin desteği sonlandırıldı. Bunun yerine, setAgeRestrictedTreatment() yöntemini ayarlayın.

Çocukların Çevrimiçi Gizliliğini Koruma Yasası (COPPA) kapsamında "çocuklara yönelik olarak etiketleme" adlı bir ayar bulunur. Bu etiketi ayarlayarak, bu bildirimin doğru olduğunu ve uygulama sahibi adına hareket etme yetkisine sahip olduğunuzu onaylıyorsunuz. Bu ayarın kötüye kullanımının Google Hesabınızın kapatılmasına neden olabileceğini anlıyorsunuz.

Bir uygulama geliştiricisi olarak, reklam isteği yaptığınızda 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ını şu yollarla uygulayabilirsiniz: setTagForChildDirectedTreatment():

• İçeriğinizin COPPA amaçları doğrultusunda ç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 ile ilgili olarak 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, içeriğinizin COPPA amaçları doğrultusunda ç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)
RequestConfigurationSnippets.kt

Java

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

Not: Aileler İçin Tasarlandı Programı'ndaki uygulamalar (öncelikli olarak çocuklara yönelik uygulamalar) ve Family Link ile yönetilen Google Hesaplarında oturum açan kullanıcılar için tüm reklam isteklerinde tüm içerikler otomatik olarak çocuklara yönelik olarak değerlendirilir.

Reşit olma yaşının altındaki kullanıcılar

Uyarı: setTagForUnderAgeOfConsent() yönteminin desteği sonlandırıldı. Bunun yerine, setAgeRestrictedTreatment() yöntemini

�

Reklam isteklerinizi, Avrupa Ekonomik Alanı'ndaki (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilecek şekilde 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ükleriniz olabilir. Avrupa Birliği yönergelerini inceleyin ve kendi yasal danışmanınıza başvurun. Google'ın araçları, kanunlara ve kurallara uygunluğu kolaylaştırmak için tasarlanmıştır ve herhangi bir yayıncının hukuki yükümlülüklerini azaltmaz. 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 olma yaşının altındaki kullanıcılar iç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. Ayrıca 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.

• Reklam isteğinin Avrupa Ekonomik Alanı'ndaki (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmesini istediğinizi belirtmek için setTagForUnderAgeOfConsent() işlevini TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE ile birlikte ç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 olmaması için setTagForUnderAgeOfConsent() işlevini TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE ile çağırın.

• Reklam isteğinin Avrupa Ekonomik Alanı'ndaki (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilip değerlendirilmeyeceğini belirtmediğinizi belirtmek için setTagForUnderAgeOfConsent() işlevini TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED ile birlikte ç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)
RequestConfigurationSnippets.kt

Java

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

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

Reklam içeriğini filtreleme

Google Play'in Uygunsuz Reklam Politikası'na (reklamdaki ilişkili teklifler dahil) uymak için, içerik kendi başına 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 belirleyebilirsiniz.

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 değerinden 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)
RequestConfigurationSnippets.kt

Java

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

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

• Her reklam isteği için maksimum içerik derecelendirmesi ayarlama

• Uygulama veya hesap için maksimum reklam içeriği derecelendirmesi belirleme

Not: Google Mobile Ads SDK (Legacy) aracılığıyla belirtilen içerik derecelendirme filtresi ayarları, AdMob kullanıcı arayüzü kullanılarak yapılandırılan tüm ayarları geçersiz kılar.

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ştirmenin devre dışı bırakılıp bırakılmayacağını belirtmesine olanak tanıyan isteğe bağlı bir araçtır. Bu özellik kullanılırken oturumun geri kalanında gönderilen tüm reklam isteklerine bir yayıncı gizlilik ayarı (PPT) parametresi eklenir.

Varsayılan olarak, Google'a gönderilen 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(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

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

Not: Birden fazla kullanıcı gizliliği sinyali içeren reklam isteklerinde en kısıtlayıcı sinyal öncelikli olur. Belirli örnekler için Publisher Privacy Treatment API belgelerine bakın.

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 bottom adlı ek bir parametre anahtarı ayarlar:

Kotlin

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

Java

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