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 nizove sa svojim certificiranim CMP ID-jem 317 i daje ih putem __tcfapi, pa možete dekodirati aktualni niz; njegova izvješća prikazuju odluke po izvoru i regiji.
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.