Bu sayfa, Cloud Translation API ile çevrilmiştir.

Hedefleme

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

Ön koşullar

Başlayın bölümünü tamamlayın.

`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ı edinin, 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) kapsamında "çocuklara yönelik olarak değerlendirilme için etiket" adlı bir ayar bulunmaktadır. Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulamanın sahibi adına işlem yapma yetkisine sahip olduğunuzu 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 bu reklam isteğindeki ilgi alanına dayalı reklamcılık ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli işlemleri yaparız.

Bu ayar, RequestConfiguration yapısının tag_for_child_directed_treatment üyesinin aşağıdaki numaralandırılmış değerlerden birine atanmasıyla yapılandırılabilir:

COPPA amaçları doğrultusunda içeriğinizin ç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 istemiyorsanız RequestConfiguration::kChildDirectedTreatmentUnspecified öğesine 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 belirtir:

  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 yapma yetkisine sahip olduğunuzu onaylamış olursunuz. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesine yol açabileceğini kabul edersiniz.

Reşit olma yaşının altındaki kullanıcılar

Reklam isteklerinizi, Avrupa Ekonomik Alanı'nda (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) 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ıların yasa kapsamındaki yükümlülüklerini ihlal etmediğini 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 dahil edilir. Bu parametre, yeniden pazarlama dahil olmak üzere kişiselleştirilmiş reklamcılığı tüm reklam istekleri için devre dışı bırakır. Ayrıca, reklam ölçüm pikselleri ve üçüncü taraf reklam sunucuları gibi üçüncü taraf reklam tedarikçilerine gönderilen istekleri de devre dışı bırakır.

Çocuklara yönelik ayarlarda olduğu gibi, RequestConfiguration'da TFUA parametresini yapılandıran bir üye vardır: 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) bulunan reşit olma yaşının altındaki kullanıcılar için değerlendirilmesini istediğinizi belirtmek üzere RequestConfiguration::kUnderAgeOfConsentTrue öğesine 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ılar için değerlendirilmemesini istediğinizi belirtmek üzere RequestConfiguration::kUnderAgeOfConsentFalse öğesine 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ılar için değerlendirilip değerlendirilmemesi gerektiğ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ö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ı etkinleştirecek etiketler ve Reşit Olma Yaşının altındaki kullanıcılar için aynı anda "doğru" olarak ayarlanmamalıdır. Bu durumda çocuklara yönelik ayar öncelikli olur.

Reklam içeriği filtreleme

Uygulamalar, RequestConfiguration::max_ad_content_rating field aracılığıyla reklam istekleri için maksimum reklam içeriği derecelendirmesi belirleyebilir. Bu yapılandırma yapılandırıldığında döndürülen AdMob reklamlarının içerik derecelendirmesi söz konusu düzeyde veya bu düzeyin altında olur. Bunun olası değerleri, dijital içerik etiketi sınıflandırmalarına bağlıdı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 daha yüksek olmayan bir dijital içerik etiketi tanımlamasına karşılık gelmesi gerektiğini belirtmek için bir RequestConfiguration struct'ı 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 reklam isteğiyle birlikte gönderilecek hedefleme bilgilerini toplar.

İç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 içeriklerini 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();