Bu kılavuzda, Google Mobile Ads SDK'sına hedefleme bilgilerinin nasıl sağlanacağı açıklanmaktadır.
Ön koşul
Devam etmeden önce GMA Next-Gen SDK 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.
Oluşturucusunu kullanarak ihtiyacınız olan hedefleme etiketlerini içeren bir RequestConfiguration nesnesi oluşturun, ardından MobileAds.setRequestConfiguration() yöntemini çağırarak yapılandırmayı ayarlayın.
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
İlk reklam isteğindeki hedefleme etiketlerini uygulamak için SDK başlatma sırasında istek yapılandırmasını sağlayın:
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
CoroutineScope(Dispatchers.IO).launch {
// Initialize GMA Next-Gen SDK on a background thread.
MobileAds.initialize(
this@MainActivity,
InitializationConfig
// Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
.Builder("SAMPLE_APP_ID")
.setRequestConfiguration(requestConfiguration)
.build()
) {
// Adapter initialization is complete.
}
// Other methods on MobileAds can now be called.
}
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
new Thread(
() -> {
// Initialize GMA Next-Gen SDK on a background thread.
MobileAds.initialize(
this,
// Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
new InitializationConfig
.Builder("SAMPLE_APP_ID")
.setRequestConfiguration(requestConfiguration)
.build(),
initializationStatus -> {
// Adapter initialization is complete.
});
// Other methods on MobileAds can now be called.
})
.start();
Yaş değerlendirmesini ayarlama
GMA Next-Gen SDK, çocuklarla ve gençlerle ilgili gizlilik yönetmeliklerine uymanıza yardımcı olmak için yaşa uygun işlem ayarı sunar. Yaşa uygun içerik ayarı, GMA Next-Gen SDK 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'deki setAgeRestrictedTreatment() yöntemiyle yaşa uygun muamele ayarını yapabilirsiniz.
Aşağıdaki örnekte, reklam isteklerinin çocuk yaştakilere yönelik olarak değerlendirilmesi gerektiği belirtilmektedir:
Kotlin
val requestConfiguration =
RequestConfiguration.Builder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
new RequestConfiguration.Builder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);Gençlere yönelik veya belirtilmemiş yaş değerlendirmesini belirtmek için CHILD ayarını aşağıdakiyle değiştirin:
TEENUNSPECIFIED
Bu ayar kullanıldığında GMA Next-Gen SDK, 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şa göre değerlendirmeye 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 |
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.
AdMob Uyumlulaştırması ile yaşa göre değerlendirmeyi iletme
GMA Next-Gen SDK 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ı
Çocukların Çevrimiçi Gizliliğini Koruma Yasası (COPPA) uyarınca, "çocuklara yönelik olarak değerlendirilmek üzere etiketleme" adlı bir ayar vardır. Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulamanın sahibi adına hareket etme yetkiniz olduğunu onaylamış olursunuz. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesine yol açabileceğini kabul ediyorsunuz.
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
setTagForChildDirectedTreatmentparametresiniTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUEile çağırı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
setTagForChildDirectedTreatmentyönteminiTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSEile çağırın.Reklam isteklerinde içeriğinizin COPPA'ya göre nasıl değerlendirilmesini istediğinizi belirtmek istemiyorsanız
setTagForChildDirectedTreatmentyönteminiTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIEDile ç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 = RequestConfiguration
.Builder()
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Reşit olma yaşının altındaki kullanıcılar
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) 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ı, 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önteminiTAG_FOR_UNDER_AGE_OF_CONSENT_TRUEile ç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ılara yönelik olarak değerlendirilmemesini istediğinizi belirtmek için
setTagForUnderAgeOfConsent()yönteminiTAG_FOR_UNDER_AGE_OF_CONSENT_FALSEile ç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 göstermek için
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIEDilesetTagForUnderAgeOfConsent()yöntemini çağırın.
Aşağıdaki örnekte, reklam isteklerinize TFUA'nın dahil edilmesini istediğiniz belirtilmektedir:
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Ç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, uygulamanızın içerik derecelendirmesine uygun olmalıdır (içerik kendi başına Google Play'in politikalarına uygun olsa bile).
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 yapılandırıldığında döndürülen AdMob reklamlarının içerik derecelendirmesi bu düzeyde 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_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_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 = RequestConfiguration
.Builder()
.setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
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
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ştirmenin kapatılıp kapatılmayacağını belirtmesine olanak tanıyan isteğe bağlı bir araçtır. Bu özellik kullanıldığında, 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 = RequestConfiguration
.Builder()
.setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Yaklaşık konumu toplama
GMA Next-Gen SDK, cihaz konumuna göre hedeflenen reklamları göstermek için yaklaşık konumu toplayabilir. Kullanıcı uygulamanızda konum izni verirse GMA Next-Gen SDK yaklaşık konum bilgisini toplar.
GMA Next-Gen SDK 1.7.0 sürümünden itibaren yaklaşık konum toplama özelliği varsayılan olarak etkindir. setCoarseLocationCollectionEnabled() yöntemini kullanarak yaklaşık konum verilerinin toplanmasını devre dışı bırakabilirsiniz.
Aşağıdaki örnekte yaklaşık konum toplama devre dışı bırakılmıştır:
Kotlin
val requestConfiguration =
RequestConfiguration.Builder()
// Disable automatic coarse location collection by the SDK.
.setCoarseLocationCollectionEnabled(false)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
new RequestConfiguration.Builder()
// Disable automatic coarse location collection by the SDK.
.setCoarseLocationCollectionEnabled(false)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);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 =
NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
NativeAdLoader.load(adRequest, adCallback)
Java
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
NativeAdLoader.load(adRequest, adCallback);