Kaip perskaityti TCF sutikimo eilutę: lauko vadovas kūrėjams
Kas iš tikrųjų yra TC eilutė
IAB Transparency & Consent Framework sukuria vieną kompaktišką prieigos raktą — TC eilutę — kuri keliauja su kiekviena reklamos užklausa ir tiksliai pasako tiekėjams, su kuo vartotojas sutiko ir su kuo nesutiko. Ji užkoduota Base64-URL ir supakuota bitų lygmenyje, todėl atrodo kaip nesąmonė (CPxy...AAA), bet užkoduoja tikslų, audituojamą įrašą.
Segmentai
Visa TC eilutė yra keli taškais atskirti segmentai. Pirmasis yra pagrindinė eilutė; kiti yra neprivalomi:
- Pagrindinė — CMP ID, CMP versija, sutikimo laiko žymos, politikos versija ir, svarbiausia, tikslo sutikimų bei tiekėjo sutikimų bitų laukai.
- Atskleisti tiekėjai — kurie tiekėjai buvo parodyti vartotojui.
- Leidėjo TC — sutikimai, būdingi jums, leidėjui.
Bitų laukai yra esmė: bitas N, nustatytas į 1, reiškia sutikimą tikslui N arba tiekėjui N. Tikslas 1 yra “saugoti / pasiekti informaciją įrenginyje,” tikslai 3 ir 4 apima personalizuotas reklamas ir pan.
Vienos dekodavimas praktikoje
Bitus rankiniu būdu dekoduojate retai. Naudokite IAB pateiktas bibliotekas arba viešą dekoderį:
- Padalykite pagal
.ir Base64-URL dekoduokite pagrindinį segmentą. - Perskaitykite fiksuoto pločio antraštės laukus (version, created, lastUpdated, cmpId, cmpVersion).
- Pereikite per tikslo ir tiekėjo bitų laukus, kad pamatytumėte, kurie tiksliai suteikti.
JavaScript kalboje __tcfapi('getTCData', 2, cb) iškvietimas grąžina jau išanalizuotą objektą — tcData.purpose.consents ir tcData.vendor.consents yra id → boolean žemėlapiai. Tai yra jūsų pagrindinė tiesa vykdymo metu.
Klaidos, kurios žudo pajamas
Kai personalizuota paklausa tyliai dingsta, paprastai dėl to kalta TC eilutė:
- Trūkstama eilutė — reklamos užklausoje nėra
gdprApplies/TC eilutės, todėl reikalavimus atitinkantys SSP nusileidžia iki nepersonalizuoto. - Tiekėjas nesutiko — jūsų paklausos partnerio tiekėjo ID bitas yra 0, todėl jis negali siūlyti kainos su personalizavimu.
- Pasibaigusi arba pasenusi eilutė — sena laiko žyma verčia tolesnes platformas ja nepasitikėti.
- Neteisingas CMP ID — neregistruotas arba bandomasis CMP ID padaro negaliojančią visą eilutę.
Derinimo darbo eiga
Atkurkite vartotojo sutikimą, paimkite tiesioginę TC eilutę iš __tcfapi arba reklamos užklausos, paleiskite ją per tikrintuvą ir palyginkite dekoduotus tikslus/tiekėjus su tuo, ko reikalauja jūsų partneriai. Devynis kartus iš dešimties spraga yra vienas tiekėjo bitas arba trūkstamas tikslas 1.
Kur tinka FlexyConsent
FlexyConsent generuoja specifikaciją atitinkančias TC eilutes su registruotu CMP ID, išlaiko jas šviežias, atskleidžia dekoduotą būseną derinimui ir praneša, kurie tikslai bei tiekėjai iš tikrųjų suteikiami visame jūsų sraute — kad galėtumėte matyti, o ne spėlioti, kur nuteka sutikimas (ir pajamos).
Pagrindinės išvados
- TC eilutė yra bitais supakuotas, audituojamas kiekvieno sutikimo pasirinkimo įrašas.
- Tikslo ir tiekėjo bitų laukai nulemia, ar partneriai gali teikti personalizuotas reklamas.
- Dauguma pajamų kritimų siejasi su trūkstama eilute, nesutikusiu tiekėju arba pasenusiu/negaliojančiu CMP ID.
- Dekoduokite tiesioginę eilutę su
__tcfapiir patikrinkite ją pagal partnerių reikalavimus derindami.