IAB Eropa telah menyelesaikan Transparency and Consent Framework v2.0 yang dikembangkan bersama IAB Tech Lab dan perusahaan lain yang terkait. Google sekarang sepenuhnya mendukung TCF v2.0.
Untuk memberikan waktu kepada penayang untuk mengelola error dan kesalahan konfigurasi yang terkait dengan peluncuran Transparency & Consent Framework v2.0 IAB Eropa, Google akan memberikan laporan error yang berhasil kami deteksi dan masa tenggang 150 hari kepada penayang untuk mengatasi error.
Dalam artikel ini, Anda akan menemukan informasi lebih lanjut tentang cara mengatasi error penerapan TCF v2.0, termasuk:
Panduan yang diperbarui
Info terbaru
- Pengingat tentang persyaratan TCF untuk mendapatkan kembali izin setiap 13 bulan:
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 error paling umum di Ad Manager, AdSense, dan AdMob dengan melakukan tindakan berikut:
Pertimbangkan untuk 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 untuk meminta ulang izin dari pengguna.
Alasan
Penayang akan mendapatkan manfaat dari permintaan ulang izin jika sebelumnya pernah menggunakan string cakupan luar, string cakupan global, 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.
Error 1.1, 1.2, 1.3: Penting untuk memeriksa apakah error ini berdampak pada 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.2a, 2.2b, dan 2.2c)
Error terkait
Error 2.1a. Panduan ini juga dapat diterapkan pada error 2.1b, 2.2a, 2.2b, dan 2.2c.
Panduan yang diperbarui
Meskipun tidak lagi ada persyaratan waktu tunggu, sebaiknya CMP meninjau implementasinya dengan cermat untuk memastikan segera merespons panggilan ke AddEventListener getTCData.
Jika CMP tidak merespons, permintaan mungkin tidak akan dimonetisasi.
Alasan
Google mematuhi spesifikasi IAB yang menyatakan bahwa CMP harus segera membalas fungsi AddEventListener. Jika CMP tidak merespons seketika, permintaan tersebut mungkin tidak akan dimonetisasi.
Selain itu, respons CMP adalah bagian dari rangkaian peristiwa yang mempengaruhi seberapa cepat permintaan iklan dapat dibuat. Mengurangi waktu antara pemuatan halaman dan permintaan iklan akan menghasilkan lebih sedikit tayangan yang hilang bagi penayang.
Spesifikasi IAB
Spesifikasi IAB yang berlaku: Spesifikasi AddEventListener IAB (di GitHub)
AddEventListener harus segera dipanggil setelah pendaftaran dengan data TC saat ini, 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 string TC dihapus menggunakan RemoveEventListener.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. Pada halaman “Izin pengguna Uni Eropa” di akun mereka, penayang yang memiliki error dapat mengklik Download laporan error TCF untuk mendownload laporan mendetail tentang error yang terdeteksi selama 7 hari terakhir.
- Ad Manager: Klik Admin
Izin pengguna Uni Eropa.
- AdMob dan AdSense: Klik Kontrol pemblokiran
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.0 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
Skenario 1.1 dan 1.3 selalu mengakibatkan permintaan iklan gagal dan tidak terisi. Skenario 1.2 tidak demikian. Ketiga skenario ini akan selalu diprioritaskan daripada error kesalahan konfigurasi, meskipun permintaan tertentu memiliki beberapa error.
| Skenario | Deskripsi | Tindakan yang disarankan untuk diambil |
|---|---|---|
| 1.1 | Google, sebagai vendor, tidak diizinkan berdasarkan izin atau kepentingan yang sah. Permintaan iklan akan gagal dan tidak terisi. | Konfirmasikan 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. |
Konfirmasikan apakah pengguna sengaja melarang Tujuan 1 atau apakah ini disebabkan error penerapan CMP. Penayang Jerman harus memastikan bahwa mereka menetapkan kolom
PublisherCC dan PurposeOneTreatment dengan benar jika tidak meminta izin kepada pengguna. |
| 1.3 | Memiliki izin untuk Tujuan 1, tetapi tidak memiliki dasar hukum untuk Iklan Dasar. Permintaan iklan akan gagal dan tidak terisi. |
Konfirmasikan apakah pengguna sengaja menolak kepentingan yang sah pada tujuan lain atau apakah ini disebabkan error penerapan CMP. |
Kesalahan konfigurasi
Permintaan iklan tidak akan diisi jika terjadi kesalahan konfigurasi.
| Error | Deskripsi | Tindakan yang disarankan untuk diambil |
|---|---|---|
| 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 memanggil fungsi secara manual untuk meminta iklan, bekerjasamalah dengan CMP Anda untuk memastikan bahwa mereka menerapkan dukungan untuk |
| 2.1b |
Kedua kondisi terpenuhi:
|
Minta CMP Anda untuk 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 untuk diambil |
|---|---|---|
| 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 namun kemudian dihapus oleh IAB, Anda perlu mendapatkan kembali izin menggunakan CMP yang valid. |
| 3.2 | Tidak digunakan lagi. | Arti sebelumnya: Tanggal pembuatan string TC lebih dari 13 bulan yang lalu. CMP harus menghapus string TC lama dan mendapatkan kembali izin. |
| 3.3 | Tanggal pembaruan terakhir string TC lebih dari 13 bulan yang lalu. | CMP harus menghapus string TC lama dan mendapatkan kembali izin. |
Izin harus didapatkan kembali
Izin harus didapatkan dari pengguna. Jika izin pengguna yang sebelumnya Anda miliki sudah lebih dari 13 bulan yang lalu atau sebelum Google bergabung dengan GVL, Anda harus mendapatkan kembali izin pengguna, jika tidak, permintaan iklan akan gagal dan tidak terisi.
| Error | Deskripsi | Tindakan yang disarankan |
|---|---|---|
| 4.1 | String TC dibuat menggunakan versi GVL yang belum mencantumkan Google. | Dapatkan kembali izin menggunakan GVL versi terbaru, yang sekarang menyertakan Google. |
Cakupan global & cakupan luar
Masalah terkait cakupan global dan cakupan luar (Ad Manager, AdMob, AdSense). Iklan tidak akan ditayangkan jika string TC menunjukkan “Cakupan luar” atau “Cakupan global”.
| Error | Deskripsi | Tindakan yang disarankan |
|---|---|---|
| 5.1 | String TC memungkinkan Izin cakupan luar. | Minta CMP Anda untuk menghapus Sinyal cakupan luar dari string TC. |
| 5.2 | String TC cakupan global. | Minta CMP Anda untuk memperbarui string TC agar bersifat spesifik per layanan. |
Iklan terus ditayangkan
Iklan yang dipersonalisasi dan iklan yang tidak dipersonalisasi akan terus ditayangkan menggunakan setelan yang ada tanpa memengaruhi monetisasi.
| Error | Deskripsi | Tindakan yang disarankan |
|---|---|---|
| 6.1 | Versi string TC adalah 1 atau 1.1 (string v1.0). |
CMP harus mengirim string TCF v2.0. |
Google akan menangani masalah
Saat masalah ini terjadi, Google akan memitigasinya sendiri, jika diperlukan, dan melanjutkan penanganan TCF 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 dari versi saat ini yang diketahui 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 mendapatkan kembali 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. | Hanya iklan terbatas yang akan ditayangkan. CMP harus memperbaiki error penerapan string TC. |
| 7.8 | Kolom versi string TC bukan 1 atau 2. |
Hanya iklan terbatas yang akan ditayangkan. CMP harus memperbaiki error penerapan string TC. |
| 7.9 | Versi string AC bukan 1. |
CMP harus menetapkan versi string AC ke 1. |
Masalah string AC
Jika masalah ini terjadi, Google akan memperlakukan string Izin Tambahan (AC) sebagai tidak valid dan vendor tambahan di luar string TC tidak akan dipertimbangkan.
| Error | Deskripsi | Tindakan yang disarankan |
|---|---|---|
| 8.1 | String AC tidak menggunakan pemisah versi (~). |
CMP harus menggunakan "~" sebagai karakter kedua dari string AC untuk memisahkan nomor versi dari daftar vendor yang diizinkan. |
| 8.2 | String AC berisi daftar vendor yang tidak mengikuti pemformatan yang diharapkan (daftar int64 yang dipisahkan oleh ' . ') | CMP harus memperbaiki error penerapan string AC. |