Penargetan

Panduan ini menjelaskan cara memberikan informasi penargetan untuk permintaan iklan.

Prasyarat

• Selesaikan Mulai.

RequestConfiguration

RequestConfiguration adalah struct yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui fungsi global SetRequestConfiguration().

Untuk mengupdate konfigurasi permintaan, dapatkan konfigurasi saat ini terlebih dahulu, lakukan update yang diinginkan, lalu tetapkan sebagai berikut:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Setelan yang ditujukan untuk anak-anak

Untuk mematuhi Children's Online Privacy Protection Act (COPPA), terdapat setelan yang disebut "tag perlakuan untuk anak-anak". Dengan menyetel tag ini, Anda menyatakan bahwa notifikasi ini akurat dan Anda berwenang untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat mengakibatkan penghentian Akun Google Anda.

Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin agar Google memperlakukan konten sebagai ditujukan untuk anak-anak atau tidak saat membuat permintaan iklan. Jika Anda menyatakan bahwa Anda ingin Google memperlakukan konten Anda sebagai konten yang ditujukan untuk anak-anak, kami akan mengambil langkah-langkah untuk menonaktifkan iklan PMM dan pemasaran ulang di permintaan iklan tersebut.

Setelan ini dapat dikonfigurasi dengan menetapkan anggota tag_for_child_directed_treatment dari struct RequestConfiguration ke salah satu nilai terenumerasi berikut:

• Tetapkan RequestConfiguration::tag_for_child_directed_treatment ke RequestConfiguration::kChildDirectedTreatmentTrue untuk menunjukkan bahwa Anda ingin konten diperlakukan sebagai ditujukan untuk anak-anak sesuai tujuan COPPA.
• Tetapkan RequestConfiguration::tag_for_child_directed_treatment ke RequestConfiguration::kChildDirectedTreatmentFalse untuk menunjukkan bahwa Anda tidak ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak sesuai COPPA.
• Tetapkan RequestConfiguration::tag_for_child_directed_treatment ke RequestConfiguration::kChildDirectedTreatmentUnspecified jika Anda tidak ingin menunjukkan bagaimana Anda ingin konten diperlakukan sehubungan dengan COPPA dalam permintaan iklan.

Contoh berikut menunjukkan bahwa Anda ingin konten diperlakukan sebagai ditujukan untuk anak-anak sesuai COPPA:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Dengan menyetel tag ini, Anda menyatakan bahwa notifikasi ini akurat dan Anda berwenang untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat menyebabkan penghentian akun Google Anda.

Catatan: Aplikasi di Program yang Didesain untuk Keluarga sebagai Aplikasi yang ditujukan terutama untuk anak-anak dan pengguna yang login ke Akun Google yang dikelola dengan Family Link secara otomatis memiliki semua konten yang diperlakukan sebagai ditujukan untuk anak-anak untuk semua permintaan iklan.

Pengguna di bawah usia dewasa

Anda dapat menandai permintaan iklan untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berusia di bawah usia dewasa. Fitur ini dirancang untuk membantu memfasilitasi kepatuhan terhadap General Data Protection Regulation (GDPR). Perlu diketahui bahwa Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Harap tinjau pedoman Uni Eropa dan konsultasikan dengan penasihat hukum Anda. Harap ingat bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak melepaskan kewajiban penayang tertentu berdasarkan hukum tersebut. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.

Saat menggunakan fitur ini, parameter Tag Untuk Pengguna yang berusia di bawah Usia Dewasa di Eropa (TFUA) akan disertakan dalam permintaan iklan. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk semua permintaan iklan. API ini juga menonaktifkan permintaan untuk vendor iklan pihak ketiga, seperti piksel pengukuran iklan dan server iklan pihak ketiga.

Seperti setelan yang ditujukan untuk anak-anak, ada anggota di RequestConfiguration untuk mengonfigurasi parameter TFUA: tag_for_under_age_of_consent, yang dapat dikonfigurasi dengan nilai terenumerasi berikut:

• Tetapkan RequestConfiguration::tag_for_under_age_of_consent ke RequestConfiguration::kUnderAgeOfConsentTrue untuk menunjukkan bahwa Anda ingin agar permintaan iklan menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa.
• Tetapkan RequestConfiguration::tag_for_under_age_of_consent ke RequestConfiguration::kUnderAgeOfConsentFalse untuk menunjukkan bahwa Anda ingin agar permintaan iklan tidak menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa.
• Tetapkan RequestConfiguration::tag_for_under_age_of_consent ke RequestConfiguration::kUnderAgeOfConsentUnspecified untuk menunjukkan bahwa Anda belum menentukan apakah permintaan iklan harus menerima perlakuan untuk pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa.

Contoh berikut menunjukkan bahwa Anda ingin TFUA disertakan dalam permintaan iklan:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Tag untuk mengaktifkan setelan Ditujukan untuk anak-anak dan Pengguna di bawah Usia Dewasa tidak boleh ditetapkan secara bersamaan ke true (benar). Jika ya, setelan yang ditujukan untuk anak-anak lebih diprioritaskan.

Pemfilteran konten iklan

Aplikasi dapat menetapkan rating konten iklan maksimum untuk permintaan iklan melalui RequestConfiguration::max_ad_content_rating field. Iklan AdMob yang ditampilkan jika konfigurasi ini memiliki rating konten pada atau di bawah tingkat tersebut. Nilai yang memungkinkan untuk hal ini didasarkan pada klasifikasi label konten digital dan harus berupa salah satu nilai yang disebutkan berikut:

• RequestConfiguration::kMaxAdContentRatingG
• RequestConfiguration::kMaxAdContentRatingPG
• RequestConfiguration::kMaxAdContentRatingT
• RequestConfiguration::kMaxAdContentRatingMA

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

Objek AdRequest mengumpulkan informasi penargetan untuk dikirim bersama permintaan iklan.

URL Konten

Saat meminta iklan, aplikasi dapat meneruskan URL konten yang ditampilkan. Hal ini memungkinkan penargetan kata kunci mencocokkan iklan dengan konten.

Misalnya, jika aplikasi Anda meminta iklan sambil menampilkan konten dari https://www.example.com, Anda dapat meneruskan URL ini untuk menargetkan kata kunci yang relevan:

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();