Како читати TCF стринг сагласности: практични водич за програмере

Шта TC string заправо јесте

IAB Transparency & Consent Framework производи један компактан токен — TC string — који путује са сваким рекламним захтевом и говори добављачима тачно са чим се корисник сложио, а са чим не. Кодиран је у Base64-URL и упакован на нивоу битова, па изгледа као бесмислица (CPxy...AAA), али кодира прецизан, проверљив запис.

Сегменти

Пун TC string чини неколико сегмената раздвојених тачкама. Први је основни стринг (core string); остали су опциони:

Битска поља су срж тога: бит N постављен на 1 значи сагласност за сврху N или добављача N. Сврха 1 је “чување/приступ информацијама на уређају”, сврхе 3 и 4 покривају персонализоване рекламе и тако даље.

Декодирање у пракси

Ретко декодирате битове ручно. Користите библиотеке које обезбеђује IAB или јавни декодер:

У JavaScript-у, позив __tcfapi('getTCData', 2, cb) враћа већ парсиран објекат — tcData.purpose.consents и tcData.vendor.consents су мапе id → boolean. То је ваша основна истина у време извршавања.

Грешке које убијају приходе

Када персонализована потражња тихо нестане, TC string је обично разлог:

Радни ток дебаговања

Репродукујте сагласност корисника, узмите живи TC string из __tcfapi или рекламног захтева, провуците га кроз валидатор и упоредите декодиране сврхе/добављаче са оним што ваши партнери захтевају. Девет од десет пута јаз је један бит добављача или недостајућа сврха 1.

Где се FlexyConsent уклапа

FlexyConsent генерише TC низове са својим сертификованим CMP ID-јем 317 и даје их преко __tcfapi, па можете да декодирате актуелни низ; његови извештаји приказују одлуке по извору и региону.

Кључни закључци

← Blog Прочитај све →