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 string TC dengan CMP ID 317 yang tersertifikasi dan memberikannya melalui __tcfapi, sehingga Anda dapat mendekode string yang aktif; laporannya menampilkan keputusan menurut sumber dan wilayah.
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.