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 indirme

Ön koşul

Devam etmeden önce Google Mobile Ads SDK (Legacy) uygulamasını 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 Google Mobile Ads SDK (Legacy) ilk kullanıma hazırlamadan önce istek yapılandırmasını ayarlayın.

Yaş değerlendirmesini ayarlama

Google Mobile Ads SDK (Legacy), çocuklarla ve gençlerle ilgili gizlilik yönetmeliklerine uygunluğunuzu yönetmenize yardımcı olmak için yaşa uygun işlem ayarı sunar. Yaşa uygun içerik ayarı, Google Mobile Ads SDK (Legacy) platformunun çocuklar, gençler veya belirtilmemiş bir yaş için belirli reklam sunma korumaları uygulayıp uygulamayacağını belirtmenize olanak tanır.

RequestConfiguration.Builder API'sindeki setAgeRestrictedTreatment() yöntemiyle yaşa göre değerlendirme ayarını yapabilirsiniz.

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ş yaş değerlendirmesini belirtmek için CHILD ayarını aşağıdakiyle değiştirin:

• TEEN
• UNSPECIFIED

Bu ayar kullanıldığında 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 geçerli yaşa göre işleme ayarı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ş değerlendirmesi ayarı, kullanımdan kaldırılan .setTagForChildDirectedTreatment() (TFCD) ve .setTagForUnderAgeOfConsent() (TFUA) ayarlarının yerini alır.

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

TFCD

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

TFUA

TFUA	Yaş deneyi
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
Atanmış değer yok .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 Programı'nda Öncelikli olarak çocuklara yönelik uygulamalar olarak sınıflandırılan uygulamalarda ve Family Link ile yönetilen Google Hesaplarında oturum açmış kullanıcılarda, tüm içerikler tüm reklam istekleri için 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ğerlendirme ayarı yaparsanı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'ya yönlendirilmesini destekleyen uyumlulaştırma bağdaştırıcısı sürümleri listelenmiştir:

Uyumlulaştırma bağdaştırıcısı 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 ayarı

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) uyarınca, "çocuklara yönelik olarak etiketleme" adlı bir ayar vardır. Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulamanın sahibi adına işlem yapma yetkiniz olduğunu onaylamış olursunuz. Bu ayarın kötüye kullanılmasının Google Hesabınızın feshedilmesine yol açabileceğini kabul edersiniz.

Bir uygulama geliştiricisi olarak, bir 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 söz konusu 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 yöntemlerle uygulayabilirsiniz: setTagForChildDirectedTreatment():

• İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtmek için setTagForChildDirectedTreatment parametresini TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE olarak ayarlayın. Bu, Android reklam kimliğinin (AAID) iletilmesini engeller.

• İçeriğinizin COPPA uyarınca çocuklara yönelik olarak değerlendirilmesini istemediğinizi belirtmek için setTagForChildDirectedTreatment parametresini TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE değeriyle çağırın.

• Reklam isteklerinde içeriğinizin COPPA'ya göre nasıl değerlendirilmesini istediğinizi belirtmek istemiyorsanız setTagForChildDirectedTreatment yöntemini TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED ile çağırın.

Aşağıdaki örnekte, içeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğiniz belirtilmektedir:

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 Programı'nda Öncelikli olarak çocuklara yönelik uygulamalar olarak sınıflandırılan uygulamalarda ve Family Link ile yönetilen Google Hesaplarında oturum açmış kullanıcılarda, tüm içerikler tüm reklam istekleri için 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 ayarlayın.

Reklam isteklerinizi, Avrupa Ekonomik Alanı'nda (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) uymayı 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ı, uyumluluğu kolaylaştırmak için tasarlanmıştır ve yayıncıları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 İç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 ayarlarda olduğu gibi, RequestConfiguration.Builder'da 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) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmesini istediğinizi belirtmek için setTagForUnderAgeOfConsent() yöntemini TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE ile çağırın. Bu işlem, 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ılar için değerlendirilmesini istemediğinizi belirtmek üzere TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE ile setTagForUnderAgeOfConsent() yöntemini çağırın.

• Reklam isteğinin Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilip değerlendirilmeyeceğini belirtmediğinizi göstermek amacıyla TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED ile setTagForUnderAgeOfConsent() yöntemini çağırın.

Aşağıdaki örnekte, reklam isteklerinize TFUA'nın dahil edilmesini istediğiniz belirtilmektedir:

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 ayarını ve setTagForUnderAgeOfConsent() ayarını etkinleştiren etiketlerin ikisi de 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, reklam içindeki ilişkili teklifleri de kapsayan Uygunsuz Reklam Politikası'na uymak için, uygulamanızda gösterilen tüm reklamlar ve bunlarla ilişkili teklifler, içerik Google Play'in politikalarıyla uyumlu olsa bile uygulamanızın içerik derecelendirmesi için 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 seviyede veya daha düşük olur. Bu ağ ekstrası için olası değerler, dijital içerik etiketi sınıflandırmalarını temel alı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 tanımı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

• Uygulamalar veya hesaplar 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)

Yayıncı Gizlilik İşlemi (PPT) API'si, uygulamaların setPublisherPrivacyPersonalizationState() yöntemini kullanarak tüm reklam istekleri için reklam kişiselleştirmeyi kapatıp kapatmayacağını belirtmesine olanak tanıyan isteğe bağlı bir araçtır. Bu özellik kullanılırken oturumun geri kalanında gelecekteki tüm reklam isteklerine bir yayıncı gizlilik işlemi (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. Örnekler için Publisher Privacy Treatment API belgelerine bakın.

Reklam isteği

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

Ağ ekstraları ekleme

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

Aşağıdaki kod snippet'i, Google'a bottom değerine sahip ek bir collapsible 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