Bu sayfa, Cloud Translation API ile çevrilmiştir.

Hedefleme

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.

API Demosunu İndirin

Ö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çin TAG_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ız TAG_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 ile setTagForUnderAgeOfConsent() 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 ile setTagForUnderAgeOfConsent() 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çin TAG_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:

ziyaret edin. kullanılarak yapılandırılan ayarları geçersiz kılın.

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.