- TCF v2.1: Kami akan terus menyetujui string TCF v2.1, tetapi CMP sebaiknya mengikuti Panduan IAB tentang tonggak pencapaian penerapan saat industri beralih ke TCF v2.2.
- Solusi pengelolaan izin Google: Solusi pengelolaan izin Google, yang tersedia di tab Privasi & pesan AdMob, Ad Manager, dan AdSense, mendukung TCF v2.2 untuk pesan peraturan Eropa, sejalan dengan persyaratan IAB yang telah diperbarui untuk CMP.
Untuk membantu penayang mengelola error dan kesalahan konfigurasi yang terkait dengan peluncuran Transparency & Consent Framework v2.2 IAB Eropa, kami memberikan laporan error yang berhasil kami deteksi.
Dalam artikel ini, Anda akan menemukan informasi lebih lanjut tentang cara mengatasi error penerapan TCF v2.2, termasuk:
Panduan yang diperbarui
Info terbaru
- Pengingat tentang permintaan ulang izin setiap 13 bulan yang disyaratkan TCF:
Anda diwajibkan oleh kebijakan TCF IAB untuk mengingatkan pengguna tentang pilihan izin mereka minimal satu kali setiap 13 bulan (390 hari). Jika keputusan izin sudah lebih dari 13 bulan, Google tidak akan menganggap string TC valid dan tidak akan menayangkan iklan kepada pengguna tersebut. Sebaiknya diskusikan dengan CMP Anda untuk mengingatkan pengguna tentang pilihan izin mereka sebelum batas 13 bulan tercapai.
- Jenis error 3.2 telah dihilangkan. String TC yang diperbarui dalam 13 bulan terakhir akan tetap valid.
Perbaikan untuk error umum
Pecahkan beberapa masalah error paling umum di Ad Manager, AdSense, dan AdMob dengan melakukan tindakan berikut:
Pertimbangkan meminta ulang izin dari pengguna dengan string TC yang tidak akan dimonetisasi(Error 1.1, 3.1, 4.1, 5.1, 5.2, dan 6.1)
Error terkait
Panduan yang diperbarui
Pertimbangkan meminta izin ulang dari pengguna.
Alasan
Penayang akan mendapatkan manfaat dari permintaan ulang izin jika sebelumnya pernah menggunakan string out-of-band, string global scope, ID CMP yang tidak valid (dari pengujian), ID GVL yang tidak valid (dari pengujian), atau tidak menampilkan Google sebagai vendor dengan izin yang sesuai kapan saja selama penerapan mereka.
Error 1.1, 1.2, 1.3: Periksa apakah error memengaruhi volume traffic yang signifikan. Jika ya, pertimbangkan bahwa mungkin terdapat masalah pada sisi CMP dan pastikan bahwa Google telah diberi izin untuk tujuan yang diperlukan, serta sebagai vendor untuk izin DAN kepentingan yang sah (ID vendor 755).
Spesifikasi IAB
Sesuai spesifikasi IAB, CMP dapat men-cache string izin selama 13 bulan.
AddEventHandler
dalam 500 md(Error 2.1a, 2.1b, 2.0a, 2.0b, dan 2.0c)
Error terkait
Error 2.1a. Panduan ini juga dapat diterapkan pada error 2.1b, 2.0a, 2.0b, dan 2.0c.
Panduan yang diperbarui
Meskipun tidak lagi ada persyaratan waktu tunggu, sebaiknya CMP meninjau penerapan mereka dengan cermat untuk memastikan bahwa mereka langsung merespons panggilan ke AddEventListener getTCData
.
Jika CMP tidak merespons, permintaan mungkin tidak akan dimonetisasi.
Alasan
Google mematuhi spesifikasi IAB yang menyatakan bahwa CMP harus langsung membalas ke fungsi AddEventListener
. Jika CMP tidak langsung merespons, permintaan tersebut mungkin tidak akan dimonetisasi.
Selain itu, respons CMP adalah bagian dari rangkaian peristiwa yang memengaruhi kecepatan pembuatan permintaan iklan. Mengurangi waktu antara pemuatan halaman dan permintaan iklan akan menurunkan jumlah tayangan iklan yang hilang bagi penayang.
Spesifikasi IAB
Spesifikasi IAB yang berlaku: Spesifikasi AddEventListener IAB (di GitHub)
AddEventListener
harus langsung dipanggil setelah pendaftaran dengan data TC yang ada, meskipun status CMP adalah loading
dan CMP memiliki data TC yang tidak lengkap. Tindakan ini memungkinkan skrip panggilan mengakses listenerId
terdaftarnya. Selain itu, pada setiap perubahan string TC, callback harus dipanggil kecuali jika callback tersebut dihapus menggunakan RemoveEventListener
.Pusat kebijakan
Pusat kebijakan memberi tahu penayang jika aplikasi atau situs tidak mematuhi persyaratan pengelolaan izin Google.
Laporan error
Kami akan memberi tahu penayang di antarmuka pengguna produk jika kami mendeteksi masalah pada string TC yang terkait dengan satu atau beberapa situs atau aplikasi mereka. Di halaman “Izin pengguna Uni Eropa” di akun mereka, penayang yang memiliki error dapat mengklik Download laporan error TCF untuk mendownload laporan mendetail mengenai error yang terdeteksi selama 7 hari terakhir.
- Ad Manager: Klik Admin, lalu Izin pengguna Uni Eropa.
- AdMob dan AdSense: Klik Kontrol pemblokiran, lalu Izin pengguna Uni Eropa.
Laporan akan berisi informasi berikut tentang setiap error yang terdeteksi:
- Domain/MobileAppID: Situs atau aplikasi seluler yang salah dikonfigurasi.
- Jalur unit iklan: Unit iklan yang terkait dengan error.
- Kode error: Kode yang ditetapkan ke error.
- Jumlah error: Jumlah kueri yang berisi error yang diamati selama minggu sebelumnya.
- Tanggal terakhir terdeteksi: Tanggal terakhir error terdeteksi.
Penayang dapat menggunakan kode error yang tercantum dalam laporan untuk menemukan tindakan yang sebaiknya dilakukan dalam tabel pemecahan masalah berikut dan mengatasi error.
Pemecahan masalah
Untuk membantu penayang memperbaiki kesalahan konfigurasi integrasi TCF v2.2 IAB, kami telah menyusun tabel berikut yang berisi jenis error string TC yang paling umum serta rekomendasi pemecahan masalah yang sesuai.
Gunakan tabel tersebut untuk memahami masalah yang terjadi di tingkat permintaan iklan serta perilaku sistem terkait.
Skenario izin terbatas
Ketiga skenario ini selalu diprioritaskan daripada error kesalahan konfigurasi, meskipun permintaan tertentu memiliki beberapa error.
Skenario | Deskripsi | Tindakan yang disarankan |
---|---|---|
1.1 | Google, sebagai vendor, tidak diizinkan berdasarkan izin atau kepentingan yang sah. | Konfirmasi apakah pengguna sengaja menolak Google sebagai vendor, terjadi error penerapan CMP, atau ada pembatasan penayang. |
1.2 | Tidak ada izin untuk Tujuan 1 bagi negara EEA dan Inggris Raya. |
Konfirmasi apakah pengguna sengaja melarang Tujuan 1 atau apakah hal ini terjadi akibat error penerapan CMP. Penayang di Swiss harus memastikan mereka menetapkan kolom
PublisherCC dan PurposeOneTreatment dengan benar jika mereka tidak meminta izin kepada pengguna. Mulai Desember 2021, kami tidak akan lagi memeriksa perlakuan |
1.3 | Memiliki izin untuk Tujuan 1, tetapi tidak memiliki dasar hukum untuk Iklan Dasar. |
Konfirmasi apakah pengguna sengaja menolak kepentingan yang sah pada tujuan lain atau apakah hal ini terjadi akibat error penerapan CMP. |
Kesalahan konfigurasi
Permintaan iklan tidak akan diisi jika terjadi kesalahan konfigurasi.
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
2.1a | Tag atau SDK tidak menerima string TC karena CMP berstatus stub , loading , atau error . |
Jika Anda memanggil fungsi secara manual untuk meminta iklan, pastikan respons ke Jika Anda tidak secara manual memanggil fungsi untuk meminta iklan, bekerjasamalah dengan CMP Anda untuk memastikan bahwa mereka menerapkan dukungan untuk |
2.1b |
Kedua kondisi terpenuhi:
|
Minta CMP Anda memastikan API mereka diterapkan dengan benar berdasarkan spesifikasi teknis TCF IAB. |
2.2a |
String TC tidak dapat diuraikan karena tidak dienkode base64. Contoh: |
CMP (atau penayang) hanya boleh mengirim data yang dienkode base64 dalam parameter gdpr_consent= . |
2.2b |
String TC tidak dapat diuraikan karena error decoding. Contoh: Menyertakan jumlah bit yang salah |
CMP harus memperbaiki error penerapan string TC. |
2.2c |
String TC tidak dapat diuraikan karena error data. Contoh: Stempel waktu salah, ID vendor terlalu besar |
CMP harus memperbaiki error penerapan string TC. |
Masalah string TC
Masalah pada string TC yang terkait dengan permintaan iklan. Permintaan iklan akan gagal dan tidak terisi.
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
3.1 | ID CMP tidak valid. |
Pastikan CMP yang divalidasi IAB digunakan dan ID-nya ditetapkan dengan benar dalam string TC. Jika CMP valid saat string TC dibuat, tetapi kemudian dihapus oleh IAB, Anda harus meminta ulang izin dengan CMP yang valid. |
3.2 | Tidak digunakan lagi. | Tidak ada. Arti sebelumnya: Tanggal pembuatan string TC lebih dari 13 bulan yang lalu. |
Izin harus diminta ulang
Izin harus diminta dari pengguna. Jika Anda meminta izin dari pengguna lebih dari 13 bulan yang lalu atau menggunakan versi GVL yang belum mencantumkan Google, Anda harus meminta ulang izin pengguna. Jika tidak, permintaan iklan akan gagal dan tidak terisi.
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
3.3 | Tanggal pembaruan terakhir string TC lebih dari 13 bulan yang lalu. |
CMP harus menghapus string TC lama dan meminta ulang izin. Sejumlah kecil error ini diperkirakan dapat terjadi jika permintaan iklan dikirim dengan string TC yang sudah tidak berlaku sebelum CMP membatalkan dan meminta ulang izin pengguna. Jika Anda menggunakan solusi pengelolaan izin Google dan UMP SDK di aplikasi Anda, pastikan UMP SDK telah diterapkan dengan benar dan |
4.1 | String TC dibuat menggunakan versi GVL yang belum mencantumkan Google. | Minta ulang izin menggunakan GVL versi terkini. |
Global scope dan Out-of-band
Berikut masalah yang terkait dengan Global scope dan Out-of-band (Ad Manager, AdMob, AdSense). Iklan tidak dapat ditayangkan jika string TC menunjukkan "out-of-band" atau "global scope".
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
5.1 | String TC memperbolehkan izin out-of-band. | Minta CMP Anda menghapus sinyal out-of-band dari string TC. |
5.2 | String TC Global scope. | Minta CMP Anda memperbarui string TC menjadi "Service-specific". |
Jumlah penayangan iklan dibatasi
Jumlah iklan yang ditayangkan akan dibatasi.
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
6.1 | Versi string TC adalah 1 atau 1.1 (string v1.0). |
CMP harus mengirim string TCF v2.2. |
Masalah-masalah yang akan ditangani sendiri oleh Google
Saat masalah berikut terjadi, Google akan memitigasinya sendiri, jika diperlukan, dan menangani TCF secara normal.
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
7.1 | gdprApplies tidak ditentukan atau ditetapkan ke nilai yang tidak valid atau tidak terbaca, tetapi ada string TC yang valid. |
T/A |
7.2 | String TC dibuat dengan versi GVL yang lebih baru dibandingkan versi terakhir yang dikenali teknologi penayangan iklan Google. | T/A |
7.3 | Beberapa tujuan, fitur, dan/atau vendor berada di luar jangkauan (tidak diketahui). | T/A |
7.4 | String TC memiliki tcf_policy_version yang lebih lama daripada GVL terbaru. |
CMP harus menghapus string TC lama dan meminta ulang izin menggunakan GVL terbaru. |
7.5 |
Permintaan memiliki |
T/A |
7.6 | Kode negara penayang tidak valid, tetapi izin untuk Tujuan 1 ada. | CMP harus memperbaiki error penerapan string TC. |
7.7 | Kode bahasa tidak valid. | CMP harus memperbaiki error penerapan string TC. |
7.8 | Kolom versi string TC bukan 1 atau 2 . |
CMP harus memperbaiki error penerapan string TC dengan meminta izin baru jika string TC yang tidak valid terdeteksi. Jika Anda menggunakan solusi pengelolaan izin Google dan UMP SDK di aplikasi Anda, pastikan UMP SDK telah diterapkan dengan benar dan |
7.9 | Versi string AC bukan 1 atau 2 . |
CMP harus menetapkan versi string AC ke 1 atau 2 . |
Masalah string AC
Jika masalah ini terjadi, Google akan memperlakukan string Izin Tambahan (AC) sebagai tidak valid dan vendor tambahan tidak akan dipertimbangkan di luar string TC.
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
8.1 | String AC tidak menggunakan pemisah versi (~ ). |
CMP harus menggunakan "~ " sebagai karakter kedua pada string AC untuk memisahkan nomor versi dari daftar vendor yang diizinkan. |
8.2 | String AC berisi daftar vendor yang tidak mengikuti format yang diharapkan (daftar int64 yang dipisahkan ".") | CMP harus memperbaiki error penerapan string AC. |
Sertifikasi CMP
Jika masalah ini terjadi, Google akan mencoba menayangkan iklan yang tidak dipersonalisasi.
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
9.1 | CMP TCF yang ada dalam permintaan tidak disertifikasi oleh Google. | CMP harus disertifikasi oleh Google. |
Tidak ada sinyal TCF pada permintaan iklan
Jika masalah ini terjadi, Google akan mencoba menayangkan iklan terbatas.
Error | Deskripsi | Tindakan yang disarankan |
---|---|---|
10.1 |
Permintaan berasal dari EEA, Inggris Raya, atau Swiss, tetapi tidak memiliki sinyal TCF. |
Penayang harus terintegrasi dengan CMP TCF yang disertifikasi oleh Google. |