Si të Lexoni një String Pëlqimi TCF: Një Udhëzues Praktik për Zhvilluesit
Çfarë Është Në të Vërtetë TC String
IAB Transparency & Consent Framework prodhon një token të vetëm kompakt — TC string — që udhëton me çdo kërkesë reklame dhe u thotë shitësve saktësisht me çfarë ka rënë dakord dhe me çfarë jo një përdorues. Ai është i koduar Base64-URL dhe i paketuar në nivel biti, kështu që duket si marrëzi (CPxy...AAA) por kodon një regjistrim të saktë, të auditueshëm.
Segmentet
Një TC string i plotë janë disa segmente të ndara me pikë. I pari është core string; të tjerët janë opsionalë:
- Core — CMP ID, versioni i CMP-së, vulat kohore të pëlqimit, versioni i politikës dhe vendimtarisht fushat e biteve të pëlqimeve të qëllimeve dhe pëlqimeve të shitësve.
- Shitësit e zbuluar — cilët shitës iu shfaqën përdoruesit.
- Publisher TC — pëlqime specifike për ju, botuesin.
Fushat e biteve janë zemra e tij: biti N i vendosur në 1 do të thotë pëlqim për qëllimin N ose shitësin N. Qëllimi 1 është “ruaj/aksesoj informacion në një pajisje,” qëllimet 3 dhe 4 mbulojnë reklamat e personalizuara, e kështu me radhë.
Dekodimi i Njërit Në Praktikë
Rrallë dekodoni bite me dorë. Përdorni bibliotekat e ofruara nga IAB ose një dekodues publik:
- Ndajeni te
.dhe dekodoni Base64-URL segmentin core. - Lexoni fushat e header-it me gjerësi fikse (version, created, lastUpdated, cmpId, cmpVersion).
- Kaloni nëpër fushat e biteve të qëllimeve dhe shitësve për të parë saktësisht cilat janë dhënë.
Në JavaScript thirrja __tcfapi('getTCData', 2, cb) kthen objektin tashmë të analizuar — tcData.purpose.consents dhe tcData.vendor.consents janë harta të id → boolean. Ky është e vërteta juaj bazë në kohën e ekzekutimit.
Gabimet Që Vrasin të Ardhurat
Kur kërkesa e personalizuar zhduket në heshtje, zakonisht TC string është arsyeja:
- String që mungon — kërkesa e reklamës nuk mbart asnjë
gdprApplies/TC string, kështu që SSP-të në përputhje bien në jo-të-personalizuar. - Shitës pa pëlqim — biti i ID-së së shitësit të partnerit tuaj të kërkesës është 0, kështu që ata nuk mund të bëjnë oferta me personalizim.
- String i skaduar ose i vjetëruar — një vulë kohore e vjetër bën që platformat e mëposhtme të mos i besojnë.
- CMP ID i gabuar — një CMP ID i paregjistruar ose testues e bën të pavlefshëm tërë stringun.
Një Rrjedhë Pune Korrigjimi
Riprodhoni pëlqimin e përdoruesit, kapni TC string-un e drejtpërdrejtë nga __tcfapi ose nga kërkesa e reklamës, kalojeni nëpër një validues dhe krahasoni qëllimet/shitësit e dekoduar me atë që kërkojnë partnerët tuaj. Nëntë herë nga dhjetë boshllëku është një bit i vetëm shitësi ose një qëllim 1 që mungon.
Ku Përshtatet FlexyConsent
FlexyConsent gjeneron TC string-e të vlefshëm sipas specifikimit me një CMP ID të regjistruar, i mban të freskët, ekspozon gjendjen e dekoduar për korrigjim dhe raporton cilat qëllime dhe shitës po jepen në të vërtetë në trafikun tuaj — kështu që mund të shihni, jo të hamendësoni, ku po rrjedh pëlqimi (dhe të ardhurat).
Pikat Kryesore
- TC string është një regjistrim i paketuar në bite, i auditueshëm i çdo zgjedhjeje pëlqimi.
- Fushat e biteve të qëllimeve dhe shitësve vendosin nëse partnerët mund të shërbejnë reklama të personalizuara.
- Shumica e rënieve të të ardhurave gjurmohen te një string që mungon, një shitës pa pëlqim ose një CMP ID i vjetëruar/i pavlefshëm.
- Dekodoni stringun e drejtpërdrejtë me
__tcfapidhe vlerësojeni kundrejt kërkesave të partnerit gjatë korrigjimit.