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 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ğerlendirme için etiketleme" adlı bir ayar bulunur. Bu etiketi ayarlayarak bu bildirimin doğru olduğunu ve uygulama sahibi adına işlem yapmaya yetkili olduğunuzu onaylıyorsunuz. Bu ayarın kötüye kullanımının Google Hesabınızın kapatılmasına neden olabileceğini anlıyorsunuz.

Uygulama geliştiricisi 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ğinde IBA ve yeniden pazarlama reklamlarını devre dışı bırakmak için gerekli adımları atarız.

Ayarı yapılandırmak için RequestConfiguration yapısının tag_for_child_directed_treatment üyesi aşağıdaki numaralandırılmış değerlerden birine atanabilir:

İç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 ayarlayı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 ayarlayın.

Aşağıdaki örnek, içeriğinizin COPPA kapsamında ç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 uygulama sahibi adına hareket etme yetkisine sahip olduğunuzu onaylarsınız. Bu ayarın kötüye kullanımının Google Hesabınızın feshedilmesine yol açabileceğini anlıyorsunuz.

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üklerinizin de olabileceğini unutmayın. 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 Olmayan 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 olarak değerlendirilme ayarlarında olduğu gibi, TFUA parametresini yapılandırmak için RequestConfiguration'da 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 parametresine 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 olarak ayarlayın.
Reklam isteğinin, Avrupa Ekonomik Alanı'nda (AEA) reşit olma yaşının altındaki kullanıcılara yönelik olarak değerlendirilip değerlendirilmeyeceğini belirtmediğinizi ifade etmek için RequestConfiguration::tag_for_under_age_of_consent değerini RequestConfiguration::kUnderAgeOfConsentUnspecified olarak atayın.

Aşağıdaki örnek, reklam isteklerinize TFUA'nın 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 olma yaşının altındaki kullanıcıları etkinleştiren etiketler aynı anda doğru 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 ayar yapılandırıldığında döndürülen AdMob reklamlarının içerik derecelendirmesi bu düzeyde veya daha düşüktür. Bu parametrenin olası değerleri, dijital içerik etiketi sınıflandırmalarına dayanı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ını 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 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 içeriğini 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();