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 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

← Blog Baca Semua →