Kuinka lukea TCF-suostumusmerkkijonoa: kehittäjän kenttäopas
Mikä TC string oikeastaan on
IAB Transparency & Consent Framework tuottaa yhden tiiviin tokenin — TC stringin — joka matkaa jokaisen mainospyynnön mukana ja kertoo toimittajille tarkalleen, mihin käyttäjä on ja ei ole suostunut. Se on Base64-URL-koodattu ja pakattu bittitasolla, joten se näyttää sekamelskalta (CPxy...AAA), mutta koodaa tarkan, tarkastettavan tietueen.
Segmentit
Täysi TC string on useita pisteellä eroteltuja segmenttejä. Ensimmäinen on ydinmerkkijono; muut ovat valinnaisia:
- Ydin — CMP-tunnus, CMP-versio, suostumuksen aikaleimat, käytäntöversio ja ratkaisevasti tarkoitussuostumukset- ja toimittajasuostumukset-bittikentät.
- Disclosed vendors — mitkä toimittajat näytettiin käyttäjälle.
- Publisher TC — sinulle, julkaisijalle, ominaiset suostumukset.
Bittikentät ovat asian ydin: bitti N asetettuna arvoon 1 tarkoittaa suostumusta tarkoitukseen N tai toimittajaan N. Tarkoitus 1 on “tietojen tallennus/käyttö laitteella,” tarkoitukset 3 ja 4 kattavat personoidut mainokset ja niin edelleen.
Yhden purkaminen käytännössä
Harvoin puret bittejä käsin. Käytä IAB:n tarjoamia kirjastoja tai julkista purkajaa:
- Jaa kohdasta
.ja Base64-URL-pura ydinsegmentti. - Lue kiinteäleveyksiset otsikkokentät (version, created, lastUpdated, cmpId, cmpVersion).
- Käy läpi tarkoitus- ja toimittajabittikentät nähdäksesi tarkalleen, mitkä on myönnetty.
JavaScriptissä kutsu __tcfapi('getTCData', 2, cb) palauttaa jo jäsennetyn objektin — tcData.purpose.consents ja tcData.vendor.consents ovat id → boolean -karttoja. Se on perustotuutesi suorituksen aikana.
Virheet jotka tappavat tulot
Kun personoitu kysyntä hiljaa katoaa, syynä on yleensä TC string:
- Puuttuva merkkijono — mainospyyntö ei kanna mitään
gdprApplies/TC stringiä, joten vaatimustenmukaiset SSP:t laskevat epäpersonalisoituun tilaan. - Toimittajalle ei suostumusta — demand-kumppanisi toimittajatunnuksen bitti on 0, joten he eivät voi tarjota personoinnilla.
- Vanhentunut tai vanha merkkijono — vanha aikaleima saa alavirran alustat epäluottamaan siihen.
- Väärä CMP-tunnus — rekisteröimätön tai testi-CMP-tunnus mitätöi koko merkkijonon.
Virheenkorjaustyönkulku
Toista käyttäjän suostumus, hae elävä TC string kohteesta __tcfapi tai mainospyynnöstä, aja se validaattorin läpi ja vertaa purettuja tarkoituksia/toimittajia siihen, mitä kumppanisi vaativat. Yhdeksän kertaa kymmenestä aukko on yksittäinen toimittajabitti tai puuttuva tarkoitus 1.
Mihin FlexyConsent sopii
FlexyConsent generoi spesifikaation mukaisia TC stringejä rekisteröidyllä CMP-tunnuksella, pitää ne tuoreina, paljastaa puretun tilan virheenkorjausta varten ja raportoi, mitkä tarkoitukset ja toimittajat tosiasiassa myönnetään liikenteessäsi — jotta voit nähdä, et arvata, missä suostumus (ja tulot) vuotaa.
Keskeiset huomiot
- TC string on bittipakattu, tarkastettava tietue jokaisesta suostumusvalinnasta.
- Tarkoitus- ja toimittajabittikentät päättävät, voivatko kumppanit tarjoilla personoituja mainoksia.
- Useimmat tulojen laskut juontuvat puuttuvasta merkkijonosta, suostumusta vailla olevasta toimittajasta tai vanhentuneesta/virheellisestä CMP-tunnuksesta.
- Pura elävä merkkijono kohteella
__tcfapija validoi se kumppanivaatimuksia vasten virheenkorjauksessa.