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 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ı (COPPA) uyarınca "çocuklara yönelik işlem için etiketleme" adlı bir ayar vardır. Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulama sahibi adına işlem yapmaya yetkili olduğunuzu onaylarsınız. Bu ayarın kötüye kullanılması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.

Ayar, RequestConfiguration yapısının tag_for_child_directed_treatment üyesi aşağıdaki listelenen değerlerden birine atanarak 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'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 işlem yapmaya yetkili olduğunuzu onaylarsınız. Bu ayarın kötüye kullanılması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) 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 dahil edilir. 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 ayarlar gibi, RequestConfiguration'da TFUA parametresini yapılandırmak için bir üye vardır: tag_for_under_age_of_consent. Bu üye, aşağıdaki listelenen değerlerle yapılandırılabilir:

Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilmesini istediğinizi belirtmek üzere RequestConfiguration::tag_for_under_age_of_consent değerini RequestConfiguration::kUnderAgeOfConsentTrue değerine atayın.
Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılar için değerlendirilmesini istemediğinizi belirtmek üzere RequestConfiguration::tag_for_under_age_of_consent değerini RequestConfiguration::kUnderAgeOfConsentFalse değerine atayın.
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 ö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 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ğini 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 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 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, reklam isteğiyle 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();