Bu kılavuzda, bir reklam isteğine hedefleme bilgilerinin nasıl sağlanacağı açıklanmaktadır.
Reklam hedeflemeyi uygulamada görmek için Swift veya Objective-C ile iOS API Demo uygulamasını indirin.
Ön koşullar
Devam etmeden önce Google Mobile Ads SDK'ı kurun.
GADRequestConfiguration
GADRequestConfiguration
GADMobileAds
paylaşılan örneği aracılığıyla genel olarak uygulanacak hedefleme bilgilerini toplayan bir nesnedir. Bu bilgilere aşağıdaki kodla erişilebilir:
Swift
let requestConfiguration = MobileAds.shared.requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
Tüm reklam isteklerinin istek yapılandırması değişikliklerini uyguladığından emin olmak için Initialize Google Mobile Ads SDK yöntemini çağırmadan önce istek yapılandırmasını ayarlayın.
Yaş deneyini ayarlama
Çocuklar ve gençler ile ilgili geçerli gizlilikle ilgili yönetmeliklere uygunluğunuzu yönetmenize yardımcı olmak için Google Mobile Ads SDK, yaşa uygunluk ayarı sunar. Yaş işleme ayarı, Google Mobile Ads SDK'nın çocuklar veya gençler için belirli reklam sunma korumaları uygulayıp uygulamayacağını belirtmenize olanak tanır. Bu ayar kullanılırken Google Mobile Ads SDK, reklam isteklerine tfat parametresini ekler. Yasal ve düzenleyici yükümlülüklerinize göre kullanıcılarınız için uygun yaş ayarlarını belirlemek üzere hukuk danışmanınıza başvurun. Daha fazla bilgi için Bir uygulamadan gelen reklam isteğini yaş kısıtlamalı olarak değerlendirilmek üzere etiketleme başlıklı makaleyi inceleyin.
GADRequestConfiguration üzerinde ageRestrictedTreatment özelliğiyle yaşa göre değerlendirme ayarlayabilirsiniz.
Çocuklara yönelik olarak değerlendirme ayarını belirleme
Aşağıdaki örnekte, reklam isteklerinin çocuk yaştakilere yönelik olarak değerlendirilmesi gerektiği belirtilmektedir:
Swift
// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
Objective-C
// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentChild;
Gençlere yönelik olarak değerlendirme ayarlama
Aşağıdaki örnekte, reklam isteklerinin gençlere yönelik olarak değerlendirilmesi gerektiği belirtilmektedir:
Swift
// Indicates that ad requests should have teen age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen
Objective-C
// Indicates that ad requests should have teen age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentTeen;
Belirli bir yaş deneyi ayarlamayın
Aşağıdaki örnekte, reklam isteklerine belirli bir yaşa yönelik değerlendirme uygulanmaması gerektiği belirtilmektedir:
Swift
// Indicates that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified
Objective-C
// Indicates that ad requests should have unspecified age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentUnspecified;
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 karşılıkları gösterilmektedir:
TFCD
tagForChildDirectedTreatment |
Yaş deneyi |
|---|---|
tagForChildDirectedTreatment = true |
GADAgeRestrictedTreatmentChild |
tagForChildDirectedTreatment = false |
GADAgeRestrictedTreatmentUnspecified |
tagForChildDirectedTreatment için değer atanmadı |
GADAgeRestrictedTreatmentUnspecified |
| Eşdeğeri yok | GADAgeRestrictedTreatmentTeen |
TFUA
tagForUnderAgeOfConsent |
Yaş deneyi |
|---|---|
tagForUnderAgeOfConsent = true |
GADAgeRestrictedTreatmentChild |
tagForUnderAgeOfConsent = false |
GADAgeRestrictedTreatmentUnspecified |
tagForUnderAgeOfConsent için değer atanmadı |
GADAgeRestrictedTreatmentUnspecified |
| Eşdeğeri yok | GADAgeRestrictedTreatmentTeen |
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.
Çocuklara yönelik ayar
Çocukların Çevrimiçi Gizliliğini Koruma Yasası
(COPPA) kapsamında,
tagForChildDirectedTreatment adlı bir ayar bulunur.
Uygulama geliştiricisi olarak, reklam isteğinde bulunduğunuzda 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ğinde ilgi alanına dayalı reklamcılığı ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli adımları atar. Ayar seçenekleri şunlardır:
- İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtmek için
tagForChildDirectedTreatmentdeğerinitrueolarak ayarlayın. Bu, reklam tanımlayıcısı IDFA'nın iletilmesini engeller. - İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istemediğinizi belirtmek için
tagForChildDirectedTreatmentdeğerinifalseolarak ayarlayın. - İçeriğinizin COPPA'ya göre nasıl değerlendirilmesini istediğinizi belirtmek istemiyorsanız
tagForChildDirectedTreatmentseçeneğini ayarlamayın.
Aşağıdaki örnekte, içeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğiniz belirtilmektedir:
Swift
MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;
Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulama sahibi adına işlem yapmaya yetkili olduğunuzu onaylarsınız. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesine yol açabileceğini anlıyorsunuz.
Reşit olma yaşının altındaki kullanıcılar
Reklam isteklerinizi, Avrupa Ekonomik Alanı'nda (AEA) bulunan, reşit olma yaşının altındaki 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üklerinizin de olabileceğini unutmayın. Avrupa Birliği yönergelerini inceleyin ve kendi hukuk danışmanınıza başvurun. Google araçlarının, uygunluk sürecini kolaylaştırmak için tasarlandığını ve yayıncının hukuki yükümlülüklerini azaltmadığını lütfen 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ındakiler Etiketi (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, Google Mobile Ads SDK nesnesinde tagForUnderAgeOfConsent özelliği ayarlanarak ve true iletilerek Google Mobile Ads SDK'nın tüm sürümleriyle kullanılabilir.GADMobileAds.requestConfiguration
- Reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun şekilde işlenmesini istediğinizi belirtmek için
tagForUnderAgeOfConsentdeğerinitrueolarak ayarlayın. Bu işlem, reklam kimliği IDFA'nın iletilmesini de engeller. tagForUnderAgeOfConsentayarlanmadığında, reklam isteklerinin reşit olma yaşının altındaki kullanıcılara uygun şekilde işlenmesini istemediğiniz belirtilir.
Aşağıdaki örnek, reklam isteğinize TFUA'nın dahil edilmesini istediğinizi gösterir:
Swift
MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
Çocuklara yönelik olarak değerlendirme ayarını etkinleştiren etiketler ve tagForUnderAgeOfConsent aynı anda true olarak ayarlanmamalıdır.
Bu şekilde ayarlanırlarsa çocuklara yönelik olma ayarı öncelikli olur.
Reklam içeriğini filtreleme
Uygulamalar, maxAdContentRating özelliğini kullanarak tüm reklam istekleri için maksimum reklam içeriği derecelendirmesi ayarlayabilir.GADRequestConfiguration Bu ayar, oturumun geri kalanı için gelecekteki tüm reklam isteklerinde geçerlidir. Bu özelliğin olası değerleri, dijital içerik etiketi sınıflandırmalarına dayanır ve aşağıdaki sabitlerden biri olmalıdır:
GADMaxAdContentRatingGeneralGADMaxAdContentRatingParentalGuidanceGADMaxAdContentRatingTeenGADMaxAdContentRatingMatureAudience
Aşağıdaki kod, döndürülen reklam içeriğinin GADMaxAdContentRatingGeneral'dan daha yüksek olmayan bir dijital içerik etiketi atamasına karşılık gelmesi için tüm reklam isteklerini yapılandırır.
Swift
MobileAds.shared.requestConfiguration.maxAdContentRating =
GADMaxAdContentRating.general
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
Yayıncı Gizlilik Değerlendirmesi (Beta)
Publisher Privacy Treatment
(PPT) API, uygulamaların GADRequestConfiguration özelliğini kullanarak tüm reklam istekleri için reklam kişiselleştirmeyi devre dışı bırakıp bırakmayacağı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 işleme (PPT) parametresi eklenir.
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 devre dışı bırakır:
Swift
MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GADRequest
GADRequest nesnesi, bir reklam isteğiyle gönderilecek hedefleme bilgilerini toplar.
Ağ ekstraları ekleme
Ağ ekstraları, bir reklam isteğiyle gönderilen ve tek bir reklam kaynağına özgü ek ayrıntılardır.
Aşağıdaki kod snippet'i, Google'a collapsible değerine sahip bottom adlı ek bir parametre anahtarı ayarlar:
Swift
let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)
Objective-C
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 kaynağından içerik gösterirken reklam isteğinde bulunuyorsa alakalı anahtar kelimeleri hedeflemek için bu URL'yi iletebilirsiniz:
Swift
let request = Request()
request.contentURL = "https://www.example.com"
Objective-C
GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";
SSS
- Bir reklam otomatik olarak yenilendiğinde hangi hedefleme kullanılır?
- Reklam yenileme işleminde, daha önce belirtilen
GADRequestnesnesi tekrar hedefleme için kullanılır. Yeni hedefleme ayarlamak içinloadRequestişlevini yeni birGADRequestnesnesiyleGADBannerViewüzerinde açıkça çağırın. - Ek hedefleme parametrelerini uyumlulaştırma ağlarına nasıl iletirim?
- Hedeflemeyi uyumlulaştırma ağlarına nasıl göndereceğinizi öğrenmek için Uyumlulaştırma bölümüne bakın.