Bu kılavuzda, bir reklam isteğine hedefleme bilgilerinin nasıl sağlanacağı açıklanmaktadır. Örneğin, çalışan bir örnek görmek için Android API Demo uygulamasını indirin.
Ön koşul
- Başlangıç kılavuzunu tamamlayın.
RequestConfiguration
RequestConfiguration
global olarak uygulanacak hedefleme bilgilerini toplayan bir nesnedir.
MobileAds
statik yöntem.
İstek yapılandırmasını güncellemek için mevcut yapılandırma, istediğiniz güncellemeleri gerçekleştirin ve ayarları aşağıdaki gibi ayarlayın:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Çocuklara yönelik ayar
Çocukların Çevrimiçi Gizliliğini Koruma Yasası'nın amaçları doğrultusunda (COPPA) "çocuklara yönelik olarak değerlendirilme için etiketle" adlı bir ayar vardır. Bu etiketi ayarlayarak bildirimin doğru olduğunu onaylamış olursunuz ve uygulamanın sahibi adına işlem yapma yetkiniz olmalıdır. Bu ayarın kötüye kullanımının feshedilmesiyle sonuçlanabileceğini kabul ediyorsunuz. bir yolunu sunar.
Uygulama geliştirici olarak, uygulamanızın veya oyununuzun Google tarafından bir reklam isteği yaptığınızda, içeriğin çocuklara yönelik olarak belirtilmesi. Proje yönetiminin Google'ın içeriğinizi çocuklara yönelik olarak değerlendirmesini istiyorsanız Bu reklam isteğinde IBA ve yeniden pazarlama reklamlarını devre dışı bırakabilir.
Bu ayar, Google Play Hizmetleri SDK'sının tüm sürümleriyle kullanılabilir
RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
ile:
setTagForChildDirectedTreatment
adlı kişiyi şununla ara:TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilen içerikler. Bu durum, Android reklam kimliğinin iletimi (AAID) ile gönderin.setTagForChildDirectedTreatment
adlı kişiyi şununla ara: Şunu istemediğinizi belirtmek içinTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilen içerikler.setTagForChildDirectedTreatment
adlı kişiyi şununla ara: Belirtmek istemiyorsanızTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
İçeriğinizin reklam isteklerinde COPPA'ya göre nasıl ele alınmasını istediğinizi belirleyin.
Aşağıdaki örnek, içeriğinizin şu şekilde değerlendirilmesini istediğinizi gösterir: COPPA amaçları doğrultusunda çocuklara yönelik içerik:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Reşit olma yaşının altındaki kullanıcılar
Reklam isteklerinizi Reşit olma yaşının altındaki Avrupa Ekonomik Alanı (AEA). Bu özellik Genel Hükümler'e uygunluğu kolaylaştırmak amacıyla Veri Koruma Yönetmeliği (GDPR). Başka yasal gerekçelerle yükümlülüklere tabidir. Avrupa Birliği'nin yönergelerini inceleyin ve yasal danışmanınızın görüşünü alın. Google'ın araçlarının, herkesin kullanımına hiçbir yayıncının sözleşme yükümlülüğünü ortadan kaldırmaması ve kabul edersiniz. . GDPR'nin yayıncıları nasıl etkilediği hakkında daha fazla bilgi edinin.
Bu özellik kullanılırken Avrupa'da Reşit Olma Yaşının altındaki kullanıcılara yönelik bir etiket (TFUA) parametresi reklam isteğine eklenir. Bu parametre, yeniden pazarlama dahil olmak üzere tüm reklam istekleri için kişiselleştirilmiş reklamcılık. Aynı zamanda üçüncü taraf reklam tedarikçilerine yapılan istekleri (ör. reklam ölçüm pikselleri ve üçüncü taraf reklam sunucuları.
Çocuklara yönelik ayarlarda olduğu gibi,
TFUA parametresini ayarlamak için RequestConfiguration.Builder
:
setTagForUnderAgeOfConsent()
yapabilirsiniz.
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
ilesetTagForUnderAgeOfConsent()
numaralı telefonu ara Böylece, reklam isteğinin belirli bir ülkedeki kullanıcılar için reşit olma yaşının altındaki Avrupa Ekonomik Alanı (AEA). Bu ayrıca Android reklam kimliğinin iletimini önler (AAID) ile gönderin.TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
ilesetTagForUnderAgeOfConsent()
numaralı telefonu ara (reklam isteğinin, kullanıcılar için değerlendirilme almamasını istediğinizi belirtebilirsiniz) Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altında.setTagForUnderAgeOfConsent()
adlı kişiyi şununla ara: Aşağıdakileri belirtmek içinTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
reklam isteğinin, Reşit olma yaşının altındaki Avrupa Ekonomik Alanı (AEA).
Aşağıdaki örnek, TFUA'nın reklam isteklerinize dahil edilmesini istediğinizi gösterir:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Çocuklara yönelik ayarını etkinleştirecek etiketler
ve setTagForUnderAgeOfConsent()
aynı anda true
olarak ayarlanmamalıdır.
Bu durumda çocuklara yönelik ayar öncelikli olur.
Reklam içeriği filtreleme
Google Play'in Uygunsuz Reklamlar Politikası'na uymak için Bir reklamdaki ilişkili teklifleri, tüm reklamları ve bunlarla ilişkili reklamları içeren uygulamanızda gösterilen teklifler, içeriğe uygun olmalıdır puan: içeriği tek başına Google ile uyumlu olsa bile, uygulamanız Play'in politikalarına tabidir.
Maksimum reklam içeriği derecelendirmesi gibi araçlar, reklamlarınızın Kullanıcılarınıza gösterilen reklamların içeriği. Maksimum içerik derecelendirmesi platform politikalarına uymanıza yardımcı olur.
Uygulamalar, reklam istekleri için maksimum reklam içeriği derecelendirmesi
setMaxAdContentRating
yöntemidir. Bu yapılandırmanın izlemesi ve içerik derecelendirmesi olduğunda döndürülen AdMob reklamları
unutmayın. Bu ekstra ağ için olası değerler,
dijital içerik etiketi sınıflandırmaları ve aşağıdakilerden biri olmalıdır
dizeler:
MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA
Aşağıdaki kod, RequestConfiguration
nesnesini
döndürülen reklam içeriği, dijital içerik etiketi tanımlamasına karşılık gelmelidir.
G
değerinden yüksek:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var 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:
Her reklam için maksimum içerik derecelendirmesini ayarlama talep edin
Bir uygulama için maksimum reklam içeriği derecelendirmesi ayarlama veya hesap
Yayıncı Gizlilik Değerlendirmesi (Beta)
İlgili içeriği oluşturmak için kullanılan
Yayıncı Gizlilik Değerlendirmesi
(PPT) API, uygulamaların reklamları kapatıp kapatmayacağını belirtmesini sağlayan isteğe bağlı bir araçtır.
setPublisherPrivacyPersonalizationState()
yöntemini kullanabilirsiniz.
Bu özellik kullanılırken bir yayıncı gizliliğini işleme (PPT) parametresi
için gelecekteki tüm reklam isteklerine dahil edilecektir.
Varsayılan olarak, Google'a gönderilen reklam isteklerine kişiselleştirilmiş reklamlar yayınlanır. Aşağıdakiler Kod, tüm reklam istekleri için reklam kişiselleştirmeyi kapatır:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Reklam isteği
AdManagerAdRequest
nesnesi hedefleme toplar
bir reklam isteğiyle gönderilecek.
Özel hedefleme
Google Ad Manager kampanyalarını (satır
öğeler) ile AdManagerAdRequest.Builder.addCustomTargeting()
arasında):
Java
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build();
Kotlin
// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build()
Bir anahtar için birden çok değeri dize listesi olarak aktarabilirsiniz. Örneğin, 25 yaşındaki değil 25 yaşının ortalarındaki bireyleri hedeflemek.
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
Ad Manager Özel Hedefleme örneğini inceleyin. inceleyebilirsiniz.
Kategori hariç tutmaları
Şu API'yi kullanarak bir isteğe alan düzeyinde kategori hariç tutma düzeyi ekleyebilirsiniz:
addCategoryExclusion()
AdManagerAdRequest.Builder
tarafından sağlanan yöntem:
Java
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();
Kotlin
// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build()
Ad Manager Kategori Hariç Tutmaları örneğini inceleyin inceleyebilirsiniz.
Yayıncı tarafından sağlanan tanımlayıcılar
Sıklık sınırında kullanmak üzere yayıncı tarafından sağlanan bir tanımlayıcı (PPID) ayarlayabilirsiniz. kitle segmentasyonu ve hedefleme, sıralı reklam rotasyonu vb. cihazlar genelinde reklam yayını kontrolleri.
Aşağıda, PPID'yi ayarlamayla ilgili bir örnek verilmiştir:
Java
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build();
Kotlin
var adRequest = AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build()
Ad Manager PPID örneğini inceleyin Android'de yayıncı tarafından sağlanan tanımlayıcıların (PPID) uygulanması için API Demo uygulaması.
Yayıncı tarafından sağlanan sinyaller
Kitle ve içerik verilerini yayıncı tarafından sağlanan sinyaller (PPS). PPS sayesinde, kullanıcı verilerinizi kullanarak programatik para kazanma yöntemlerini, hedef kitlenizin özelliklerini teklif verenlerin toplam işlem türlerini standart sınıflandırmalar kullanarak kullanıcı tanımlayıcılarının paylaşılmasına gerek kalmaz. Kitleniz özellikler, davranış ve ilgi alanına dayalı verileri (IAB Kitle Sınıflandırma 1.1) ve bağlamsal verilerini (IAB İçerik Sınıflandırması 2.2) kapsar.
Java
Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build()
Kotlin
val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))
val request = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
İçerik URL'si
İçerik hedefli reklamlar ve marka güvenliği için bir içerik URL'si sağlamak üzere
setContentUrl()
AdManagerAdRequest
oluştururken:
Java
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
Kotlin
val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()
Marka güvenliği (Beta)
Çeşitli kitlelere yönelik dinamik içerik gösteren uygulamalar
kısa bir URL listesi sağlamak için
setNeighboringContentUrls()
yöntemini çağırın:AdManagerAdRequest
Java
ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build();
Kotlin
var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
"https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build()
.setNeighboringContentUrls()
ile .setContentUrl()
arasındaki fark yalnızca
dört farklı teknik bulunur.