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é:

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:

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:

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

← Blog Čítať všetko →