Kako čitati TCF niz privole: terenski vodič za programere

Što je TC string zapravo

IAB Transparency & Consent Framework proizvodi jedan kompaktan token — TC string — koji putuje sa svakim oglasnim zahtjevom i govori dobavljačima točno na što je korisnik pristao, a na što nije. Kodiran je u Base64-URL i zapakiran na razini bitova, pa izgleda kao besmislica (CPxy...AAA), ali kodira precizan, provjerljiv zapis.

Segmenti

Potpuni TC string sastoji se od nekoliko segmenata odvojenih točkom. Prvi je jezgreni niz; ostali su neobavezni:

Bitna polja su srž svega: bit N postavljen na 1 znači privolu za svrhu N ili dobavljača N. Svrha 1 je “pohrana/pristup informacijama na uređaju,” svrhe 3 i 4 pokrivaju personalizirane oglase i tako dalje.

Dekodiranje jednog u praksi

Rijetko dekodirate bitove ručno. Koristite biblioteke koje pruža IAB ili javni dekoder:

U JavaScriptu poziv __tcfapi('getTCData', 2, cb) vraća već raščlanjeni objekt — tcData.purpose.consents i tcData.vendor.consents su mape id → boolean. To je vaša temeljna istina tijekom izvođenja.

Pogreške koje ubijaju prihod

Kada personalizirana potražnja tiho nestane, TC string je obično razlog:

Tijek rada otklanjanja pogrešaka

Reproducirajte korisnikovu privolu, dohvatite uživo TC string iz __tcfapi ili oglasnog zahtjeva, propustite ga kroz validator i usporedite dekodirane svrhe/dobavljače s onim što vaši partneri zahtijevaju. Devet od deset puta jaz je jedan jedini bit dobavljača ili nedostajuća svrha 1.

Gdje se FlexyConsent uklapa

FlexyConsent generira TC stringove valjane prema specifikaciji s registriranim CMP ID-om, održava ih svježima, izlaže dekodirano stanje za otklanjanje pogrešaka i izvještava koje se svrhe i dobavljači zapravo odobravaju u vašem prometu — tako da možete vidjeti, a ne nagađati, gdje privola (i prihod) curi.

Ključni zaključci

← Blog Pročitaj sve →