Jak číst řetězec souhlasu TCF: Praktický průvodce pro vývojáře

Co TC string vlastně je

IAB Transparency & Consent Framework vytváří jediný kompaktní token — TC string — který putuje s každým reklamním požadavkem a přesně sděluje dodavatelům, s čím uživatel souhlasil a s čím ne. Je zakódován v Base64-URL a zabalen na úrovni bitů, takže vypadá jako blábol (CPxy...AAA), ale kóduje přesný, auditovatelný záznam.

Segmenty

Úplný TC string je několik segmentů oddělených tečkou. První je jádrový řetězec; ostatní jsou volitelné:

Bitová pole jsou jádrem celé věci: bit N nastavený na 1 znamená souhlas pro účel N nebo dodavatele N. Účel 1 je “uchovávání/přístup k informacím na zařízení,” účely 3 a 4 pokrývají personalizovanou reklamu a tak dále.

Dekódování v praxi

Bity dekódujete ručně jen zřídka. Použijte knihovny dodané IAB nebo veřejný dekodér:

V JavaScriptu volání __tcfapi('getTCData', 2, cb) vrací již rozparsovaný objekt — tcData.purpose.consents a tcData.vendor.consents jsou mapy id → boolean. To je vaše pravda za běhu.

Chyby, které zabíjejí příjmy

Když personalizovaná poptávka tiše zmizí, obvykle za to může TC string:

Postup ladění

Reprodukujte uživatelův souhlas, získejte živý TC string z __tcfapi nebo reklamního požadavku, proveďte jej validátorem a porovnejte dekódované účely/dodavatele s tím, co vyžadují vaši partneři. Devětkrát z deseti je mezerou jediný bit dodavatele nebo chybějící účel 1.

Kam FlexyConsent zapadá

FlexyConsent generuje TC stringy platné podle specifikace s registrovaným ID CMP, udržuje je čerstvé, vystavuje dekódovaný stav pro ladění a hlásí, které účely a dodavatelé jsou ve vašem provozu skutečně udělovány — takže můžete vidět, ne hádat, kde souhlas (a příjmy) uniká.

Klíčové poznatky

← Blog Číst vše →