Як чытаць радок згоды TCF: палявое кіраўніцтва для распрацоўшчыкаў
Што такое TC string на самай справе
IAB Transparency & Consent Framework стварае адзін кампактны токен — TC string — які падарожнічае з кожным рэкламным запытам і паведамляе пастаўшчыкам дакладна, на што карыстальнік пагадзіўся, а на што не. Ён закадзіраваны ў Base64-URL і ўпакаваны на ўзроўні бітаў, таму выглядае як бязглуздзіца (CPxy...AAA), але кадзіруе дакладны запіс, які можна праверыць.
Сегменты
Поўны TC string складаецца з некалькіх сегментаў, падзеленых кропкамі. Першы — асноўны радок; астатнія неабавязковыя:
- Асноўны — ідэнтыфікатар CMP, версія CMP, часавыя пазнакі згоды, версія палітыкі і, што важна, бітавыя палі згод на мэты і згод на пастаўшчыкоў.
- Disclosed vendors — якія пастаўшчыкі былі паказаны карыстальніку.
- Publisher TC — згоды, спецыфічныя для вас, выдаўца.
Бітавыя палі — сэрца ўсяго: біт N, усталяваны ў 1, азначае згоду на мэту N або пастаўшчыка N. Мэта 1 — гэта “захоўванне/доступ да інфармацыі на прыладзе,” мэты 3 і 4 ахопліваюць пэрсаналізаваную рэкламу і гэтак далей.
Дэкадзіраванне аднаго на практыцы
Вы рэдка дэкадзіруеце біты ўручную. Выкарыстоўвайце бібліятэкі, прадастаўленыя IAB, або публічны дэкодэр:
- Падзяліце па
.і Base64-URL-дэкадзіруйце асноўны сегмент. - Прачытайце палі загалоўка фіксаванай шырыні (version, created, lastUpdated, cmpId, cmpVersion).
- Прайдзіце па бітавых палях мэт і пастаўшчыкоў, каб убачыць дакладна, якія нададзены.
У JavaScript выклік __tcfapi('getTCData', 2, cb) вяртае ўжо разабраны аб'ект — tcData.purpose.consents і tcData.vendor.consents — гэта карты id → boolean. Гэта ваша асноўная праўда падчас выканання.
Памылкі, якія забіваюць даход
Калі пэрсаналізаваны попыт ціха знікае, прычына звычайна ў TC string:
- Адсутны радок — рэкламны запыт не нясе ніякага
gdprApplies/TC string, таму адпаведныя SSP пераходзяць на непэрсаналізаваны. - Пастаўшчык без згоды — біт ідэнтыфікатара пастаўшчыка вашага партнёра па попыце роўны 0, таму яны не могуць рабіць стаўкі з пэрсаналізацыяй.
- Пратэрмінаваны або састарэлы радок — старая часавая пазнака прымушае ніжэйшыя платформы не давяраць яму.
- Няправільны ідэнтыфікатар CMP — незарэгістраваны або тэставы ідэнтыфікатар CMP робіць увесь радок несапраўдным.
Працэс адладкі
Узнавіце згоду карыстальніка, атрымайце жывы TC string з __tcfapi або з рэкламнага запыту, прапусціце яго праз валідатар і параўнайце дэкадзіраваныя мэты/пастаўшчыкоў з тым, што патрабуюць вашы партнёры. У дзевяці выпадках з дзесяці прабел — гэта адзін біт пастаўшчыка або адсутная мэта 1.
Дзе ўпісваецца FlexyConsent
FlexyConsent генеруе TC strings, сапраўдныя паводле спецыфікацыі, з зарэгістраваным ідэнтыфікатарам CMP, захоўвае іх свежымі, прадастаўляе дэкадзіраваны стан для адладкі і паведамляе, якія мэты і пастаўшчыкі сапраўды нададзены ў вашым трафіку — каб вы маглі бачыць, а не здагадвацца, дзе праточваецца згода (і даход).
Ключавыя высновы
- TC string — гэта ўпакаваны на ўзроўні бітаў запіс кожнага выбару згоды, які можна праверыць.
- Бітавыя палі мэт і пастаўшчыкоў вызначаюць, ці могуць партнёры паказваць пэрсаналізаваную рэкламу.
- Большасць падзенняў даходу звязана з адсутным радком, пастаўшчыком без згоды або састарэлым/несапраўдным ідэнтыфікатарам CMP.
- Дэкадзіруйце жывы радок з дапамогай
__tcfapiі праверайце яго на адпаведнасць патрабаванням партнёраў пры адладцы.