Bu kılavuzda, bir reklam isteğine hedefleme bilgilerinin nasıl sağlanacağı açıklanmaktadır.
Reklam hedeflemenin işleyişini görmek için Swift veya Objective-C'te iOS API Demo uygulamasını indirin.
Ön koşullar
Başlangıç kılavuzunu tamamlayın.
GADRequestConfiguration
GADRequestConfiguration
, paylaşılan örnek aracılığıyla dünya genelinde uygulanacak hedefleme bilgilerini toplayan bir nesnedir.GADMobileAds
Bu bilgilere aşağıdaki kodla erişilebilir:
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
Çocuklara yönelik ayar
Çocukların Çevrimiçi Gizliliğini Koruma Yasası (COPPA) kapsamında tagForChildDirectedTreatment
adlı bir ayar vardır.
Uygulama geliştirici olarak, reklam isteği gönderirken 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, ilgili reklam isteğinde IAB ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli işlemleri yapar. Ayar seçenekleri şunlardır:
- İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini belirtmek için
tagForChildDirectedTreatment
değerinitrue
olarak ayarlayın. Bu, reklam kimliğinin (IDFA) iletilmesini engeller. - İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istemediğinizi belirtmek için
tagForChildDirectedTreatment
değerinifalse
olarak ayarlayın. - İçeriğinizin COPPA'ya göre nasıl değerlendirilmesini istediğinizi belirtmek istemiyorsanız
tagForChildDirectedTreatment
değerini ayarlamayınız.
Aşağıdaki örnekte, içeriğinizin COPPA'ya göre çocuklara yönelik olarak değerlendirilmesini istediğiniz belirtilmektedir:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;
Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulamanın sahibi adına işlem yapmaya yetkili olduğunuzu onaylarsınız. Bu ayarın kötüye kullanılmasının Google Hesabınızın feshedilmesine yol açabileceğini kabul edersiniz.
Reşit olma yaşının altındaki kullanıcılar
Reklam isteklerinizi, Avrupa Ekonomik Alanı'nda (AEA) bulunan, reşit olmayan 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 danışın. Google araçlarının, uyumluluğu kolaylaştırmak için tasarlandığını ve yayıncıların hukuki yükümlülüklerini azaltmadığını unutmayın. 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ındaki kullanıcılar için etiket (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
mülkünü ayarlayarak ve true
değerini ileterek Google Mobile Ads SDK'sının tüm sürümleriyle kullanılabilir.
- Reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun bir şekilde ele alınmasını istediğinizi belirtmek için
tagForUnderAgeOfConsent
değerinitrue
olarak ayarlayın. Bu, reklam kimliğinin (IDFA) iletilmesini de engeller. tagForUnderAgeOfConsent
ayarını yapmamak, reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun bir şekilde ele alınmasını istemediğinizi gösterir.
Aşağıdaki örnekte, TFUA'nın reklam isteğinize dahil edilmesini istediğiniz belirtilmektedir:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
Çocuklara yönelik ayar'ı etkinleştiren etiketler ve tagForUnderAgeOfConsent
aynı anda true
olarak ayarlanmamalıdır.
Bu şekilde ayarlanırlarsa çocuklara yönelik ayar öncelikli olur.
Reklam içeriğini filtreleme
Uygulamalar, GADRequestConfiguration
mülkünün maxAdContentRating
mülkünü kullanarak tüm reklam istekleri için maksimum reklam içeriği derecelendirmesi belirleyebilir. Bu ayar, oturumun geri kalanı için gelecekteki tüm reklam isteklerine uygulanır. Bu mülk için olası değerler 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, tüm reklam isteklerini, döndürülen reklam içeriğinin GADMaxAdContentRatingGeneral
'ten yüksek olmayan bir Dijital İçerik Etiketi tanımına karşılık gelmesini belirtecek şekilde yapılandırır.
Swift
GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
Yayıncı Gizlilik Değerlendirmesi (Beta)
Publisher Privacy Treatment
(PPT) API, uygulamaların GADRequestConfiguration
mülkünü 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.publisherPrivacyPersonalizationState
Bu özellik kullanılırken oturumun geri kalanı için gelecekteki tüm reklam isteklerine bir yayıncı gizlilik değerlendirmesi (PPT) parametresi eklenir.
Google'a yapılan reklam isteklerinde varsayılan olarak 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
GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GAMRequest
GAMRequest
nesnesi, reklam isteğiyle gönderilecek hedefleme bilgilerini toplar.
İç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
'ten içerik gösterirken reklam istiyorsa alakalı anahtar kelimeleri hedeflemek için bu URL'yi iletebilirsiniz:
Swift
let request = GAMRequest()
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 isteklerindeki anahtar/değer çiftleriyle özel hedefleme ayarlayın. Bu anahtar/değer çiftlerini hedefleyen satır öğeleri, bu reklam isteği için yayınlanmaya uygun olur. Bir anahtar için birden fazla değeri hedeflemek istiyorsanız değerleri virgülle ayrılmış bir dize olarak girin.
Swift
let request = GAMRequest()
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çerikler görüntüleyen uygulamalar, neighboringContentURLs
mülkü aracılığıyla URL'lerin kısa bir listesini sağlayabilir. Komşu içerik URL'leri, yalnızca marka güvenliği için kullanıldıkları için 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 bu URL'lere benzer içerik derecelendirmesine sahip reklamlar isteyebilirsiniz:
Swift
let request = GAMRequest()
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
Sıklık sınırı, kitle segmentasyonu ve hedefleme, sıralı reklam rotasyonu ve cihazlar arasında kitleye dayalı diğer reklam yayınlama kontrolleri için yayıncı tarafından sağlanan bir tanımlayıcı (PPID) ayarlayabilirsiniz.
PPID'nin ayarlanması GAMRequest
üzerinden yapılır:
Swift
let request = GAMRequest()
request.publisherProvidedID = "AB123456789"
Objective-C
GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";
iOS API Demo uygulamasında yayıncı tarafından sağlanan tanımlayıcıların (PPID) uygulanmasıyla ilgili Ad Manager PPID örneğine bakın:
Yayıncı tarafından sağlanan sinyaller
Kitle ve içeriğe dayalı verileri reklam isteklerinde yayıncı tarafından sağlanan sinyaller (PPS) olarak gönderebilirsiniz. PPS ile kullanıcı tanımlayıcılarını paylaşmanıza gerek kalmadan standart sınıflandırmaları kullanarak kitle özelliklerinizi tüm işlem türlerindeki teklif verenlere ileterek programatik para kazanmayı iyileştirmek için kullanıcı verilerinizi kullanabilirsiniz. Kitle özellikleriniz davranış 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 = GADExtras()
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 = GAMRequest()
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 yenilendiğinde, daha önce belirtilen
GAMRequest
nesnesi hedefleme için tekrar kullanılır. Yeni hedefleme ayarlamak için yeni birGAMRequest
nesnesi ileGAMBannerView
üzerindeloadRequest
çağrısı yapın. - Uyumlulaştırma ağlarına nasıl ek hedefleme parametreleri iletebilirim?
- Uyumlulaştırma ağlarına hedeflemeyi nasıl göndereceğinizi öğrenmek için Uyumlulaştırma başlıklı makaleyi inceleyin.