Hedefleme

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.

API Demo'sunu 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ğerini true 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ğerini false 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ğerini true 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.

Temel Nokta: Bu tagForUnderAgeOfConsent parametresi, üçüncü taraf reklam kaynakları için 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 yayınlamasını sağlamak sizin sorumluluğunuzdadır.

Reklam içeriği 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ün 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, 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.

Önemli Bilgi: SDK aracılığıyla belirtilen içerik derecelendirme filtresi ayarları, Ad Manager kullanıcı arayüzü

kullanılarak yapılandırılmış tüm ayarları geçersiz kılar.

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;

Not: Birden fazla kullanıcı gizliliği sinyali içeren reklam isteklerinde en kısıtlayıcı sinyal öncelikli olur. Belirli örnekler için Publisher Privacy Treatment API belgelerine göz atın.

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"];

Önemli Bilgi: SDK yalnızca ilk dört URL'yi kullanır. Diğer tüm değerler 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 kitleye dayalı diğer reklam yayınlama kontrolleri için 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 başlıklı makaleyi inceleyin.

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:

Swift Objective-C

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 bir GAMRequest nesnesi ile GAMBannerView üzerinde loadRequest ç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.