Kuidas lugeda TCF nõusolekustringi: arendaja praktiline juhend
Mis TC string tegelikult on
IAB Transparency & Consent Framework toodab ühe kompaktse märgi — TC stringi — mis reisib iga reklaamipäringuga ja ütleb müüjatele täpselt, millega kasutaja on ja millega ei ole nõustunud. See on Base64-URL kodeeritud ja pakitud bitt-tasemel, nii et see näeb välja nagu mõttetus (CPxy...AAA), kuid kodeerib täpse, auditeeritava kirje.
Segmendid
Täielik TC string koosneb mitmest punktiga eraldatud segmendist. Esimene on core string; teised on valikulised:
- Core — CMP ID, CMP versioon, nõusoleku ajatemplid, poliitika versioon ja mis kõige tähtsam, eesmärgi nõusolekute ja müüja nõusolekute bitiväljad.
- Avalikustatud müüjad — millised müüjad kasutajale näidati.
- Avaldaja TC — nõusolekud, mis on spetsiifilised sulle, avaldajale.
Bitiväljad on selle tuum: bitt N seatud väärtusele 1 tähendab nõusolekut eesmärgi N või müüja N jaoks. Eesmärk 1 on “teabe salvestamine/sellele juurdepääs seadmes,” eesmärgid 3 ja 4 hõlmavad personaliseeritud reklaame jne.
Ühe dekodeerimine praktikas
Sa dekodeerid bitte harva käsitsi. Kasuta IAB-i pakutud teeke või avalikku dekoodrit:
- Jaga
.järgi ja Base64-URL-dekodeeri core segment. - Loe fikseeritud laiusega päiseväljad (versioon, created, lastUpdated, cmpId, cmpVersion).
- Käi läbi eesmärgi ja müüja bitiväljad, et näha täpselt, millised on antud.
JavaScriptis tagastab kutse __tcfapi('getTCData', 2, cb) juba parsitud objekti — tcData.purpose.consents ja tcData.vendor.consents on id → tõeväärtus kaardid. See on sinu põhitõde käitusajal.
Vead, mis tapavad tulu
Kui personaliseeritud nõudlus vaikselt kaob, on TC string tavaliselt põhjus:
- Puuduv string — reklaamipäring ei kanna
gdprApplies/TC stringi, nii et nõuetele vastavad SSP-d langevad mitte-personaliseeritule. - Müüjale puudub nõusolek — sinu nõudluspartneri müüja ID bitt on 0, nii et nad ei saa personaliseerimisega pakkuda.
- Aegunud või vananenud string — vana ajatempel paneb järgnevad platvormid seda usaldama.
- Vale CMP ID — registreerimata või testimise CMP ID muudab kogu stringi kehtetuks.
Silumise töövoog
Reprodutseeri kasutaja nõusolek, haara live TC string kohast __tcfapi või reklaamipäringust, lase see läbi valideerija ja võrdle dekodeeritud eesmärke/müüjaid sellega, mida sinu partnerid nõuavad. Üheksal korral kümnest on lünk üksik müüja bitt või puuduv eesmärk 1.
Kuhu FlexyConsent sobib
FlexyConsent genereerib spetsifikatsiooni-kehtivaid TC stringe registreeritud CMP ID-ga, hoiab need värsked, paljastab dekodeeritud oleku silumiseks ja raporteerib, millised eesmärgid ja müüjad sinu liikluse lõikes tegelikult antakse — nii et saad näha, mitte oletada, kus nõusolek (ja tulu) lekib.
Põhilised järeldused
- TC string on bitt-pakitud, auditeeritav kirje igast nõusolekuvalikust.
- Eesmärgi ja müüja bitiväljad otsustavad, kas partnerid saavad serveerida personaliseeritud reklaame.
- Enamik tulu languseid taandub puuduvale stringile, nõusolekuta müüjale või vananenud/kehtetule CMP ID-le.
- Dekodeeri live string koodiga
__tcfapija valideeri see partnerite nõuetega silumisel.