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 TC string sah spesifikasi dengan ID CMP berdaftar, mengekalkannya segar, mendedahkan keadaan dinyahkod untuk penyahpepijatan, dan melaporkan tujuan dan vendor mana yang sebenarnya diberikan merentas trafik anda — jadi anda boleh melihat, bukan meneka, di mana persetujuan (dan hasil) bocor.
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.