- 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 di Ad Manager, AdSense, dan AdMob, berencana mendukung TCF v2.2 untuk pesan izin GDPR-nya pada awal November, sesuai dengan batas waktu IAB untuk penerapan CMP yang telah diperbarui menjadi 20 November 2023.
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.2, 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 masalah 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 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.
Error 1.1, 1.2, 1.3: Penting untuk memeriksa 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(Errors 2.1a, 2.1b, 2.0a, 2.0b, and 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 segera membalas fungsi AddEventListener. Jika CMP tidak langsung merespons, 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 menurunkan jumlah tayangan iklan yang hilang bagi penayang.
Spesifikasi IAB
Spesifikasi IAB yang berlaku: Spesifikasi AddEventListener IAB (di GitHub)
AddEventListener harus segera 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 string TC dihapus menggunakan RemoveEventListener.Pusat kebijakan
Pusat kebijakan akan 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. 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.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 akan 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 ini 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 ini 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 secara manual memanggil fungsi 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 untuk memastikan API mereka diterapkan dengan benar berdasarkan spesifikasi teknis TCF IAB. |
| 2.0a |
String TC tidak dapat diuraikan karena tidak dienkode dengan format base64. Contoh: |
CMP (atau penayang) hanya boleh mengirim data yang dienkode dengan format base64 dalam parameter gdpr_consent=. |
| 2.0b |
String TC tidak dapat diuraikan karena error decoding. Contoh: Menyertakan jumlah bit yang salah |
CMP harus memperbaiki error penerapan string TC. |
| 2.0c |
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 perlu mendapatkan kembali 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 didapatkan kembali
Izin harus didapatkan dari pengguna. Jika Anda mendapatkan izin dari pengguna lebih dari 13 bulan yang lalu atau menggunakan versi GVL yang belum mencantumkan Google, Anda harus mendapatkan kembali 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 mendapatkan kembali izin. Sejumlah kecil error ini diperkirakan dapat terjadi jika permintaan iklan dikirim dengan string TC yang sudah tidak berlaku sebelum CMP membatalkan dan mendapatkan kembali 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. | Dapatkan kembali izin menggunakan GVL versi terkini. |
Global scope dan Out-of-band
Masalah terkait Global scope dan Out-of-band (Ad Manager, AdMob, AdSense). Iklan tidak akan 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 untuk menghapus sinyal Out-of-band dari string TC. |
| 5.2 | String TC Global scope. | Minta CMP Anda untuk 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 dari versi terakhir yang dikenal oleh 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. | 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 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 format yang diharapkan (daftar int64 yang dipisahkan oleh ' . ') | CMP harus memperbaiki error penerapan string AC. |
