Hoe lees je een TCF-toestemmingsstring: een veldgids voor ontwikkelaars

Wat de TC string werkelijk is

Het IAB Transparency & Consent Framework produceert één compacte token — de TC string — die met elke advertentieaanvraag meereist en leveranciers precies vertelt waarmee een gebruiker wel en niet heeft ingestemd. Hij is Base64-URL-gecodeerd en op bitniveau verpakt, dus hij ziet eruit als wartaal (CPxy...AAA) maar codeert een precies, controleerbaar record.

De segmenten

Een volledige TC string bestaat uit meerdere door punten gescheiden segmenten. Het eerste is de core string; de andere zijn optioneel:

De bitvelden zijn de kern ervan: bit N ingesteld op 1 betekent toestemming voor doel N of leverancier N. Doel 1 is “informatie opslaan/openen op een apparaat,” doel 3 en 4 dekken gepersonaliseerde advertenties, enzovoort.

Er een decoderen in de praktijk

Je decodeert zelden bits met de hand. Gebruik de door IAB geleverde bibliotheken of een openbare decoder:

In JavaScript geeft de aanroep __tcfapi('getTCData', 2, cb) het reeds geparseerde object terug — tcData.purpose.consents en tcData.vendor.consents zijn maps van id → boolean. Dat is je grondwaarheid tijdens runtime.

De fouten die inkomsten doden

Wanneer gepersonaliseerde demand stilletjes verdwijnt, is de TC string meestal de reden:

Een debugging-workflow

Reproduceer de toestemming van de gebruiker, pak de live TC string uit __tcfapi of de advertentieaanvraag, haal hem door een validator en vergelijk de gedecodeerde doelen/leveranciers met wat je partners vereisen. Negen van de tien keer is de kloof één enkele leveranciersbit of een ontbrekend doel 1.

Waar FlexyConsent past

FlexyConsent genereert spec-geldige TC strings met een geregistreerde CMP-ID, houdt ze vers, stelt de gedecodeerde status beschikbaar voor debugging en rapporteert welke doelen en leveranciers daadwerkelijk worden verleend over je verkeer — zodat je kunt zien, niet gokken, waar toestemming (en inkomsten) lekt.

Belangrijkste punten

← Blog Alles lezen →