Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan.
Prasyarat
- Selesaikan Memulai.
RequestConfiguration
RequestConfiguration
adalah struct yang mengumpulkan informasi penargetan untuk
yang diterapkan secara global melalui fungsi global SetRequestConfiguration()
.
Untuk memperbarui konfigurasi permintaan, dapatkan konfigurasi saat ini terlebih dahulu, melakukan update yang diinginkan, dan menyetelnya 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 tujuan Children's Online Privacy Protection Act (COPPA), ada setelan yang disebut "tag perlakuan untuk anak-anak". Dengan menetapkannya, Anda menyatakan bahwa pemberitahuan 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 Google memperlakukan konten sebagai ditujukan untuk anak-anak saat Anda membuat permintaan iklan. Jika Anda mengindikasikan bahwa Anda ingin agar Google memperlakukan konten sebagai ditujukan untuk anak-anak, kami mengambil langkah PMM dan iklan pemasaran ulang di permintaan iklan tersebut.
Setelan ini dapat dikonfigurasi dengan menetapkan atribut
tag_for_child_directed_treatment
anggota dari RequestConfiguration
struct untuk
salah satu nilai yang dihitung berikut ini:
- Tetapkan
RequestConfiguration::tag_for_child_directed_treatment
keRequestConfiguration::kChildDirectedTreatmentTrue
untuk menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. - Tetapkan
RequestConfiguration::tag_for_child_directed_treatment
keRequestConfiguration::kChildDirectedTreatmentFalse
untuk menunjukkan bahwa Anda tidak ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. - Tetapkan
RequestConfiguration::tag_for_child_directed_treatment
keRequestConfiguration::kChildDirectedTreatmentUnspecified
jika Anda tidak ingin untuk menunjukkan bagaimana Anda ingin konten Anda diperlakukan sehubungan dengan COPPA dalam permintaan iklan.
Contoh berikut menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan 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 pemberitahuan ini akurat dan Anda berwenang untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat mengakibatkan penghentian Akun Google Anda.
Pengguna yang berusia di bawah usia dewasa
Anda dapat menandai permintaan iklan untuk menerima perlakuan bagi pengguna di Eropa Wilayah Ekonomi (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 Panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda. Harap diingat bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak menghilangkan kewajiban penayang tertentu berdasarkan hukum tersebut. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.
Saat menggunakan fitur ini, 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. Anda 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 mungkin
dikonfigurasi dengan nilai terenumerasi berikut:
- Tetapkan
RequestConfiguration::tag_for_under_age_of_consent
keRequestConfiguration::kUnderAgeOfConsentTrue
untuk menunjukkan bahwa Anda ingin permintaan iklan untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa. - Tetapkan
RequestConfiguration::tag_for_under_age_of_consent
keRequestConfiguration::kUnderAgeOfConsentFalse
untuk menunjukkan bahwa Anda ingin permintaan iklan untuk tidak menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa. - Tetapkan
RequestConfiguration::tag_for_under_age_of_consent
keRequestConfiguration::kUnderAgeOfConsentUnspecified
untuk menunjukkan bahwa Anda belum menentukan apakah permintaan iklan harus menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berusia 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 seharusnya tidak keduanya sekaligus diatur ke {i>true<i}. Jika ya, konten yang ditujukan untuk anak-anak setelan akan diprioritaskan.
Pemfilteran konten iklan
Aplikasi dapat menetapkan rating konten iklan maksimum untuk permintaan iklan mereka melalui
RequestConfiguration::max_ad_content_rating field
. Iklan AdMob ditampilkan saat
ini dikonfigurasi memiliki rating konten pada atau di bawah tingkat tersebut. Nilai
yang memungkinkan untuk ini didasarkan pada klasifikasi label konten digital dan harus
salah satu dari nilai yang dihitung berikut:
RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA
Kode berikut mengonfigurasi struct RequestConfiguration
untuk menentukan iklan tersebut
konten yang dikembalikan harus sesuai dengan penetapan label konten digital
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 iklan
permintaan.
URL Konten
Saat meminta iklan, aplikasi dapat meneruskan URL konten yang ditampilkan. Hal ini memungkinkan penargetan kata kunci agar sesuai dengan iklan beserta 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();