Bu kılavuzda, bir reklam isteğine nasıl hedefleme bilgilerinin sağlanacağı açıklanmaktadır.
Ön koşullar
- Başlarken bölümünü tamamlayın.
RequestConfiguration
RequestConfiguration
, SetRequestConfiguration()
global işlevi aracılığıyla global olarak uygulanacak hedefleme bilgilerini toplayan bir yapıdır.
İstek yapılandırmasını güncellemek için önce geçerli bir yapılandırmayı edinin, istediğiniz güncellemeleri gerçekleştirin ve aşağıdaki gibi ayarlayın:
firebase::gma::RequestConfiguration retrieved_configuration = firebase::gma::GetRequestConfiguration(); // .. apply your changes, then: firebase::gma::SetRequestConfiguration(request_configuration);
Çocuklara yönelik ayar
Çocukların Çevrimiçi Gizliliğini Koruma Yasası (COPPA) için "çocuklara yönelik olarak değerlendirilme etiketi" adlı bir ayar bulunur. Bu etiketi ayarlayarak, bu bildirimin doğru olduğunu ve uygulamanın sahibi adına hareket etme yetkisine sahip olduğunuzu onaylamış olursunuz. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesiyle sonuçlanabileceğini kabul edersiniz.
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 belirtirseniz bu reklam isteğinde IBA ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli işlemleri yaparız.
Ayar, RequestConfiguration
struct'ın tag_for_child_directed_treatment
üyesi aşağıdaki numaralanmış değerlerden birine atanarak yapılandırılabilir:
- İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtmek için
RequestConfiguration::kChildDirectedTreatmentTrue
öğesineRequestConfiguration::tag_for_child_directed_treatment
atayın. - İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istemediğinizi belirtmek için
RequestConfiguration::tag_for_child_directed_treatment
öğesiniRequestConfiguration::kChildDirectedTreatmentFalse
öğesine atayın. - Reklam isteklerinde içeriğinizin COPPA'ya göre nasıl ele alınmasını istediğinizi belirtmek istemiyorsanız
RequestConfiguration::kChildDirectedTreatmentUnspecified
öğesineRequestConfiguration::tag_for_child_directed_treatment
atayın.
Aşağıdaki örnek, içeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtir:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.tag_for_child_directed_treatment = firebase::RequestConfiguration::kChildDirectedTreatmentTrue; firebase::gma::SetRequestConfiguration(request_configuration);
Bu etiketi ayarlayarak, bu bildirimin doğru olduğunu ve uygulamanın sahibi adına hareket etme yetkisine sahip olduğunuzu onaylamış olursunuz. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesiyle sonuçlanabileceğ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ılara yönelik olarak değerlendirilmek üzere 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 olabileceğini unutmayın. Lütfen 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 herhangi bir yayıncının hukuki yükümlülüklerini ortadan kaldırmadığı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 reklam isteğine, Avrupa'da Reşit Olma Yaşının (TFUA) altındaki Kullanıcılar İçin Etiket (TFUA) parametresi eklenir. Bu parametre, yeniden pazarlama dahil olmak üzere tüm reklam istekleri 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 istekler de devre dışı bırakılır.
Çocuklara yönelik ayarlarda olduğu gibi, RequestConfiguration'da TFUA parametresini yapılandıran bir üye vardır: tag_for_under_age_of_consent
. Bu üye aşağıdaki numaralanmış değerlerle yapılandırılmış olabilir:
- Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilmesini istediğinizi belirtmek üzere
RequestConfiguration::tag_for_under_age_of_consent
özelliğiniRequestConfiguration::kUnderAgeOfConsentTrue
adresine atayın. - Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmemesini istediğinizi belirtmek için
RequestConfiguration::tag_for_under_age_of_consent
adresineRequestConfiguration::kUnderAgeOfConsentFalse
atayın. - Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmesi gerekip gerekmediğini belirtmediğinizi belirtmek için
RequestConfiguration::kUnderAgeOfConsentUnspecified
adresineRequestConfiguration::tag_for_under_age_of_consent
atayın.
Aşağıdaki örnek, reklam isteklerinize TFUA'nın dahil edilmesini istediğinizi gösterir:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.tag_for_under_age_of_consent = firebase::RequestConfiguration::kUnderAgeOfConsentTrue; firebase::gma::SetRequestConfiguration(request_configuration);
Çocuklara yönelik ayarını ve Reşit Olma Yaşının Altındaki Kullanıcılar'ı etkinleştiren etiketlerin her ikisi de aynı anda "doğru" olarak ayarlanmamalıdır. Bu şekilde olması durumunda çocuklara yönelik ayar öncelikli olur.
Reklam içeriğini filtreleme
Uygulamalar, reklam istekleri için maksimum reklam içeriği derecelendirmesi
RequestConfiguration::max_ad_content_rating field
aracılığıyla ayarlayabilir. Bu yapılandırıldığında döndürülen AdMob reklamlarının içerik derecelendirmesi, söz konusu düzeyde veya daha düşük olur. Bunun olası değerleri dijital içerik etiketi sınıflandırmalarını temel alır ve aşağıdaki numaralanmış değerlerden biri olmalıdır:
RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA
Aşağıdaki kod, döndürülen reklam içeriğinin G'den daha yüksek olmayan bir dijital içerik etiketi atamasına karşılık gelmesi gerektiğini belirtmek için bir RequestConfiguration
struct'ı yapılandırır:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.max_ad_content_rating = firebase::RequestConfiguration::kMaxAdContentRatingG; firebase::gma::SetRequestConfiguration(request_configuration);
AdRequest
AdRequest
nesnesi, bir reklam isteğiyle birlikte gönderilecek hedefleme bilgilerini toplar.
İçerik URL'si
Uygulamalar, reklam isteğinde bulunurken yayınladıkları 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çeriğini gösterirken reklam isteğinde bulunuyorsa alakalı anahtar kelimeleri hedeflemek için şu URL'yi iletebilirsiniz:
// AdRequest with content URL: firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com"); // AdRequest without content URL: firebase::admob::AdRequest ad_request();