Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Targeting

Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan.

Prasyarat

Selesaikan Mulai.

`RequestConfiguration`

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

Untuk memperbarui konfigurasi permintaan, dapatkan konfigurasi saat ini terlebih dahulu, lakukan pembaruan yang diinginkan, dan 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 tujuan Children's Online Privacy Protection Act (COPPA), ada setelan yang disebut "beri tag untuk perlakuan untuk anak-anak". Dengan menetapkan tag ini, Anda menyatakan bahwa notifikasi ini akurat dan Anda diberi otorisasi untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat menyebabkan penghentian Akun Google Anda.

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

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

Tetapkan RequestConfiguration::tag_for_child_directed_treatment ke RequestConfiguration::kChildDirectedTreatmentTrue untuk menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk 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 untuk tujuan COPPA.
Tetapkan RequestConfiguration::tag_for_child_directed_treatment ke RequestConfiguration::kChildDirectedTreatmentUnspecifiedjika Anda tidak ingin menunjukkan perlakuan yang Anda inginkan terhadap konten Anda sehubungan dengan COPPA dalam panggilan iklan.

Contoh berikut menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai konten yang 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 menetapkan tag ini, Anda menyatakan bahwa pemberitahuan ini akurat dan Anda berwenang untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat menyebabkan penghentian Akun Google Anda.

Pengguna berusia di bawah usia dewasa

Anda dapat menandai permintaan iklan Anda untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang belum berusia 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 hubungi penasihat hukum Anda. Perlu diingat bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak menghilangkan kewajiban penayang mana pun berdasarkan hukum tersebut. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.

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

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 enumerasi berikut:

Tetapkan RequestConfiguration::tag_for_under_age_of_consent ke RequestConfiguration::kUnderAgeOfConsentTrue untuk menunjukkan bahwa Anda ingin panggilan iklan menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang belum berusia dewasa.
Tetapkan RequestConfiguration::tag_for_under_age_of_consent ke RequestConfiguration::kUnderAgeOfConsentFalse untuk menunjukkan bahwa Anda ingin panggilan iklan tidak menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berada di bawah usia dewasa.
Tetapkan RequestConfiguration::tag_for_under_age_of_consent ke RequestConfiguration::kUnderAgeOfConsentUnspecified untuk menunjukkan bahwa Anda belum menentukan apakah panggilan iklan harus menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang belum berusia 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 yang Berusia di Bawah Persyaratan Usia Dewasa tidak boleh ditetapkan secara bersamaan ke benar (true). Jika demikian, setelan yang ditujukan untuk anak-anak akan diprioritaskan.

Pemfilteran konten iklan

Aplikasi dapat menetapkan rating konten iklan maksimum untuk permintaan iklannya melalui RequestConfiguration::max_ad_content_rating field. Iklan AdMob yang ditampilkan saat ini dikonfigurasi memiliki rating konten pada atau di bawah tingkat tersebut. Nilai yang mungkin untuk hal ini didasarkan pada klasifikasi label konten digital dan harus berupa salah satu nilai enumerasi 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 yang 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 yang akan dikirim bersama permintaan iklan.

URL Konten

Ketika meminta iklan, aplikasi dapat meneruskan URL konten yang ditampilkan. Hal ini memungkinkan penargetan kata kunci agar sesuai dengan iklan beserta kontennya.

Misalnya, jika aplikasi Anda meminta iklan saat 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();