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 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 şekilde 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" adı verilen bir ayar bulunmaktadır. Bu etiketi ayarlayarak, bu bildirimin doğru olduğunu ve uygulamanın sahibi adına işlem yapma yetkiniz olduğunu 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ğiyle ilişkili IBA ve yeniden pazarlama reklamlarını devre dışı bırakırız.

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

  • İçeriğinizin COPPA amaçlarına uygun şekilde ç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ı doğrultusunda ç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'ya göre nasıl ele alınmasını istediğinizi belirtmek için RequestConfiguration::kChildDirectedTreatmentUnspecified özelliğini RequestConfiguration::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 belirtmektedir:

  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'nin 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 özelliği kullanırken, reklam isteğine Avrupa'da reşit olma yaşının altındaki kullanıcılar için bir etiket (TFUA) 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 istekleri de devre dışı bırakı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 kullanılan bir üye bulunur: Bu, aşağıdaki numaralandırılmış değerlerle yapılandırılabilir:

  • Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) yer alan ve reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmesini istediğinizi belirtmek için RequestConfiguration::kUnderAgeOfConsentTrue alanına RequestConfiguration::tag_for_under_age_of_consent 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::kUnderAgeOfConsentFalse özelliğine RequestConfiguration::tag_for_under_age_of_consent atayın.
  • Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) yer alan ve reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilmesi gerekip gerekmediğini belirtmek amacıyla RequestConfiguration::kUnderAgeOfConsentUnspecified özelliğine RequestConfiguration::tag_for_under_age_of_consent atayın.

Aşağıdaki örnekte, reklam isteklerinize TFUA'nın 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 olma yaşının altındaki kullanıcıları etkinleştirecek etiketler aynı anda doğru değerine ayarlanmamalıdır. Bu şekilde ayarlanırlarsa ç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 belirleyebilir. Yapılandırılan döndürülen AdMob reklamları, bu 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 büyük olmayan bir dijital içerik etiketi gösterimine karşılık gelmesi gerektiğini belirtecek şekilde 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, sunuldukları içeriğin URL'sini iletebilir. Bu, anahtar kelime hedeflemesinin reklamı içerikle eşleştirmesini sağlar.

Örneğin, uygulamanız https://www.example.com kaynağından içerik gösterirken reklam isterse 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();