Hedefleme

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

Reklam hedeflemenin nasıl çalıştığını görmek için Swift veya Objective-C'de iOS API Demo uygulamasını indirin.

API Demosunu indirin

Ön koşullar

Başlarken kılavuzunu tamamlayın.

GADRequestConfiguration

GADRequestConfiguration, GADMobileAds paylaşılan örneği aracılığıyla global olarak uygulanacak hedefleme bilgilerini toplayan bir nesnedir. Bu araca 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) için tagForChildDirectedTreatment adlı bir ayar mevcuttur.

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ğiyle ilgili IBA ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli adımları atar. Ayar seçenekleri aşağıdaki gibidir:

• İç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, IDFA'nın Reklam Kimliği'nin aktarılmasını 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 ele alınmasını istediğinizi belirtmek istemiyorsanız tagForChildDirectedTreatment ayarlamayın.

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

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 hareket etme yetkisine sahip olduğunuzu onaylamış olursunuz. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesiyle sonuçlanabileceğini kabul edersiniz.

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üklerinizin olabileceğini unutmayın. Avrupa Birliği'nin yönergelerini inceleyin ve kendi yasal danışmanınıza başvurun. Google araçlarının, uyumluluğu kolaylaştırmak için tasarlandığını ve herhangi bir yayıncını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, Avrupa'da Reşit Olma Yaşının Altındaki Kullanıcılar İçin Etiket (TFUA) parametresi, gelecekteki tüm reklam isteklerine dahil edilir. 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 true öğesine geçirilerek 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 şekilde işlenmesini istediğinizi belirtmek için tagForUnderAgeOfConsent değerini true olarak ayarlayın. Bu, IDFA'nın Reklam Kimliği'nin iletimini de engeller.
• tagForUnderAgeOfConsent ayarını kullanmamanız, reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun şekilde ele alınmasını istemediğiniz anlamına gelir.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Çocuklara yönelik ayarı etkinleştiren etiketler ile tagForUnderAgeOfConsent aynı anda true olarak ayarlanmamalıdır. Bu şekilde olması durumunda çocuklara yönelik ayar öncelikli olur.

Önemli Nokta: Bu tagForUnderAgeOfConsent parametresi, reklam ağı uyumlulaştırma bağdaştırıcılarına yönlendirilmez. Uygulamanızdaki her üçüncü taraf reklam ağının GDPR'ye göre reşit olma yaşının altındaki kullanıcılara uygun reklamlar sunmasını sağlamak sizin sorumluluğunuzdadır.

Reklam içeriğini filtreleme

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Aşağıdaki kod, tüm reklam isteklerini, döndürülen reklam içeriğinin en fazla GADMaxAdContentRatingGeneral olacak şekilde bir Dijital İçerik Etiketi tanımlamasına karşılık gelmesi gerektiğini belirtecek şekilde yapılandırır.

Önemli Bilgi: SDK aracılığıyla belirtilen içerik derecelendirmesi filtresi ayarları, Ad Manager kullanıcı arayüzü kullanılarak yapılandırılan tüm ayarları geçersiz kılar.

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Yayıncılara Yönelik Gizlilik Değerlendirmesi (Beta)

Yayıncı Gizlilik Değerlendirmesi (PPT) API, GADRequestConfiguration öğesinin publisherPrivacyPersonalizationState özelliğini kullanarak tüm reklam istekleri için reklam kişiselleştirmenin devre dışı bırakılıp bırakılmayacağını uygulamaların belirtmesine olanak tanıyan isteğe bağlı bir araçtır. Bu özellik kullanılırken yayıncı gizlilik değerlendirmesi (PPT) parametresi, oturumun kalanı için gelecekteki tüm reklam isteklerine dahil edilir.

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 kapatır:

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Not: Birden fazla kullanıcı gizlilik sinyaline sahip reklam istekleri için en kısıtlayıcı sinyal öncelikli olur. Özel örnekler için Publisher Privacy Treatment API belgelerini inceleyin.

GAMRequest

GAMRequest nesnesi, bir reklam isteğiyle birlikte gönderilecek hedefleme bilgilerini toplar.

İçerik URL'si

Uygulamalar, reklam isteğinde bulunurken yayınladıkları içeriğin URL'sini iletebilir. Bu, anahtar kelime hedeflemenin reklamı içerikle eşleştirmesini sağlar.

Örneğin, uygulamanız https://www.example.com içeriğini gösterirken reklam isteğinde bulunuyorsa alakalı anahtar kelimeleri hedeflemek için şu 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 isteğindeki anahtar değerleriyle ö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ğer hedeflemek istiyorsanız değerleri virgülle ayrılmış 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)

Çeşitli kitlelere yönelik dinamik içerikler gösteren uygulamalar, neighboringContentURLs özelliğini kullanarak 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, aynı zamanda reklam da içeren bir feed'de dört URL'den içerik gösterdiğini varsayalım. Bu URL'lerle benzer içerik derecelendirmesine sahip reklamları aşağıdaki şekilde ileterek 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"];

Önemli Nokta: SDK yalnızca ilk dört URL'yi kullanır. Diğer tüm seçenekler yoksayılır.

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 diğer kitleye dayalı reklam yayını kontrolleri için kullanılacak, yayıncı tarafından sağlanan bir tanımlayıcı (PPID) ayarlayabilirsiniz.

Not: Bu özellik tüm yayıncılar tarafından kullanılamaz. Ayrıntılar için Yayıncı tarafından sağlanan tanımlayıcılar hakkında bölümüne bakın.

PPID ayarlama işlemi 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ı için Ad Manager PPID örneğine bakın:

Swift Objective-C

Yayıncı tarafından sağlanan sinyaller

Kitle ve içerik verilerini, reklam isteklerinde yayıncı tarafından sağlanan sinyaller (PPS) olarak gönderebilirsiniz. PPS ile kitle özelliklerinizi tüm işlem türlerindeki teklif verenlere ileterek standart sınıflandırmalar kullanıp kullanıcı tanımlayıcılarını paylaşmaya gerek kalmadan 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 içeriğe 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 yenilemesinde, daha önce belirtilen GAMRequest nesnesi hedefleme için tekrar kullanılır. Yeni hedefleme ayarlamak için GAMBannerView üzerinde loadRequest öğesini yeni bir GAMRequest nesnesiyle açıkça çağırın.

Uyumlulaştırma ağlarına ek hedefleme parametrelerini nasıl iletirim?

Uyumlulaştırma ağlarına nasıl hedefleme göndereceğinizi öğrenmek için Uyumlulaştırma bölümüne bakın.