Cara Membaca Rentetan Persetujuan TCF: Panduan Lapangan Pembangun
Apa Sebenarnya TC String Itu
IAB Transparency & Consent Framework menghasilkan satu token padat tunggal — TC string — yang bergerak dengan setiap permintaan iklan dan memberitahu vendor dengan tepat apa yang pengguna telah dan tidak setuju. Ia dikodkan Base64-URL dan dibungkus pada peringkat bit, jadi ia kelihatan seperti karut (CPxy...AAA) tetapi mengekod rekod yang tepat dan boleh diaudit.
Segmen-segmen
Satu TC string penuh ialah beberapa segmen dipisahkan titik. Yang pertama ialah rentetan teras; yang lain adalah pilihan:
- Teras — ID CMP, versi CMP, cap masa persetujuan, versi polisi, dan yang penting medan bit persetujuan tujuan dan persetujuan vendor.
- Vendor didedahkan — vendor mana yang ditunjukkan kepada pengguna.
- Publisher TC — persetujuan khusus untuk anda, penerbit.
Medan bit adalah intinya: bit N ditetapkan kepada 1 bermakna persetujuan untuk tujuan N atau vendor N. Tujuan 1 ialah “simpan/akses maklumat pada peranti,” tujuan 3 dan 4 meliputi iklan diperibadikan, dan seterusnya.
Menyahkod Satu Dalam Amalan
Anda jarang menyahkod bit secara manual. Gunakan pustaka yang disediakan IAB atau penyahkod awam:
- Pisahkan pada
.dan nyahkod Base64-URL segmen teras. - Baca medan pengepala lebar tetap (version, created, lastUpdated, cmpId, cmpVersion).
- Telusuri medan bit tujuan dan vendor untuk melihat dengan tepat yang mana diberikan.
Dalam JavaScript panggilan __tcfapi('getTCData', 2, cb) mengembalikan objek yang sudah dihuraikan — tcData.purpose.consents dan tcData.vendor.consents ialah peta id → boolean. Itu kebenaran asas anda pada masa larian.
Ralat Yang Membunuh Hasil
Apabila permintaan diperibadikan hilang secara senyap, biasanya TC string sebabnya:
- Rentetan hilang — permintaan iklan tidak membawa
gdprApplies/TC string, jadi SSP patuh jatuh kepada tidak diperibadikan. - Vendor tidak bersetuju — bit ID vendor rakan permintaan anda ialah 0, jadi mereka tidak boleh membida dengan pemperibadian.
- Rentetan tamat tempoh atau basi — cap masa lama membuat platform hiliran tidak mempercayainya.
- ID CMP salah — ID CMP tidak berdaftar atau ujian menjadikan keseluruhan rentetan tidak sah.
Aliran Kerja Penyahpepijatan
Hasilkan semula persetujuan pengguna, ambil TC string langsung daripada __tcfapi atau permintaan iklan, jalankannya melalui pengesah, dan bandingkan tujuan/vendor yang dinyahkod dengan apa yang rakan anda perlukan. Sembilan daripada sepuluh kali jurangnya ialah satu bit vendor atau tujuan 1 yang hilang.
Di Mana FlexyConsent Sesuai
FlexyConsent menjana rentetan TC dengan ID CMP 317 yang diperakui dan menyerahkannya melalui __tcfapi, supaya anda boleh menyahkod rentetan semasa; laporannya menunjukkan keputusan mengikut sumber dan rantau.
Intipati Utama
- TC string ialah rekod boleh diaudit yang dibungkus bit bagi setiap pilihan persetujuan.
- Medan bit tujuan dan vendor menentukan sama ada rakan boleh menyajikan iklan diperibadikan.
- Kebanyakan penurunan hasil disebabkan rentetan hilang, vendor tidak bersetuju, atau ID CMP basi/tidak sah.
- Nyahkod rentetan langsung dengan
__tcfapidan sahkannya terhadap keperluan rakan semasa menyahpepijat.