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.
Ön koşullar
Devam etmeden önce Google Mobile Ads SDK'ı 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:
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 Google Mobile Ads SDK ilk kullanıma hazırlamadan önce istek yapılandırmasını ayarlayın.
Yaş deneyini ayarlama
Google Mobile Ads SDK, çocuklarla ve gençlerle ilgili gizlilikle ilgili yönetmeliklere uymanıza yardımcı olmak için yaşa uygun işlem ayarı sunar. Yaş değerlendirmesi ayarı, Google Mobile Ads SDK'nın çocuklar, gençler veya belirtilmemiş bir yaş için belirli reklam sunma korumalarını uygulayıp uygulamayacağını belirtmenize olanak tanır.
GADRequestConfiguration üzerinde ageRestrictedTreatment özelliğiyle yaşa göre değerlendirme ayarlayabilirsiniz.
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
Gençlere yönelik veya belirtilmemiş yaş değerlendirmesini belirtmek için .child ayarını aşağıdakilerle değiştirin:
.teen.unspecified
Objective-C
// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentChild;
Gençlere yönelik veya belirtilmemiş yaş değerlendirmesini belirtmek için GADAgeRestrictedTreatmentChild ayarını aşağıdakiyle değiştirin:
GADAgeRestrictedTreatmentTeenGADAgeRestrictedTreatmentUnspecified
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 geçerli yaşa göre değerlendirme ayarını belirlemek üzere yasal danışmanınıza başvurun. Daha fazla bilgi için Bir uygulamadan gelen reklam isteğini yaş sınırına tabi işlem olarak 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 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.
AdMob Uyumlulaştırması ile yaşa göre değerlendirmeyi iletme
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ş sınırına tabi işlem 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:
| Uyumlulaştırma bağdaştırıcısı adı | Desteklenen minimum sürüm |
|---|---|
| AppLovin | 13.6.3.0 |
| BidMachine | 3.6.1.1 |
| Bigo | 5.2.1.0 |
| Chartboost | 9.12.0.1 |
| DTExchange (Fyber) | 8.4.7.1 |
| i-mobile | 2.3.4.7 |
| InMobi | 11.2.0.1 |
| IronSource | 9.4.1.0.1 |
| Liftoff Monetize (Vungle) | 7.7.2.1 |
| LY Ads (Line Ads) | 3.0.1.1 |
| maio | 2.2.1.2 |
| Meta (Facebook) | 6.21.1.1 |
| Mintegral | 8.1.3.1 |
| Moloco | 4.6.1.1 |
| MyTarget | 5.43.0.0 |
| Pangle | 7.9.1.1.1 |
| PubMatic | 5.1.0.1 |
| Verve | 3.8.1.1 |
Ç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, 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 aşağıdaki gibidir:
- İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtmek için
tagForChildDirectedTreatmentdeğerinitrueolarak 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
tagForChildDirectedTreatmentdeğerinifalseolarak ayarlayın. - İçeriğinizin COPPA'ya göre nasıl değerlendirilmesini istediğinizi belirtmek istemiyorsanız
tagForChildDirectedTreatmentdeğerini 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 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) uygunluğu 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ı, kanunlara ve kurallara uygunluğu kolaylaştırmak için tasarlanmıştır ve herhangi bir yayıncını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 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 özelliğini ayarlayıp true değerini ileterek Google Mobile Ads SDK uygulaması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
tagForUnderAgeOfConsentparametresinitrueolarak ayarlayın. Bu işlem, reklam kimliği IDFA'nın iletilmesini de engeller. tagForUnderAgeOfConsentayarlanmadığında, reklam isteklerinin reşit olmayan kullanıcılara uygun şekilde işlenmesini istemediğiniz anlaşılır.
Aşağıdaki örnek, reklam isteğinize TFUA'yı dahil etmek istediğinizi gösterir:
Swift
MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
Çocuklara yönelik ayarı ve tagForUnderAgeOfConsent etkinleştiren etiketler aynı anda true olarak ayarlanmamalıdır.
Bu şekilde ayarlanırlarsa çocuklara yönelik ayar öncelikli olur.
Reklam içeriğini filtreleme
Uygulamalar, GADRequestConfiguration
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:
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)
Yayıncı Gizlilik İşleme (PPT) API'si, uygulamaların GADRequestConfiguration'nin publisherPrivacyPersonalizationState özelliğini kullanarak tüm reklam istekleri için reklam kişiselleştirmeyi kapatıp kapatmayacağı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:
Swift
MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GADRequest
GADRequest nesnesi, reklam isteğiyle birlikte gönderilecek hedefleme bilgilerini toplar.
Ağ ekstraları ekleme
Ağ ekstraları, tek bir reklam kaynağına özel 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:
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 adresinden 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 yenilendiğinde, 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. - 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.