Hedefleme


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

Ön koşullar

RequestConfiguration

RequestConfiguration, SetRequestConfiguration() global işlevi aracılığıyla dünya genelinde uygulanacak hedefleme bilgilerini toplayan bir yapıdır.

İstek yapılandırmasını güncellemek için önce mevcut yapılandırmayı alın, istediğiniz güncellemeleri yapın ve yapılandırmayı 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) uyarınca "çocuklara yönelik işlem için etiketleme" adlı bir ayar vardır. 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ılmasının Google Hesabınızın feshedilmesine yol açabileceğini kabul edersiniz.

Uygulama geliştirici olarak, reklam isteği gönderirken 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 söz konusu reklam isteğinde IAB ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli işlemleri yaparız.

Ayar, RequestConfiguration yapısının tag_for_child_directed_treatment üyesi aşağıdaki listelenen değerlerden birine atanarak yapılandırılabilir:

  • İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini belirtmek için RequestConfiguration::tag_for_child_directed_treatment değerini RequestConfiguration::kChildDirectedTreatmentTrue değerine 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 değerini RequestConfiguration::kChildDirectedTreatmentFalse olarak atayın.
  • Reklam isteklerinde içeriğinizin COPPA'ya göre nasıl değerlendirilmesini istediğinizi belirtmek istemiyorsanız RequestConfiguration::tag_for_child_directed_treatment değerini RequestConfiguration::kChildDirectedTreatmentUnspecified olarak atayın.

Aşağıdaki örnek, içeriğinizin COPPA'ya göre çocuklara yönelik olarak değerlendirilmesini istediğinizi gösterir:

  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 işlem yapmaya yetkili olduğunuzu onaylarsınız. Bu ayarın kötüye kullanılmasının Google Hesabınızın feshedilmesine yol açabileceğini kabul edersiniz.

Reklam isteklerinizi, Avrupa Ekonomik Alanı'nda (AEA) bulunan, reşit olmayan 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ükleriniz de olabilir. Lütfen Avrupa Birliği yönergelerini inceleyin ve kendi hukuk danışmanınıza başvurun. Google araçlarının, uyumluluğu kolaylaştırmak için tasarlandığını ve yayıncıları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 için etiket (TFUA) parametresi eklenir. Bu parametre, tüm reklam istekleri için yeniden pazarlama dahil olmak üzere 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.

Çocuklara yönelik ayarlar gibi, RequestConfiguration'da TFUA parametresini yapılandırmak için bir üye vardır: tag_for_under_age_of_consent. Bu üye, aşağıdaki listelenen 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 üzere RequestConfiguration::tag_for_under_age_of_consent değerini RequestConfiguration::kUnderAgeOfConsentTrue değerine atayın.
  • Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilmesini istemediğinizi belirtmek üzere RequestConfiguration::tag_for_under_age_of_consent değerini RequestConfiguration::kUnderAgeOfConsentFalse değerine atayın.
  • Reklam isteğinin, Avrupa Ekonomik Alanı'ndaki (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 değerini RequestConfiguration::kUnderAgeOfConsentUnspecified olarak atayın.

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

  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 Olmayan Kullanıcılar'ı etkinleştirecek 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, RequestConfiguration::max_ad_content_rating field aracılığıyla reklam istekleri için maksimum reklam içeriği derecelendirmesi belirleyebilir. Bu ayar yapılandırıldığında döndürülen AdMob reklamlarının içerik derecelendirmesi bu düzeyde veya bu düzeyin altındadır. Bunun için olası değerler, dijital içerik etiketi sınıflandırmalarına dayanır ve aşağıdaki listelenen 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 yüksek olmayan bir dijital içerik etiketi tanımına karşılık gelmesi gerektiğini belirtmek için bir RequestConfiguration yapısı 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 gönderilecek hedefleme bilgilerini toplar.

İçerik URL'si

Uygulamalar, reklam isteğinde bulunurken yayınladıkları 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'ten 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();