Hur man läser en TCF-samtyckessträng: en fältguide för utvecklare

Vad TC-strängen faktiskt är

IAB Transparency & Consent Framework producerar en enda kompakt token — TC-strängen — som följer med varje annonsbegäran och berättar för leverantörer exakt vad en användare har och inte har samtyckt till. Den är Base64-URL-kodad och packad på bitnivå, så den ser ut som rappakalja (CPxy...AAA) men kodar en exakt, granskningsbar post.

Segmenten

En fullständig TC-sträng är flera punktseparerade segment. Det första är kärnsträngen; de andra är valfria:

Bitfälten är kärnan i det: bit N satt till 1 betyder samtycke för ändamål N eller leverantör N. Ändamål 1 är “lagra/få åtkomst till information på en enhet,” ändamål 3 och 4 täcker personaliserade annonser, och så vidare.

Att avkoda en i praktiken

Du avkodar sällan bitar för hand. Använd de IAB-tillhandahållna biblioteken eller en offentlig avkodare:

I JavaScript returnerar anropet __tcfapi('getTCData', 2, cb) det redan tolkade objektet — tcData.purpose.consents och tcData.vendor.consents är kartor över id → boolean. Det är din grundsanning vid körning.

Felen som dödar intäkter

När personaliserad efterfrågan tyst försvinner är TC-strängen vanligtvis orsaken:

Ett felsökningsflöde

Återskapa användarens samtycke, fånga den live TC-strängen från __tcfapi eller annonsbegäran, kör den genom en validerare och jämför de avkodade ändamålen/leverantörerna med vad dina partner kräver. Nio gånger av tio är luckan en enda leverantörsbit eller ett saknat ändamål 1.

Var FlexyConsent passar in

FlexyConsent genererar specifikationsgiltiga TC-strängar med ett registrerat CMP-ID, håller dem färska, exponerar det avkodade tillståndet för felsökning och rapporterar vilka ändamål och leverantörer som faktiskt beviljas över din trafik — så att du kan se, inte gissa, var samtycke (och intäkter) läcker.

Viktiga slutsatser

← Blogg Läs allt →