Hedefleme


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

Ön koşullar

RequestConfiguration

RequestConfiguration, dahil edilecek hedefleme bilgilerini toplayan bir yapıdır SetRequestConfiguration() genel işlevi aracılığıyla genel olarak uygulanı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ı'nın amaçları doğrultusunda (COPPA), "çocuklara yönelik olarak değerlendirilme için etiketle" adlı bir ayar vardır. Bunu ayarlayarak etiketini kullandığınızda, bu bildirimin doğru olduğunu ve uygulamanın sahibi adına hareket etme. Bu ayarın kötüye kullanılabileceğinin farkındasınız Google Hesabınızın kapatılmasına neden olabilir.

Uygulama geliştirici olarak, uygulamanızın veya oyununuzun Google tarafından bir reklam isteği yaptığınızda, içeriğin çocuklara yönelik olarak belirtilmesi. Proje yönetiminin içeriğinizi çocuklara yönelik olarak değerlendirmesini istiyorsanız ilgi alanına dayalı reklamcılık ve yeniden pazarlama reklamları oluşturabilirsiniz.

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 değerine atayın.
  • RequestConfiguration::tag_for_child_directed_treatment adlı kişiyi şu kullanıcıya ata: istemiyorsanız RequestConfiguration::kChildDirectedTreatmentUnspecified içeriğinizin COPPA'ya göre nasıl ele alınmasını istediğinizi reklam istekleri.

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 hareket etme yetkisine sahip olmalıdır. Kötüye kullanımın, Google Hesabınızın kapatılmasına neden olabilir.

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 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 ayarlarda olduğu gibi, RequestConfiguration'da tag_for_under_age_of_consent TFUA parametresini yapılandırıyoruz. Bu parametre aşağıdaki numaralandırılmış değerlerle yapılandırıldı:

  • RequestConfiguration::tag_for_under_age_of_consent adlı kişiyi şu kullanıcıya ata: Şunları istediğinizi belirtmek için RequestConfiguration::kUnderAgeOfConsentTrue Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara yönelik olarak değerlendirilmek için reklam isteği reşit olma yaşının altındaki kullanıcılara.
  • RequestConfiguration::tag_for_under_age_of_consent adlı kişiyi şu kullanıcıya ata: Şunları istediğinizi belirtmek için RequestConfiguration::kUnderAgeOfConsentFalse Avrupa Ekonomik Alanı'ndaki kullanıcılar için değerlendirme yapılmamasını belirten reklam isteği (AEA) reşit olma yaşının altında olduğundan emin olun.
  • 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 örnek, TFUA'nın reklam isteklerinize dahil edilmesini 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 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ği filtreleme

Uygulamalar, reklam istekleri için maksimum reklam içeriği derecelendirmesi RequestConfiguration::max_ad_content_rating field 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, bir reklamla birlikte gönderilecek hedefleme bilgilerini toplar isteği gönderin.

İçerik URL'si

Uygulamalar, reklam isterken, 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, 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();