Hedefleme

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

Bu kılavuzda, bir reklam isteğine hedefleme bilgilerinin nasıl sağlanacağı açıklanmaktadır.

Reklam hedeflemeyi uygulamada görmek için Swift veya Objective-C ile iOS API Demo uygulamasını indirin.

API demosunu indirin

Ön koşullar

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

GADRequestConfiguration

GADRequestConfiguration GADMobileAds paylaşılan örneği aracılığıyla genel olarak uygulanacak hedefleme bilgilerini toplayan bir nesnedir. Bu bilgilere aşağıdaki kodla erişilebilir:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Tüm reklam isteklerinin istek yapılandırması değişikliklerini uyguladığından emin olmak için Initialize Google Mobile Ads SDK yöntemini çağırmadan önce istek yapılandırmasını ayarlayın.

Yaş deneyini ayarlama

Çocuklar ve gençler ile ilgili geçerli gizlilikle ilgili yönetmeliklere uygunluğunuzu yönetmenize yardımcı olmak için Google Mobile Ads SDK, yaşa uygunluk ayarı sunar. Yaş değerlendirmesi ayarı, Google Mobile Ads SDK için çocuklara, gençlere veya belirtilmemiş bir yaşa yönelik belirli reklam sunma korumalarının uygulanıp uygulanmayacağını belirtmenize olanak tanır.

GADRequestConfiguration üzerinde ageRestrictedTreatment özelliğiyle yaşa göre değerlendirme ayarlayabilirsiniz.

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

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

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

  • .teen
  • .unspecified

Objective-C

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;

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

  • GADAgeRestrictedTreatmentTeen
  • GADAgeRestrictedTreatmentUnspecified

Bu ayar kullanılırken, Google Mobile Ads SDK reklam isteklerine tfat parametresi ekler. Yasal ve düzenleyici yükümlülüklerinize göre kullanıcılarınız için uygun yaş ayarlarını belirlemek üzere hukuk danışmanınıza başvurun. Daha fazla bilgi için Reklam isteklerini yaşa göre değerlendirme için etiketleme başlıklı makaleyi inceleyin.

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

Yaş değerlendirmesi ayarı, desteği sonlandırılan tagForChildDirectedTreatment (TFCD) ve tagForUnderAgeOfConsent (TFUA) özelliklerinin yerini alır.

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

TFCD

tagForChildDirectedTreatment Yaş deneyi
tagForChildDirectedTreatment = true GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false GADAgeRestrictedTreatmentUnspecified
tagForChildDirectedTreatment için değer atanmadı GADAgeRestrictedTreatmentUnspecified
Eşdeğeri yok GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent Yaş deneyi
tagForUnderAgeOfConsent = true GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false GADAgeRestrictedTreatmentUnspecified
tagForUnderAgeOfConsent için değer atanmadı GADAgeRestrictedTreatmentUnspecified
Eşdeğeri yok GADAgeRestrictedTreatmentTeen

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.

Uyumlulaştırma ile yaşa göre değerlendirme

Google Mobile Ads SDK 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.6.1.1
Bigo 5.2.1.0
Chartboost 9.12.0.1
DTExchange (Fyber) 8.4.7.1
i-mobile 2.3.4.7
InMobi 11.2.0.1
IronSource 9.4.1.0.1
Liftoff Monetize (Vungle) 7.7.2.1
LY Ads (Line Ads) 3.0.1.1
maio 2.2.1.2
Meta (Facebook) 6.21.1.1
Mintegral 8.1.3.1
Moloco 4.6.1.1
MyTarget 5.43.0.0
Pangle 7.9.1.1.1
PubMatic 5.1.0.1
Verve 3.8.1.1

Çocuklara yönelik ayar

Çocukların Çevrimiçi Gizliliğini Koruma Yasası (COPPA) kapsamında tagForChildDirectedTreatment adlı bir ayar bulunur.

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 belirttiğinizde Google, bu reklam isteğinde ilgi alanına dayalı reklamcılığı ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli adımları atar. Ayar seçenekleri şunlardır:

  • İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtmek için tagForChildDirectedTreatment değerini true olarak ayarlayın. Bu, reklam tanımlayıcısı IDFA'nın iletilmesini engeller.
  • İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istemediğinizi belirtmek için tagForChildDirectedTreatment değerini false olarak ayarlayın.
  • İçeriğinizin COPPA'ya göre nasıl değerlendirilmesini istediğinizi belirtmek istemiyorsanız tagForChildDirectedTreatment seçeneğini ayarlamayın.

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulama sahibi adına işlem yapmaya yetkili olduğunuzu onaylarsınız. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesine yol açabileceğini anlıyorsunuz.

Reklam isteklerinizi, Avrupa Ekonomik Alanı'nda (AEA) bulunan, reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmesi için 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 de olabilir. Avrupa Birliği yönergelerini inceleyin ve kendi hukuk 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 gelecekteki tüm reklam isteklerine Avrupa'da Reşit Olma Yaşının Altındakiler Etiketi (TFUA) parametresi eklenir. Bu parametre, yeniden pazarlama dahil olmak üzere ilgili reklam isteği 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.

Bu ayar, GADMobileAds.requestConfiguration nesnesinde tagForUnderAgeOfConsent özelliği ayarlanarak ve true iletilerek Google Mobile Ads SDK'nın tüm sürümleriyle kullanılabilir.

  • Reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun şekilde işlenmesini istediğinizi belirtmek için tagForUnderAgeOfConsent değerini true olarak ayarlayın. Bu işlem, reklam kimliği IDFA'nın iletilmesini de engeller.
  • tagForUnderAgeOfConsent ayarlanmadığında, reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun şekilde işlenmesini istemediğiniz belirtilir.

Aşağıdaki örnek, reklam isteğinize TFUA'nın dahil edilmesini istediğinizi gösterir:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

Reklam içeriğini filtreleme

Uygulamalar, GADRequestConfiguration maxAdContentRating özelliğini kullanarak tüm reklam istekleri için maksimum reklam içeriği derecelendirmesi ayarlayabilir. Bu ayar, oturumun geri kalanı için gelecekteki tüm reklam isteklerinde geçerlidir. Bu özelliğin olası değerleri, dijital içerik etiketi sınıflandırmalarına dayanır ve aşağıdaki sabitlerden biri olmalıdır:

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

Aşağıdaki kod, döndürülen reklam içeriğinin GADMaxAdContentRatingGeneral'dan daha yüksek olmayan bir dijital içerik etiketi atamasına karşılık gelmesi için tüm reklam isteklerini yapılandırır.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Yayıncı Gizlilik Değerlendirmesi (Beta)

Publisher Privacy Treatment (PPT) API, uygulamaların GADRequestConfigurationpublisherPrivacyPersonalizationState özelliğini 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ı için gelecekteki tüm reklam isteklerine bir yayıncı gizlilik işleme (PPT) parametresi eklenir.

Varsayılan olarak, Google'a yapılan 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:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

GAMRequest nesnesi, bir 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:

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

İçerik URL'si

Uygulamalar, reklam isteğinde bulunurken sundukları içeriğin URL'sini iletebilir. Bu sayede anahtar kelime hedefleme, reklamı içerikle eşleştirebilir.

Örneğin, uygulamanız https://www.example.com kaynağından içerik gösterirken reklam isteğinde bulunuyorsa alakalı anahtar kelimeleri hedeflemek için bu URL'yi iletebilirsiniz:

Swift

let request = AdManagerRequest()
request.contentURL = "https://www.example.com"

Objective-C

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

Özel hedefleme

Ad Manager kullanıcı arayüzünde anahtar/değer çiftlerini yapılandırdıktan sonra, reklam isteğinde anahtar değerleriyle özel hedefleme ayarlayın. Bu anahtar değerleri hedefleyen satır öğeleri, bu reklam isteği için yayınlanabilir. Bir anahtar için birden çok değeri hedeflemek istiyorsanız değerleri virgülle ayrılmış bir dize olarak girin.

Swift

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

Marka güvenliği (Beta)

Farklı kitlelere yönelik dinamik içerik gösteren uygulamalar, neighboringContentURLs özelliği aracılığıyla kısa bir URL listesi sağlayabilir. Komşu içerik URL'leri, yalnızca marka güvenliği için kullanıldığından contentURL mülkünden farklıdır.

Uygulamanızın, reklamlar da içeren bir feed'de dört URL'den içerik gösterdiğini varsayalım. Bu URL'leri aşağıdaki gibi ileterek benzer içerik derecelendirmesine sahip reklamlar isteyebilirsiniz:

Swift

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Yayıncı tarafından sağlanan tanımlayıcılar

Cihazlar genelinde sıklık sınırı, kitle segmentasyonu ve hedefleme, sıralı reklam rotasyonu ve diğer kitleye dayalı reklam yayını kontrollerinde kullanılmak üzere yayıncı tarafından sağlanan bir tanımlayıcı (PPID) ayarlayabilirsiniz.

PPID'yi ayarlama işlemi GAMRequest üzerinden yapılır:

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Yayıncı tarafından sağlanan tanımlayıcıların (PPID) iOS API Demo uygulamasında uygulanması için Ad Manager PPID örneğine bakın:

Swift Objective-C

Yayıncı tarafından sağlanan sinyaller

Reklam isteklerinde kitle ve içeriğe dayalı verileri yayıncı tarafından sağlanan sinyaller (PPS) olarak gönderebilirsiniz. PPS ile, standart sınıflandırmaları kullanarak ve kullanıcı tanımlayıcılarını paylaşmanıza gerek kalmadan, kitle özelliklerinizi tüm işlem türlerindeki teklif verenlerle paylaşarak kullanıcı verilerinizi programatik para kazanmayı iyileştirmek için kullanabilirsiniz. Kitle özellikleriniz davranışa ve ilgi alanına dayalı verileri ( IAB Kitle Sınıflandırması 1.1) ve bağlama dayalı verileri ( IAB İçerik Sınıflandırması 2.2) içerebilir.

Swift

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

SSS

Bir reklam otomatik olarak yenilendiğinde hangi hedefleme kullanılır?
Reklam yenileme işleminde, daha önce belirtilen GAMRequest nesnesi tekrar hedefleme için kullanılır. Yeni hedefleme ayarlamak için loadRequest işlevini yeni bir GAMRequest nesnesiyle GAMBannerView üzerinde açıkça çağırın.
Ek hedefleme parametrelerini uyumlulaştırma ağlarına nasıl iletirim?
Hedeflemeyi uyumlulaştırma ağlarına nasıl göndereceğinizi öğrenmek için Uyumlulaştırma bölümüne bakın.