Hedefleme

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

Reklam hedeflemeyi uygulamalı olarak görmek için Swift veya Objective-C'de iOS API Demo uygulamasını indirin.

API Demosunu İndirin

Ön koşullar

Başlangıç kılavuzunu tamamlayın.

GADRequestConfiguration

GADRequestConfiguration, GADMobileAds paylaşılan örneği aracılığıyla global olarak uygulanacak hedefleme bilgilerini toplayan bir nesnedir. Bu sayfaya 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 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ğindeki IBA ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli adımları atar. Ayar seçenekleri şu şekildedir:

• COPPA amaçları doğrultusunda içeriğinizin çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtmek için tagForChildDirectedTreatment değerini true olarak ayarlayın. Bu, reklam kimliği IDFA'nın iletimini önler.
• İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istemediğinizi belirtmek için tagForChildDirectedTreatment özelliğini false olarak ayarlayın.
• İçeriğinizin COPPA'ya göre nasıl ele alınmasını istediğinizi belirtmek istemiyorsanız tagForChildDirectedTreatment özelliğini ayarlamayın.

Aşağıdaki örnek, içeriğinizin COPPA amaçlarına uygun şekilde ç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 işlem yapma yetkisine sahip olduğunuzu onaylamış olursunuz. Bu ayarın kötüye kullanımı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) 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 de 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 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 dahil edilecektir. Bu parametre, söz konusu reklam isteği için yeniden pazarlama dahil kişiselleştirilmiş reklamcılığı devre dışı bırakır. Ayrıca reklam ölçüm pikselleri ve üçüncü taraf reklam sunucuları gibi üçüncü taraf reklam tedarikçilerine gönderilen istekleri de devre dışı bırakır.

Bu ayar, GADMobileAds.requestConfiguration nesnesi üzerinde tagForUnderAgeOfConsent özelliği ayarlanıp true parametresi iletildiğinde 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, reklam kimliği IDFA'nın iletimini de engeller.
• tagForUnderAgeOfConsent politikasını ayarlamamak, reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun şekilde işlenmesini istemediğinizi gösterir.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Çocuklara yönelik ayarı ve tagForUnderAgeOfConsent ayarını etkinleştirecek etiketler aynı anda true olarak ayarlanmamalıdır. Bu durumda çocuklara yönelik ayar öncelikli olur.

Önemli 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 sunmasını sağlamak sizin sorumluluğunuzdadır.

Reklam içeriği filtreleme

Uygulamalar, GADRequestConfiguration öğesinin maxAdContentRating özelliğini kullanarak tüm reklam istekleri için maksimum reklam içeriği derecelendirmesi belirleyebilir. Bu ayar, oturumun geri kalanında gelecekteki tüm reklam istekleri için geçerli olur. 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 GADMaxAdContentRatingGeneral üzerinde olmayan 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ı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)

Yayıncı Gizlilik Değerlendirmesi (PPT) API, uygulamaların GADRequestConfiguration özelliğinin publisherPrivacyPersonalizationState özelliğini kullanarak tüm reklam istekleri için reklam kişiselleştirmenin kapatılıp kapatılmayacağını belirtmesini sağlayan 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 değerlendirmesi (PPT) parametresi eklenir.

Varsayılan olarak, Google'a gönderilen reklam isteklerine 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ı gizliliği sinyali içeren reklam istekleri için en kısıtlayıcı sinyal öncelikli olur. Publisher Privacy Treatment API belgelerine özel örnekler için göz atın.

GAMRequest

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

İçerik URL'si

Uygulamalar, reklam isterken, sundukları 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çeriklerini gösterirken reklam isteğinde bulunuyorsa 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 isteğindeki anahtar/değer çiftleriyle özel hedeflemeyi ayarlayın. Böylece bu anahtar/değer çiftlerini hedefleyen satır öğeleri, bu reklam isteği için yayınlanmaya uygun olur. Bir anahtara ait birden çok değeri hedeflemek için 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ği aracılığıyla URL'lerin kısa bir listesi sağlayabilir. Komşu içerik URL'leri, yalnızca marka güvenliği için kullanılmaları açısından contentURL özelliğinden farklıdır.

Uygulamanızın, 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 Bilgi: SDK, yalnızca ilk dört URL'yi kullanır. Diğer tüm konumlar 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 cihazlarda diğer kitleye dayalı reklam yayını 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 bölümüne bakın.

PPID'yi 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ğini inceleyin:

Swift Hedef-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 sayesinde, kullanıcı tanımlayıcılarını paylaşmaya gerek kalmadan standart sınıflandırmalar kullanarak kitle özelliklerinizi tüm işlem türlerinde teklif verenlere ileterek programatik para kazanmayı iyileştirmek için kullanıcı verilerinizi kullanabilirsiniz. Kitle özellikleriniz, davranışsal 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 yenilemede, daha önce belirtilen GAMRequest nesnesi hedefleme için tekrar kullanılır. Yeni hedefleme ayarlamak için GAMBannerView üzerinde yeni bir GAMRequest nesnesiyle loadRequest öğesini açıkça çağırın.

Ek hedefleme parametrelerini uyumlulaştırma ağlarına nasıl iletirim?

Hedeflemenin uyumlulaştırma ağlarına nasıl gönderileceğini öğrenmek için Uyumlulaştırma konusuna bakın.