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 global olarak 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 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 olarak değerlendirilmek üzere etiketle" adlı bir ayar vardı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 feshedilmesine yol açabileceğ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 söz konusu reklam isteğinde IBA ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli adımları atarız.

Ayar, RequestConfiguration yapısının tag_for_child_directed_treatment ü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::tag_for_child_directed_treatment değerini RequestConfiguration::kChildDirectedTreatmentTrue olarak 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 ayarlayı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 örnekte, içeriğinizin COPPA amaçları doğrultusunda çocuklara yönelik olarak değerlendirilmesini istediğiniz belirtilmektedir:

  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 uygulama sahibi adına hareket etme yetkiniz olduğunu onaylamış olursunuz. Bu ayarın kötüye kullanılmasının Google Hesabınızın kapatılmasına neden olabileceğini kabul edersiniz.

Reklam isteklerinizi Avrupa Ekonomik Alanı'ndaki (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilecek şekilde işaretleyebilirsiniz. Bu özellik, Genel Veri Koruma Yönetmeliği'ne (GDPR) uymayı 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 ö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 istekleri de devre dışı bırakı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 üye, 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ılara yönelik olarak değerlendirilmesini istediğinizi belirtmek için RequestConfiguration::tag_for_under_age_of_consent değerini RequestConfiguration::kUnderAgeOfConsentTrue olarak 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ğerlendirilmesini istemediğinizi belirtmek için RequestConfiguration::tag_for_under_age_of_consent değerini RequestConfiguration::kUnderAgeOfConsentFalse olarak 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 göstermek üzere RequestConfiguration::tag_for_under_age_of_consent değerini RequestConfiguration::kUnderAgeOfConsentUnspecified olarak atayın.

Aşağıdaki örnek, reklam isteklerinize TFUA'yı dahil etmek 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 ayarını etkinleştiren 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, reklam istekleri için maksimum reklam içeriği derecelendirmesini RequestConfiguration::max_ad_content_rating field aracılığıyla ayarlayabilir. Bu ayar yapılandırıldığında döndürülen AdMob reklamları, bu düzeyde veya daha düşük bir içerik derecelendirmesine sahip olur. Bu parametrenin 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 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 birlikte gönderilecek hedefleme bilgilerini toplar.

İçerik URL'si

Uygulamalar, reklam isteğinde bulunurken sundukları 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 adresinden içerik gösterirken reklam isteğinde bulunuyorsa 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();