- TCF v2.1: Kami akan terus menerima rentetan TCF v2.1 tetapi menggalakkan CMP mengikut panduan IAB tentang peristiwa penting pelaksanaan apabila industri beralih kepada TCF v2.2.
- Penyelesaian pengurusan persetujuan Google: Penyelesaian pengurusan persetujuan Google, tersedia dalam tab Privasi & pemesejan Ad Manager, AdSense dan AdMob, menyokong TCF v2.2 untuk mesej peraturan Eropah, sejajar dengan keperluan IAB yang dikemaskinikan untuk CMP.
Untuk membantu penerbit mengurus ralat dan salah konfigurasi yang berkaitan dengan pelancaran Rangka Kerja Ketelusan & Persetujuan v2.2 IAB Eropah, kami akan memberikan laporan ralat yang telah kami kesan.
Dalam artikel ini, anda akan menemukan maklumat lanjut tentang cara menangani ralat pelaksanaan TCF v2.2, termasuk:
Panduan yang dikemaskinikan
Kemaskinian
- Peringatan tentang keperluan TCF untuk mendapatkan semula persetujuan setiap 13 bulan:
You are required by IAB TCF policy to remind users about their consent choices at least once every 13 months. If the consent decision is more than 13 months old, the TC string will no longer be considered valid by Google and Google will not serve ads to that user. We suggest that you work with your CMP to remind users about their consent choices before the 13-month limit is reached.
- Jenis ralat 3.2 telah dibetulkan. Rentetan TC yang dikemaskinikan dalam masa 13 bulan lalu akan kekal sah.
Pembetulan ralat umum
Selesaikan masalah beberapa ralat umum merentas Ad Manager, AdSense dan AdMob dengan melakukan tindakan yang berikut:
Pertimbangkan permintaan semula persetujuan daripada pengguna dengan rentetan TC yang tidak akan diwangkan(Ralat 1.1, 3.1, 4.1, 5.1, 5.2 dan 6.1)
Ralat berkaitan
Panduan yang dikemaskinikan
Pertimbangkan permintaan semula persetujuan daripada pengguna.
Rasional
Penerbit akan menerima manfaat daripada permintaan semula persetujuan jika sebelum ini mereka telah menggunakan rentetan luar jalur dengan skop global, ID CMP yang tidak sah (daripada pengujian), ID GVL yang tidak sah (daripada pengujian) atau tidak mendapatkan Google sebagai vendor dengan persetujuan yang betul pada suatu ketika dalam pelaksanaan mereka.
Ralat 1.1, 1.2, 1.3: Anda perlu menyemak sama ada ralat ini mewakili volum trafik yang ketara. Jika ya, mungkin terdapat isu pada pihak CMP, oleh itu, pastikan Google diberikan persetujuan untuk tujuan yang diperlukan serta menjadi vendor untuk persetujuan DAN kepentingan sah (ID vendor 755).
Spesifikasi IAB
Mengikut spesifikasi IAB, CMP mungkin mengcache rentetan persetujuan selama 13 bulan.
AddEventHandler dalam masa 500ms(Ralat 2.1a, 2.1b, 2.0a, 2.0b dan 2.0c)
Ralat berkaitan
Ralat 2.1a. Panduan ini juga mungkin digunakan pada ralat 2.1b, 2.0a, 2.0b dan 2.0c.
Panduan yang dikemaskinikan
Walaupun tiada lagi keperluan tamat masa, kami mencadangkan agar CMP menyemak pelaksanaan mereka dengan teliti untuk memastikan mereka membalas panggilan dengan serta-merta kepada AddEventListener getTCData.
Jika CMP tidak membalas, permintaan mungkin tidak akan diwangkan.
Rasional
Google mematuhi spesifikasi IAB yang menyatakan bahawa CMP perlu membalas dengan segera kepada fungsi AddEventListener. Jika CMP tidak membalas dengan segera, maka permintaan tersebut mungkin tidak akan diwangkan.
Selain itu, respons CMP merupakan sebahagian daripada rantaian peristiwa yang mempengaruhi kepantasan permintaan iklan dapat dibuat. Pengurangan masa antara pemuatan halaman dan permintaan iklan akan mengurangkan tera yang hilang bagi penerbit.
Spesifikasi IAB
Spesifikasi IAB yang berkenaan: Spesifikasi AddEventListener IAB (di GitHub)
AddEventListener perlu dipanggil dengan serta-merta selepas pendaftaran dengan data TC semasa, walaupun status CMP ialah loading dan CMP mengandungi data TC yang tidak lengkap. Perkara ini membolehkan skrip panggilan mengakses listenerId yang didaftarkan. Selain itu, panggil balik perlu dipanggil pada setiap perubahan rentetan TC, melainkan panggil balik tersebut dialih keluar menggunakan RemoveEventListener.Pusat Dasar
Pusat dasar memaklumi penerbit jika terdapat apl atau laman yang tidak mematuhi keperluan pengurusan persetujuan Google.
Laporan ralat
Kami akan memaklumi penerbit dalam antara muka pengguna produk jika kami mengesan isu pada rentetan TC yang berkaitan dengan satu atau beberapa laman atau apl mereka. Pada halaman "Persetujuan pengguna EU" dalam akaun mereka, penerbit yang mempunyai ralat boleh mengklik Muat turun laporan ralat TCF untuk memuat turun laporan terperinci ralat yang telah dikesan sepanjang 7 hari lalu.
- Ad Manager: Klik Pentadbir, kemudian Persetujuan pengguna EU.
- AdMob dan AdSense: Klik Kawalan sekatan, kemudian Persetujuan pengguna EU.
Laporan ini akan mengandungi maklumat yang berikut tentang setiap satu ralat yang dikesan:
- Domain/MobileAppID: Laman atau apl mudah alih yang disalah konfigurasi.
- Laluan unit iklan: Unit iklan yang dikaitkan dengan ralat.
- Kod ralat: Kod yang ditetapkan pada ralat.
- Kiraan ralat: Bilangan pertanyaan yang mengandungi ralat yang diperhatikan sepanjang minggu sebelumnya.
- Tarikh terakhir dikesan: Tarikh terakhir ralat dikesan.
Penerbit boleh menggunakan kod ralat yang disenaraikan dalam laporan tersebut untuk menemukan cadangan tindakan yang perlu dilakukan dalam jadual penyelesaian masalah yang berikut dan menyelesaikan ralat.
Penyelesaian masalah
Untuk membantu penerbit membetulkan penyepaduan TCF v2.2 IAB yang disalah konfigurasi, kami telah menyediakan jadual berikut yang mengandungi jenis ralat rentetan TC yang paling biasa serta syor penyelesaian masalah yang sepadan.
Gunakan jadual untuk memahami isu yang berlaku pada peringkat permintaan iklan serta gelagat sistem yang sepadan.
Senario persetujuan terhad
Ketiga-tiga senario ini sentiasa mengatasi ralat salah konfigurasi, walaupun permintaan tertentu mengandungi berbilang ralat.
| Senario | Perihalan | Cadangan tindakan yang boleh diambil |
|---|---|---|
| 1.1 | Google tidak dibenarkan sebagai vendor di bawah persetujuan atau kepentingan sah. | Sahkan sama ada pengguna menolak Google sebagai vendor dengan sengaja, ralat pelaksanaan CMP telah berlaku atau terdapat pengehadan penerbit. |
| 1.2 | Tiada persetujuan untuk Tujuan 1 bagi negara EEA dan UK. |
Sahkan sama ada pengguna tidak membenarkan Tujuan 1 dengan sengaja atau perkara ini disebabkan oleh ralat pelaksanaan CMP. Penerbit di Switzerland perlu memastikan mereka menetapkan medan
PublisherCC dan PurposeOneTreatment dengan betul jika mereka tidak meminta persetujuan daripada pengguna. Mulai bulan Disember 2021, kami tidak lagi akan menyemak pengendalian |
| 1.3 | Mempunyai persetujuan untuk Tujuan 1, tetapi tiada asas undang-undang bagi Iklan Asas. |
Sahkan sama ada pengguna menolak kepentingan sah dengan sengaja bagi tujuan lain atau perkara ini disebabkan oleh ralat pelaksanaan CMP. |
Salah konfigurasi
Permintaan iklan tidak akan dipenuhi semasa ralat salah konfigurasi masih wujud.
| Ralat | Perihalan | Cadangan tindakan yang boleh diambil |
|---|---|---|
| 2.1a | Tag atau SDK tidak menerima rentetan TC disebabkan status CMP sebagai stub, loading atau error. |
Jika anda mengerahkan fungsi untuk meminta iklan secara manual, pastikan balasan kepada Jika anda tidak mengerahkan fungsi untuk meminta iklan secara manual, maka bekerjasama dengan CMP anda untuk memastikan mereka melaksanakan sokongan bagi |
| 2.1b |
Kedua-dua syarat dipenuhi:
|
Minta CMP anda untuk memastikan API dilaksanakan dengan betul berdasarkan spesifikasi teknikal TCF IAB. |
| 2.2a |
Rentetan TC tidak dapat dihuraikan kerana tidak dikodkan menggunakan base64. Contoh: |
CMP (atau penerbit) hanya patut menghantar data dikodkan base64 dalam parameter gdpr_consent=. |
| 2.2b |
Rentetan TC tidak dapat dihuraikan disebabkan oleh ralat penyahkodan. Contoh: Menyertakan bilangan bit yang salah |
CMP perlu membetulkan ralat pelaksanaan rentetan TC. |
| 2.2c |
Rentetan TC tidak dapat dihuraikan disebabkan oleh ralat data. Contoh: Cap masa salah, ID vendor terlalu besar |
CMP perlu membetulkan ralat pelaksanaan rentetan TC. |
Isu rentetan TC
Masalah dengan rentetan TC yang berkaitan dengan permintaan iklan. Permintaan iklan akan digugurkan dan tidak dipenuhi.
| Ralat | Perihalan | Cadangan tindakan yang boleh diambil |
|---|---|---|
| 3.1 | ID CMP tidak sah. |
Pastikan CMP yang disahkan oleh IAB digunakan dan ID CMP tersebut ditetapkan dengan betul dalam rentetan TC. Jika CMP sah semasa rentetan TC dijana tetapi dipadamkan kemudian oleh IAB, anda perlu mendapatkan semula persetujuan menggunakan CMP yang sah. |
| 3.2 | Tidak digunakan lagi. | Tiada. Makna terdahulu: Tarikh pembuatan rentetan TC adalah lebih daripada 13 bulan lalu. |
Persetujuan mestilah diperoleh semula
Persetujuan mestilah diperoleh daripada pengguna. Jika anda mendapatkan persetujuan daripada pengguna lebih 13 bulan lalu atau menggunakan versi GVL yang belum menyenaraikan Google, anda perlu mendapatkan semula persetujuan pengguna. Jika tidak, permintaan iklan akan digugurkan dan tidak dipenuhi.
| Ralat | Perihalan | Tindakan yang dicadangkan |
|---|---|---|
| 3.3 | Tarikh kemaskinian terakhir rentetan TC adalah lebih daripada 13 bulan lalu. |
CMP perlu memadamkan rentetan TC lama dan mendapatkan semula persetujuan. Sebilangan kecil ralat ini dijangka akan berlaku jika permintaan iklan dihantar dengan rentetan TC yang telah tamat tempoh sebelum CMP membatalkan dan mendapatkan semula persetujuan pengguna. Jika anda menggunakan penyelesaian pengurusan persetujuan Google, semak langkah menyelesaikan masalah bagi apl untuk menyelesaikan jenis ralat ini. Untuk penerbit AdSense yang menggunakan penyelesaian pengurusan persetujuan Google, tiada tindakan diperlukan untuk jenis ralat ini. |
| 4.1 | Rentetan TC dijana menggunakan versi GVL yang belum menyenaraikan Google. | Dapatkan semula persetujuan menggunakan versi semasa GVL. |
Skop global dan skop luar jalur
Masalah yang berikut berkaitan dengan skop global dan skop luar jalur (Ad Manager, AdMob, AdSense). Iklan tidak akan disiarkan jika rentetan TC menunjukkan "luar jalur" atau "skop global".
| Ralat | Perihalan | Tindakan yang dicadangkan |
|---|---|---|
| 5.1 | Rentetan TC membenarkan persetujuan luar jalur. | Arahkan CMP anda untuk mengalih keluar isyarat luar jalur daripada rentetan TC. |
| 5.2 | Rentetan TC skop global. | Arahkan CMP anda untuk mengemaskinikan rentetan TC supaya khusus perkhidmatan. |
Penyiaran iklan terhad
Iklan terhad akan disiarkan.
| Ralat | Perihalan | Tindakan yang dicadangkan |
|---|---|---|
| 6.1 | Versi rentetan TC ialah 1 atau 1.1 (rentetan v1.0). |
CMP perlu menghantar rentetan TCF v2.2. |
Google akan mengendalikan isu
Apabila isu ini berlaku, Google sendiri akan menyelesaikan masalah tersebut, apabila perlu dan meneruskan pengendalian TCF biasa.
| Ralat | Perihalan | Tindakan yang dicadangkan |
|---|---|---|
| 7.1 | gdprApplies tidak ditakrifkan atau ditetapkan kepada nilai yang tidak sah atau yang tidak dapat ditafsirkan, tetapi rentetan TC yang sah wujud. |
T/B |
| 7.2 | Rentetan TC dijana menggunakan versi GVL yang lebih baharu daripada versi semasa yang diketahui oleh teknologi penyiaran iklan Google. | T/B |
| 7.3 | Beberapa tujuan, ciri dan/atau vendor berada di luar julat (tidak diketahui). | T/B |
| 7.4 | Rentetan TC mengandungi tcf_policy_version yang lebih lama daripada GVL terbaharu. |
CMP perlu memadamkan rentetan TC lama dan mendapatkan semula persetujuan menggunakan GVL terbaharu. |
| 7.5 |
Permintaan mengandungi |
T/B |
| 7.6 | Kod negara penerbit tidak sah, tetapi persetujuan bagi Tujuan 1 wujud. | CMP perlu membetulkan ralat pelaksanaan rentetan TC. |
| 7.7 | Kod bahasa tidak sah. | CMP perlu membetulkan ralat pelaksanaan rentetan TC. |
| 7.8 | Medan versi rentetan TC bukan 1 atau 2. |
CMP perlu membetulkan ralat pelaksanaan rentetan TC dengan meminta persetujuan baharu jika rentetan TC yang tidak sah dikesan. Jika anda menggunakan penyelesaian pengurusan persetujuan Google, semak langkah menyelesaikan masalah bagi apl untuk menyelesaikan jenis ralat ini. Untuk penerbit AdSense yang menggunakan penyelesaian pengurusan persetujuan Google, tiada tindakan diperlukan untuk jenis ralat ini. |
| 7.9 | Versi rentetan AC bukan 1 atau 2. |
CMP hendaklah menetapkan versi rentetan AC kepada 1 atau 2. |
Isu rentetan AC
Apabila isu ini berlaku, Google akan mengendalikan rentetan Persetujuan Tambahan (AC) sebagai tidak sah dan vendor tambahan di luar rentetan TC tidak akan dipertimbangkan.
| Ralat | Perihalan | Tindakan yang dicadangkan |
|---|---|---|
| 8.1 | Rentetan AC tidak menggunakan pemisah versi (~). |
CMP hendaklah menggunakan "~" sebagai aksara kedua dalam rentetan AC untuk mengasingkan nombor versi daripada senarai vendor yang bersetuju. |
| 8.2 | Rentetan AC mengandungi senarai vendor yang tidak mengikut pemformatan yang dijangka (senarai int64s diasingkan oleh ".") | CMP perlu membetulkan ralat pelaksanaan rentetan AC. |
Pensijilan CMP
Apabila masalah ini berlaku, Google akan cuba untuk menyiarkan iklan tidak diperibadikan.
| Ralat | Perihalan | Tindakan yang dicadangkan |
|---|---|---|
| 9.1 | Kewujudan CMP TCF pada permintaan tidak diperakui oleh Google. | CMP harus mendapatkan perakuan Google. |
Tiada isyarat TCF pada permintaan iklan
Apabila masalah ini berlaku, Google akan cuba untuk menyiarkan iklan terhad.
| Ralat | Perihalan | Tindakan yang dicadangkan |
|---|---|---|
| 10.1 |
Permintaan dari EEA, UK atau Switzerland tetapi tiada isyarat TCF. |
Penerbit harus bersepadu dengan CMP TCF yang diperakui oleh Google. |
