Targeting

Penargetan memungkinkan Anda memberikan informasi kontekstual dan audiens ke Google Mobile Ads SDK for React Native untuk menayangkan iklan yang relevan kepada pengguna.

Anda dapat mengonfigurasi penargetan pada tingkat berikut:

  • Konfigurasi panggilan iklan global: Terapkan setelan di semua panggilan iklan di aplikasi Anda, termasuk perlakuan usia anak-anak dan remaja, rating konten iklan maksimum, perlakuan privasi penayang, dan ID perangkat pengujian.
  • Penargetan per panggilan iklan: Sesuaikan setiap panggilan iklan menggunakan objek panggilan iklan, termasuk URL konten dan detail tambahan untuk jaringan.

Panduan ini menjelaskan cara memberikan informasi penargetan ke Google Mobile Ads SDK for React Native.

Prasyarat

Sebelum melanjutkan, siapkan Google Mobile Ads SDK for React Native.

Menetapkan konfigurasi permintaan

Objek RequestConfiguration mengumpulkan informasi penargetan yang diterapkan secara global ke setiap permintaan iklan.

Untuk menerapkan setelan penargetan dari panggilan iklan pertama, tetapkan properti requestConfiguration saat Anda memanggil metode initialize:

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.
});

Ganti TEST_DEVICE_HASHED_ID dengan ID perangkat pengujian yang di-hash. ID ini menentukan perangkat yang akan menerima iklan pengujian.

Untuk memperbarui setelan penargetan setelah Anda melakukan inisialisasi Google Mobile Ads SDK for React Native, panggil metode setRequestConfiguration. Metode setRequestConfiguration menggantikan konfigurasi yang ada dan berlaku pada panggilan iklan berikutnya.

Contoh berikut merevisi objek RequestConfiguration dengan setelan penargetan yang diperbarui dan menerapkan setelan tersebut ke panggilan iklan:

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

setRequestConfiguration(requestConfiguration);

Menetapkan perlakuan berdasarkan usia

Untuk membantu Anda mengelola kepatuhan terhadap peraturan privasi yang berlaku terkait anak-anak dan remaja, Google Mobile Ads SDK for React Native menyediakan setelan perlakuan usia. Setelan perlakuan usia memungkinkan Anda menunjukkan apakah Google Mobile Ads SDK for React Native harus menerapkan perlindungan penayangan iklan tertentu untuk anak-anak, remaja, atau usia yang tidak ditentukan.

Anda dapat menetapkan perlakuan berdasarkan usia dengan properti ageRestrictedTreatment di RequestConfiguration.

Contoh berikut menunjukkan bahwa panggilan iklan akan menerima perlakuan usia anak:

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

setRequestConfiguration(requestConfiguration);

Untuk menunjukkan perlakuan usia remaja atau usia yang tidak ditentukan, ganti setelan AgeRestrictedTreatment.CHILD dengan setelan berikut:

Jika Anda menggunakan setelan ini, Google Mobile Ads SDK for React Native akan menyertakan parameter tfat dalam panggilan iklan. Berkonsultasilah dengan penasihat hukum Anda untuk menentukan persyaratan usia yang berlaku bagi pengguna Anda sesuai kewajiban hukum dan peraturan yang berlaku untuk Anda. Untuk mengetahui informasi selengkapnya, lihat Memberi tag pada panggilan iklan dari aplikasi untuk perlakuan pembatasan usia.

Memfilter konten iklan

Rating konten iklan maksimum memungkinkan Anda mengontrol konten iklan yang ditampilkan kepada pengguna. Anda dapat menetapkan rating konten maksimum untuk membantu mematuhi kebijakan platform.

Anda dapat menetapkan rating konten iklan maksimum untuk panggilan iklan di aplikasi menggunakan properti maxAdContentRating pada objek RequestConfiguration. Setelah Anda mengonfigurasi setelan ini, iklan yang ditampilkan akan memiliki rating konten yang sama atau lebih rendah dari rating tersebut. Nilai yang mungkin untuk setelan ini didasarkan pada klasifikasi label konten digital, dan harus berupa salah satu konstanta berikut:

Contoh berikut mengonfigurasi objek RequestConfiguration untuk menentukan bahwa konten iklan yang ditampilkan harus sesuai dengan penetapan label konten digital yang tidak lebih tinggi dari konstanta G:

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

setRequestConfiguration(requestConfiguration);

Untuk mengetahui detailnya, lihat hal berikut:

Opsional: Menetapkan PPT API (Beta)

Publisher Privacy Treatment (PPT) API memungkinkan Anda menunjukkan apakah akan menonaktifkan personalisasi iklan untuk semua permintaan iklan menggunakan properti publisherPrivacyPersonalizationState pada objek RequestConfiguration. Saat Anda menggunakan fitur ini, Google Mobile Ads SDK for React Native akan menyertakan parameter perlakuan privasi penayang (PPT) di semua panggilan iklan selama sisa sesi.

Secara default, panggilan iklan ke Google menayangkan iklan yang dipersonalisasi. Contoh berikut menonaktifkan personalisasi iklan untuk semua permintaan iklan:

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

setRequestConfiguration(requestConfiguration);

Menetapkan objek AdRequest

Objek AdRequest mengumpulkan informasi penargetan yang dikirim dengan permintaan iklan.

Tidak seperti konfigurasi global yang ditetapkan dengan metode setRequestConfiguration, objek AdRequest diteruskan ke metode load dari class format iklan, misalnya, InterstitialAd.load untuk iklan interstisial atau BannerAd.load untuk iklan banner.

Menambahkan detail tambahan untuk jaringan

Untuk meneruskan parameter khusus jaringan ke Google Mobile Ads SDK for React Native, seperti parameter untuk iklan yang dapat diciutkan, gunakan properti extras.

Contoh berikut menetapkan kunci parameter tambahan collapsible dengan nilai bottom:

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

Memberikan URL konten

Untuk memberikan URL konten untuk iklan yang ditargetkan menurut konten dan keamanan merek, tambahkan properti contentUrl:

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

URL konten harus berisi maksimum 512 karakter.