Ako čítať reťazec súhlasu TCF: Praktický sprievodca pre vývojárov
Čo TC string vlastne je
IAB Transparency & Consent Framework vytvára jediný kompaktný token — TC string — ktorý putuje s každou reklamnou požiadavkou a presne hovorí dodávateľom, s čím používateľ súhlasil a s čím nie. Je zakódovaný v Base64-URL a zabalený na úrovni bitov, takže vyzerá ako blábol (CPxy...AAA), ale kóduje presný, auditovateľný záznam.
Segmenty
Úplný TC string je niekoľko segmentov oddelených bodkou. Prvý je jadrový reťazec; ostatné sú voliteľné:
- Jadro — ID CMP, verzia CMP, časové značky súhlasu, verzia zásad a kľúčové bitové polia súhlasov s účelmi a súhlasov s dodávateľmi.
- Zverejnení dodávatelia — ktorí dodávatelia boli používateľovi zobrazení.
- Publisher TC — súhlasy špecifické pre vás, vydavateľa.
Bitové polia sú jadrom celej veci: bit N nastavený na 1 znamená súhlas pre účel N alebo dodávateľa N. Účel 1 je “uchovávanie/prístup k informáciám na zariadení,” účely 3 a 4 pokrývajú personalizovanú reklamu a tak ďalej.
Dekódovanie v praxi
Bity dekódujete ručne len zriedka. Použite knižnice dodané IAB alebo verejný dekodér:
- Rozdeľte podľa
.a dekódujte jadrový segment z Base64-URL. - Prečítajte polia hlavičky s pevnou šírkou (version, created, lastUpdated, cmpId, cmpVersion).
- Prejdite bitové polia účelov a dodávateľov, aby ste videli presne, ktoré sú udelené.
V JavaScripte volanie __tcfapi('getTCData', 2, cb) vracia už rozparsovaný objekt — tcData.purpose.consents a tcData.vendor.consents sú mapy id → boolean. To je vaša pravda za behu.
Chyby, ktoré zabíjajú príjmy
Keď personalizovaný dopyt ticho zmizne, zvyčajne za to môže TC string:
- Chýbajúci reťazec — reklamná požiadavka nenesie žiadny
gdprApplies/TC string, takže vyhovujúce SSP klesnú na nepersonalizované. - Dodávateľ bez súhlasu — bit ID dodávateľa vášho partnera dopytu je 0, takže nemôže prihadzovať s personalizáciou.
- Expirovaný alebo zastaraný reťazec — stará časová značka spôsobí, že nadväzujúce platformy mu nedôverujú.
- Nesprávne ID CMP — neregistrované alebo testovacie ID CMP zneplatní celý reťazec.
Postup ladenia
Reprodukujte používateľov súhlas, získajte živý TC string z __tcfapi alebo reklamnej požiadavky, prejdite ho validátorom a porovnajte dekódované účely/dodávateľov s tým, čo vyžadujú vaši partneri. Deväťkrát z desiatich je medzerou jediný bit dodávateľa alebo chýbajúci účel 1.
Kam FlexyConsent zapadá
FlexyConsent generuje TC stringy platné podľa špecifikácie s registrovaným ID CMP, udržiava ich čerstvé, vystavuje dekódovaný stav pre ladenie a hlási, ktoré účely a dodávatelia sú vo vašej prevádzke skutočne udeľovaní — takže môžete vidieť, nie hádať, kde súhlas (a príjmy) uniká.
Kľúčové poznatky
- TC string je bitovo zabalený, auditovateľný záznam každej voľby súhlasu.
- Bitové polia účelov a dodávateľov rozhodujú, či partneri môžu poskytovať personalizovanú reklamu.
- Väčšina poklesov príjmov pochádza z chýbajúceho reťazca, dodávateľa bez súhlasu alebo zastaraného/neplatného ID CMP.
- Pri ladení dekódujte živý reťazec pomocou
__tcfapia validujte ho oproti požiadavkám partnerov.