Hedefleme

Hedefleme, kullanıcılarınıza alakalı reklamlar sunmak için Google Mobile Ads SDK for React Native platformuna bağlam ve kitle bilgileri sağlamanıza olanak tanır.

Hedeflemeyi şu seviyelerde yapılandırabilirsiniz:

  • Genel istek yapılandırması: Çocuklara ve gençlere yönelik yaş değerlendirmeleri, maksimum reklam içeriği derecelendirmeleri, yayıncı gizlilik değerlendirmeleri ve test cihazı kimlikleri dahil olmak üzere uygulamanızdaki tüm reklam isteklerine ayarlar uygulayın.
  • İstek başına hedefleme: İçerik URL'leri ve ağ ekstraları dahil olmak üzere reklam isteği nesnelerini kullanarak tek tek reklam isteklerini özelleştirin.

Bu kılavuzda, Google Mobile Ads SDK for React Native için hedefleme bilgilerinin nasıl sağlanacağı açıklanmaktadır.

Ön koşullar

Devam etmeden önce Google Mobile Ads SDK for React Native uygulamasını kurun.

İstek yapılandırmasını ayarlama

RequestConfiguration nesnesi, her reklam isteğine genel olarak uygulanan hedefleme bilgilerini toplar.

İlk reklam isteğinizdeki hedefleme ayarlarını uygulamak için initialize yöntemini çağırırken requestConfiguration özelliğini ayarlayın:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

TEST_DEVICE_HASHED_ID yerine karma oluşturma işlemi uygulanmış bir test cihazı kimliği yazın. Bu kimlik, test reklamları alması gereken bir cihazı belirtir.

Google Mobile Ads SDK for React Native ilk kullanıma hazırlandıktan sonra hedefleme ayarlarınızı güncellemek için setRequestConfiguration yöntemini çağırın. setRequestConfiguration yöntemi, mevcut bir yapılandırmanın yerini alır ve sonraki reklam isteklerinde geçerli olur.

Aşağıdaki örnekte, güncellenmiş hedefleme ayarlarıyla bir RequestConfiguration nesnesi düzeltilmekte ve ayarlar reklam isteklerine uygulanmaktadır:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

Yaş değerlendirmesini ayarlama

Google Mobile Ads SDK for React Native, çocuklarla ve gençlerle ilgili gizlilik yönetmeliklerine uygunluğunuzu yönetmenize yardımcı olmak için yaşa uygun işlem ayarı sunar. Yaşa uygun içerik ayarı, Google Mobile Ads SDK for React Native platformunun çocuklar, gençler veya belirtilmemiş bir yaş için belirli reklam sunma korumaları uygulayıp uygulamayacağını belirtmenize olanak tanır.

Yaşa göre değerlendirme ayarını RequestConfiguration üzerindeki ageRestrictedTreatment özelliğiyle belirleyebilirsiniz.

Aşağıdaki örnekte, reklam isteklerinin çocuk yaştakilere yönelik olarak değerlendirilmesi gerektiği belirtilmektedir:

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

Gençlere yönelik veya belirtilmemiş yaş değerlendirmesini belirtmek için AgeRestrictedTreatment.CHILD ayarını aşağıdakiyle değiştirin:

Bu ayarı kullandığınızda Google Mobile Ads SDK for React Native, reklam isteklerine bir tfat parametresi ekler. Kullanıcılarınızın yaşa uygun içerik ayarlarını yasal ve düzenleyici şartlarınıza göre belirlemek için yasal danışmanınızla görüşün. Daha fazla bilgi için Bir uygulamadan gelen reklam isteğini yaş sınırına tabi işlem olarak etiketleme başlıklı makaleyi inceleyin.

Reklam içeriğini filtreleme

Maksimum reklam içeriği derecelendirmesi, kullanıcılarınıza gösterilen reklamların içeriğini kontrol etmenize olanak tanır. Platform politikalarına uygunluğu sağlamak için maksimum içerik derecelendirmesi belirleyebilirsiniz.

RequestConfiguration nesnesindeki maxAdContentRating özelliğini kullanarak uygulamanızdaki reklam istekleri için maksimum reklam içeriği derecelendirmesi ayarlayabilirsiniz. Bu ayarı yapılandırdıktan sonra, döndürülen reklamlar bu derecelendirmeye eşit veya daha düşük bir içerik derecelendirmesine sahip olur. Bu ayar için olası değerler, dijital içerik etiketi sınıflandırmalarını temel alır ve aşağıdaki sabitlerden biri olmalıdır:

Aşağıdaki örnekte, döndürülen reklam içeriğinin G sabitinden daha yüksek olmayan bir dijital içerik etiketi tanımına karşılık gelmesi gerektiğini belirtmek için bir RequestConfiguration nesnesi yapılandırılmaktadır:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

Ayrıntılı bilgi için aşağıdaki makaleleri inceleyin:

İsteğe bağlı: PPT API'yi ayarlama (Beta)

Yayıncı Gizlilik İşleme (PPT) API'si, RequestConfiguration nesnesindeki publisherPrivacyPersonalizationState özelliğini kullanarak tüm reklam istekleri için reklam kişiselleştirmenin devre dışı bırakılıp bırakılmayacağını belirtmenize olanak tanır. Bu özelliği kullandığınızda Google Mobile Ads SDK for React Native, oturumun geri kalanında tüm reklam isteklerine bir yayıncı gizlilik işlemi (PPT) parametresi ekler.

Varsayılan olarak, Google'a gönderilen reklam istekleri sonucunda kişiselleştirilmiş reklamlar yayınlanır. Aşağıdaki örnekte, tüm reklam istekleri için reklam kişiselleştirme devre dışı bırakılmaktadır:

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

AdRequest nesnesini ayarlama

AdRequest nesnesi, reklam isteğiyle gönderilen hedefleme bilgilerini toplar.

setRequestConfiguration yöntemiyle ayarlanan genel yapılandırmanın aksine AdRequest nesnesi, bir reklam biçimi sınıfının load yöntemine iletilir. Örneğin, geçiş reklamları için InterstitialAd.load veya banner reklamlar için BannerAd.load.

Ağ ekstraları ekleme

Daraltılabilir reklamlar için parametreler gibi ağa özgü parametreleri Google Mobile Ads SDK for React Native hizmetine iletmek için extras özelliğini kullanın.

Aşağıdaki örnekte, bottom değerine sahip ek bir collapsible parametre anahtarı ayarlanmaktadır:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

İçerik URL'si sağlama

İçerik hedefli reklamlar ve marka güvenliği için içerik URL'si sağlamak üzere contentUrl özelliğini ekleyin:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

İçerik URL'si en fazla 512 karakter olmalıdır.