Hedefleme

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

Ön koşullar

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 öncelikle mevcut bir yapılandırmayı edinin, istediğiniz güncellemeleri yapın 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) kapsamında "çocuklara yönelik olarak değerlendirilme için etiket" adlı bir ayar vardır. 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, 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.

Bu ayar, RequestConfiguration struct'ın tag_for_child_directed_treatment üyesini aşağıdaki numaralandırılmış 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::tag_for_child_directed_treatment değerini RequestConfiguration::kChildDirectedTreatmentTrue adresine 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 öğesini RequestConfiguration::kChildDirectedTreatmentFalse adresine atayın.
  • Reklam isteklerinde içeriğinizin COPPA'ya göre nasıl ele alınmasını istediğinizi belirtmek istemiyorsanız RequestConfiguration::tag_for_child_directed_treatment özelliğini RequestConfiguration::kChildDirectedTreatmentUnspecified öğesine 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 etmeye yetkili 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.

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 yönergelerini inceleyin ve kendi yasal danışmanınıza başvurun. Google araçlarının, kanunlara ve kurallara uygunluğu kolaylaştırmak için tasarlandığını ve herhangi bir 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 reklam isteğine, 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 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ırmak için bir üye bulunur: tag_for_under_age_of_consent. Bu parametre aşağıdaki numaralandırılmış değerlerle yapılandırılabilir:

  • 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 için RequestConfiguration::tag_for_under_age_of_consent özelliğini RequestConfiguration::kUnderAgeOfConsentTrue adresine atayın.
  • Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilmemesini istiyorsanız RequestConfiguration::tag_for_under_age_of_consent özelliğini RequestConfiguration::kUnderAgeOfConsentFalse adresine atayın.
  • Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilip değerlendirilmeyeceğini belirtmediğinizi belirtmek üzere RequestConfiguration::tag_for_under_age_of_consent özelliğini RequestConfiguration::kUnderAgeOfConsentUnspecified adresine atayın.

Aşağıdaki örnek, reklam isteklerinize TFUA'nın dahil edilmesini istediğinizi belirtir:

  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" değerine ayarlanmamalıdır. Ayarlanmışsa çocuklara yönelik ayar öncelikli olur.

Reklam içeriği 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ırmada döndürülen AdMob reklamları, ilgili düzeyde veya daha düşük bir içerik derecelendirmesine sahiptir. 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 tanımlaması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, 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 kaynağından içerik gösterirken reklam istiyorsa alakalı anahtar kelimeleri hedeflemek için bu 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();