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:

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:

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:

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

← Blog Baca Semua →