Cara Membaca String Persetujuan TCF: Panduan Praktis untuk Pengembang
Apa Sebenarnya TC String Itu
IAB Transparency & Consent Framework menghasilkan satu token ringkas — TC string — yang menyertai setiap permintaan iklan dan memberi tahu vendor dengan tepat apa yang telah dan belum disetujui pengguna. Ia dikodekan dengan Base64-URL dan dikemas pada tingkat bit, jadi terlihat seperti omong kosong (CPxy...AAA) tetapi mengkodekan catatan yang tepat dan dapat diaudit.
Segmen-Segmennya
TC string lengkap terdiri dari beberapa segmen yang dipisahkan titik. Yang pertama adalah core string; yang lain bersifat opsional:
- Core — CMP ID, versi CMP, stempel waktu persetujuan, versi kebijakan, dan yang terpenting bitfield persetujuan tujuan dan persetujuan vendor.
- Disclosed vendors — vendor mana yang ditampilkan kepada pengguna.
- Publisher TC — persetujuan khusus untuk Anda, penerbit.
Bitfield adalah intinya: bit N yang diatur ke 1 berarti persetujuan untuk tujuan N atau vendor N. Tujuan 1 adalah “menyimpan/mengakses informasi pada perangkat”, tujuan 3 dan 4 mencakup iklan yang dipersonalisasi, dan seterusnya.
Mendekode Satu dalam Praktik
Anda jarang mendekode bit secara manual. Gunakan pustaka yang disediakan IAB atau dekoder publik:
- Pisahkan pada
.dan dekode Base64-URL pada segmen core. - Baca field header lebar tetap (version, created, lastUpdated, cmpId, cmpVersion).
- Telusuri bitfield tujuan dan vendor untuk melihat dengan tepat mana yang diberikan.
Di JavaScript, panggilan __tcfapi('getTCData', 2, cb) mengembalikan objek yang sudah diurai — tcData.purpose.consents dan tcData.vendor.consents adalah peta id → boolean. Itulah kebenaran dasar Anda saat runtime.
Kesalahan yang Membunuh Pendapatan
Ketika permintaan yang dipersonalisasi diam-diam menghilang, TC string biasanya adalah penyebabnya:
- String hilang — permintaan iklan tidak membawa
gdprApplies/TC string, sehingga SSP yang patuh turun ke non-personalisasi. - Vendor tidak disetujui — bit ID vendor mitra permintaan Anda adalah 0, sehingga mereka tidak dapat menawar dengan personalisasi.
- String kedaluwarsa atau usang — stempel waktu lama membuat platform hilir tidak memercayainya.
- CMP ID salah — CMP ID yang tidak terdaftar atau uji coba membatalkan seluruh string.
Alur Kerja Debugging
Reproduksi persetujuan pengguna, ambil TC string langsung dari __tcfapi atau permintaan iklan, jalankan melalui validator, dan bandingkan tujuan/vendor yang didekode dengan apa yang dibutuhkan mitra Anda. Sembilan dari sepuluh kali kesenjangannya adalah satu bit vendor atau tujuan 1 yang hilang.
Di Mana FlexyConsent Cocok
FlexyConsent menghasilkan TC string yang valid sesuai spesifikasi dengan CMP ID terdaftar, menjaganya tetap segar, mengekspos status yang didekode untuk debugging, dan melaporkan tujuan dan vendor mana yang benar-benar diberikan di seluruh lalu lintas Anda — sehingga Anda dapat melihat, bukan menebak, di mana persetujuan (dan pendapatan) bocor.
Poin-Poin Utama
- TC string adalah catatan yang dikemas dalam bit dan dapat diaudit dari setiap pilihan persetujuan.
- Bitfield tujuan dan vendor menentukan apakah mitra dapat menyajikan iklan yang dipersonalisasi.
- Sebagian besar penurunan pendapatan dapat dilacak ke string yang hilang, vendor yang tidak disetujui, atau CMP ID yang usang/tidak valid.
- Dekode string langsung dengan
__tcfapidan validasikan terhadap persyaratan mitra saat melakukan debugging.