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 üzerinden genel olarak uygulanacak hedefleme bilgilerini toplayan bir yapıdır.

İstek yapılandırmasını güncellemek için önce mevcut bir yapılandırmayı alın, 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) için "çocuklara yönelik olarak değerlendirilme etiketi" adlı bir ayar vardır. Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulamanın sahibi adına işlem yapmaya 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.

Uygulama geliştirici 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 belirtirseniz bu reklam isteğinde IBA ve yeniden pazarlama reklamlarını devre dışı bırakırız.

Ayar, tag_for_child_directed_treatment değerindeki RequestConfiguration yapısının üyesini aşağıdaki numaralandırılmış değerlerden birine atayarak yapılandırılabilir:

  • İçeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğinizi belirtmek için RequestConfiguration::kChildDirectedTreatmentTrue öğesine RequestConfiguration::tag_for_child_directed_treatment atayın.
  • İçeriğinizin COPPA amaçlarına uygun şekilde çocuklara yönelik olarak değerlendirilmesini istemediğinizi belirtmek için RequestConfiguration::kChildDirectedTreatmentFalse öğesine RequestConfiguration::tag_for_child_directed_treatment atayın.
  • İçeriğinizin, reklam isteklerinde COPPA kapsamında nasıl ele alınmasını istediğinizi belirtmek için RequestConfiguration::tag_for_child_directed_treatment RequestConfiguration::kChildDirectedTreatmentUnspecified atamasını yapın.

Aşağıdaki örnek, içeriğinizin COPPA amaçlarına uygun şekilde ç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 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, uyumluluğu 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 Avrupa genelinde reşit olma yaşının altındaki kullanıcılara yönelik etiket (TFUA) parametresi reklam isteğine dahil edilir. 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 ayarlar gibi İstek Yapılandırması'nda da tag_for_under_age_of_consent adlı TFUA parametresini yapılandırmak için bir üye bulunur. Bu parametre aşağıdaki numaralandırılmış değerlerle yapılandırılabilir:

  • Reklam isteğinin, Avrupa Ekonomik Alanı'ndaki (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmesini istediğinizi belirtmek için RequestConfiguration::kUnderAgeOfConsentTrue öğesine RequestConfiguration::tag_for_under_age_of_consent atayın.
  • Reklam isteğinin, Avrupa Ekonomik Alanı'ndaki (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmemesini istediğinizi belirtmek için RequestConfiguration::kUnderAgeOfConsentFalse öğesini RequestConfiguration::tag_for_under_age_of_consent olarak atayın.
  • Reklam isteğinin, Avrupa Ekonomik Alanı'ndaki (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 öğesine RequestConfiguration::tag_for_under_age_of_consent atayın.

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

  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ştirecek etiketler aynı anda doğru olarak ayarlanmamalıdır. Bu şekilde ayarlanırsa çocuklara yönelik ayar öncelikli olur.

Reklam içeriği filtreleme

Uygulamalar, reklam istekleri için RequestConfiguration::max_ad_content_rating field üzerinden maksimum reklam içeriği derecelendirmesi ayarlayabilir. Bu yapılandırıldığında döndürülen AdMob reklamları, içerik düzeyinde 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 numaralandırılmış 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 atamasına karşılık gelmesi gerektiğini belirtecek 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 bulunduklarında, sundukları 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 sitesindeki içeriği 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();