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:
- Jezgra — CMP ID, verzija CMP-a, vremenske oznake privole, verzija politike i ključno bitna polja privola za svrhe i privola za dobavljače.
- Disclosed vendors — koji su dobavljači prikazani korisniku.
- Publisher TC — privole specifične za vas, izdavača.
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:
- Podijelite po
.i Base64-URL-dekodirajte jezgreni segment. - Pročitajte polja zaglavlja fiksne širine (version, created, lastUpdated, cmpId, cmpVersion).
- Prođite kroz bitna polja svrha i dobavljača da vidite točno koja su odobrena.
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:
- Nedostajući niz — oglasni zahtjev ne nosi nikakav
gdprApplies/TC string, pa usklađeni SSP-ovi padaju na nepersonalizirano. - Dobavljač bez privole — bit ID-a dobavljača vašeg demand partnera je 0, pa ne mogu licitirati s personalizacijom.
- Istekli ili ustajao niz — stara vremenska oznaka navodi nizvodne platforme da mu ne vjeruju.
- Pogrešan CMP ID — neregistrirani ili testni CMP ID poništava cijeli niz.
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
- TC string je bitno zapakiran, provjerljiv zapis svakog izbora privole.
- Bitna polja svrha i dobavljača odlučuju mogu li partneri posluživati personalizirane oglase.
- Većina padova prihoda vodi do nedostajućeg niza, dobavljača bez privole ili ustajalog/nevaljanog CMP ID-a.
- Dekodirajte uživo niz s
__tcfapii validirajte ga prema zahtjevima partnera tijekom otklanjanja pogrešaka.