Hedefleme

Bu kılavuzda, bir reklam isteğine hedefleme bilgilerinin nasıl 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 indirme

Ön koşullar

Devam etmeden önce Google Mobile Ads SDK uygulamasını kurun.

GADRequestConfiguration

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

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Tüm reklam isteklerinin istek yapılandırması değişikliklerini uyguladığından emin olmak için Google Mobile Ads SDK ilk kullanıma hazırlamadan önce istek yapılandırmasını ayarlayın.

Yaş değerlendirmesini ayarlama

Google Mobile Ads SDK, çocuklarla ve gençlerle ilgili gizlilik yönetmeliklerine uygunluğunuzu yönetmenize yardımcı olmak için yaşa uygun işlem ayarı sunar. Yaşa uygun içerik ayarı, Google Mobile Ads SDK platformunun çocuklar, gençler veya belirtilmemiş bir yaş için belirli reklam sunma korumaları uygulayıp uygulamayacağını belirtmenize olanak tanır.

Yaşa göre değerlendirmeyi GADRequestConfiguration üzerindeki ageRestrictedTreatment özelliğiyle ayarlayabilirsiniz.

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

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

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

Bu ayar kullanıldığında Google Mobile Ads SDK, reklam isteklerine bir tfat parametresi ekler. Yasal ve düzenleyici yükümlülüklerinize göre kullanıcılarınız için uygun yaşa göre işleme ayarı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 eşdeğerleri gösterilmektedir:

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ş değerlendirmesini yönlendirme

Google Mobile Ads SDK kullanarak yaşa göre değerlendirme ayarı yaparsanı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'ya yönlendirilmesini destekleyen uyumlulaştırma bağdaştırıcısı sürümleri listelenmiştir:

Çocuklara yönelik ayarı

Çocukların Çevrimiçi Gizliliğini Koruma Yasası (COPPA) uyarınca tagForChildDirectedTreatment adlı bir ayar vardır.

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, söz konusu reklam isteğinde 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 parametresini 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.

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

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulamanın sahibi adına hareket etme yetkiniz olduğunu onaylamış olursunuz. Bu ayarın kötüye kullanılmasının Google Hesabınızın kapatılmasına neden olabileceğ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) uymayı kolaylaştırmak için tasarlanmıştır. GDPR kapsamında başka yasal yükümlülükleriniz olabilir. Avrupa Birliği yönergelerini inceleyin ve kendi yasal danışmanınıza başvurun. Google'ın araçları, uyumluluğu kolaylaştırmak için tasarlanmıştır ve yayıncıları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ındaki Kullanıcılar İç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 özelliğini ayarlayıp true değerini ileterek Google Mobile Ads SDK ürünü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 parametresini true olarak ayarlayın. Bu işlem, reklam kimliğinin (IDFA) iletilmesini de engeller.
• tagForUnderAgeOfConsent ayarının yapılmaması, reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun şekilde işlenmesini istemediğinizi gösterir.

Aşağıdaki örnekte, reklam isteğinize TFUA'nın dahil edilmesini istediğiniz belirtilmektedir:

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Çocuklara yönelik ayarını ve tagForUnderAgeOfConsent'yi etkinleştiren etiketlerin ikisi de aynı anda true olarak ayarlanmamalıdır. Bu şekilde ayarlanırlarsa çocuklara yönelik ayarı öncelikli olur.

Reklam içeriğini filtreleme

Uygulamalar, GADRequestConfiguration öğesinin 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 özelliğin olası değerleri, dijital içerik etiketi sınıflandırmalarını temel alı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 değerinden yüksek olmayan bir dijital içerik etiketi tanımına karşılık gelmesi gerektiğini belirtecek şekilde yapılandırır.

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Yayıncı Gizlilik Değerlendirmesi (Beta)

Publisher Privacy Treatment (PPT) API, uygulamaların GADRequestConfiguration'in publisherPrivacyPersonalizationState özelliğini kullanarak tüm reklam istekleri için reklam kişiselleştirmenin kapatılıp kapatılmayacağını belirtmesine olanak tanıyan isteğe bağlı bir araçtır. Bu özellik kullanılırken oturumun geri kalanında gelecekteki tüm reklam isteklerine bir yayıncı gizlilik ayarı (PPT) parametresi eklenir.

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

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Yaklaşık konumu toplama

Google Mobile Ads SDK, reklamları cihaz konumuna göre hedeflemek için yaklaşık konumu toplayabilir. Kullanıcı uygulamanızda konum izni verirse Google Mobile Ads SDK yaklaşık konum bilgisini toplar.

Google Mobile Ads SDK 13.12.0 sürümünden itibaren yaklaşık konum toplama özelliği varsayılan olarak etkindir. coarseLocationCollectionEnabled özelliğini kullanarak yaklaşık konum verilerinin toplanmasını devre dışı bırakabilirsiniz.

Aşağıdaki örnekte yaklaşık konum verilerinin toplanması devre dışı bırakılmaktadır:

// Disables automatic coarse location collection by the SDK.
MobileAds.shared.requestConfiguration.coarseLocationCollectionEnabled = false
RequestConfigurationSnippets.swift

// Disables automatic coarse location collection by the SDK.
GADMobileAds.sharedInstance.requestConfiguration.coarseLocationCollectionEnabled = NO;
RequestConfigurationSnippets.m

GAMRequest

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

Ağ ekstraları ekleme

Ağ ekstraları, tek bir reklam kaynağına özgü olan ve reklam isteğiyle birlikte gönderilen ek ayrıntılardır.

Aşağıdaki kod snippet'i, Google'a bottom değerine sahip ek bir collapsible parametre anahtarı ayarlar:

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

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 adresinden içerik gösterirken reklam isteğinde bulunuyorsa alakalı anahtar kelimeleri hedeflemek için bu URL'yi iletebilirsiniz:

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

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 bir reklam isteğindeki anahtar/değer çiftleriyle özel hedefleme ayarlayın. Bu anahtar/değer çiftlerini hedefleyen satır öğeleri, bu reklam isteği için yayınlanabilir. Bir anahtar için birden fazla değeri hedeflemek istiyorsanız değerleri virgülle ayrılmış bir dize olarak girin.

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

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 mülkü 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ılmaları bakımı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'leri aşağıdaki gibi ileterek benzer içerik derecelendirmesine sahip reklamlar isteyebilirsiniz:

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

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

PPID, GAMRequest aracılığıyla ayarlanır:

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

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

Reklam isteklerinde kitle ve içerik verilerini yayıncı tarafından sağlanan sinyaller (PPS) olarak gönderebilirsiniz. PPS ile kullanıcı verilerinizi kullanarak kitle özelliklerinizi tüm işlem türlerinde teklif verenlere iletebilir, standart sınıflandırmaları kullanarak ve kullanıcı tanımlayıcılarını paylaşmanıza gerek kalmadan programatik para kazanma performansını artırabilirsiniz. Kitle özellikleriniz, davranış ve ilgi alanına dayalı verileri (IAB Kitle Sınıflandırması 1.1) ve içerik verisini (IAB İçerik Sınıflandırması 2.2) içerebilir.

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)

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 tekrar hedefleme için kullanılır. Yeni hedefleme ayarlamak için yeni bir GAMRequest nesnesiyle GAMBannerView üzerinde loadRequest yöntemini açıkça çağırın.

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

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