Jak czytać ciąg zgody TCF: praktyczny przewodnik dla programistów

Czym właściwie jest TC string

IAB Transparency & Consent Framework tworzy pojedynczy zwarty token — TC string — który podróżuje z każdym żądaniem reklamowym i mówi dostawcom dokładnie, na co użytkownik wyraził, a na co nie wyraził zgody. Jest zakodowany w Base64-URL i upakowany na poziomie bitów, więc wygląda jak bełkot (CPxy...AAA), ale koduje precyzyjny, audytowalny zapis.

Segmenty

Pełny TC string składa się z kilku segmentów oddzielonych kropkami. Pierwszy to ciąg podstawowy (core string); pozostałe są opcjonalne:

Pola bitowe są sednem: bit N ustawiony na 1 oznacza zgodę na cel N lub dostawcę N. Cel 1 to “przechowywanie/dostęp do informacji na urządzeniu”, cele 3 i 4 obejmują reklamy spersonalizowane i tak dalej.

Dekodowanie w praktyce

Rzadko dekodujesz bity ręcznie. Użyj bibliotek dostarczanych przez IAB lub publicznego dekodera:

W JavaScript wywołanie __tcfapi('getTCData', 2, cb) zwraca już sparsowany obiekt — tcData.purpose.consents i tcData.vendor.consents to mapy id → wartość logiczna. To Twoja prawda u podstaw w czasie wykonywania.

Błędy, które zabijają przychody

Gdy spersonalizowany popyt po cichu znika, zwykle przyczyną jest TC string:

Proces debugowania

Odtwórz zgodę użytkownika, pobierz aktualny TC string z __tcfapi lub żądania reklamowego, przepuść go przez walidator i porównaj zdekodowane cele/dostawców z tym, czego wymagają Twoi partnerzy. Dziewięć razy na dziesięć luką jest pojedynczy bit dostawcy lub brakujący cel 1.

Gdzie pasuje FlexyConsent

FlexyConsent generuje zgodne ze specyfikacją TC stringi z zarejestrowanym CMP ID, utrzymuje je świeże, udostępnia zdekodowany stan do debugowania i raportuje, które cele i dostawcy są faktycznie udzielani w całym Twoim ruchu — dzięki czemu możesz zobaczyć, a nie zgadywać, gdzie wycieka zgoda (i przychody).

Kluczowe wnioski

← Blog Czytaj wszystko →