Villuleit í IAB GPP strengnum í vafrakonsólinni: Kennsla skref fyrir skref
Hvers vegna GPP-vandamál eru erfið að koma auga á
Þegar bandarískur gestur afþakkar sölu eða miðlun gagna sinna verður það val að berast til hvers auglýsingasamstarfsaðila á síðunni. Með IAB Global Privacy Platform (GPP) berst það sem þéttur strengur og listi yfir auðkenni hluta (section IDs). Ef annað hvort er rangt — vantar, er úrelt eða ber rangan hluta — bilar ekkert sýnilega. Auglýsingar hlaðast áfram, borðinn lítur vel út og vandamálið kemur aðeins fram síðar sem samstarfsaðilar sem hunsa afþökkun eða bjóða minna í birgðir þínar.
Góðu fréttirnar eru að þú getur skoðað næstum allt úr vafrakonsólinni. Þessi kennsla fer yfir athuganirnar í þeirri röð sem við myndum framkvæma þær á lifandi síðu.
Skref 1: Staðfestu að API-ið sé til og tilbúið
CMP sem styður GPP útvegar almenna __gpp aðgerð. Opnaðu DevTools á síðunni þinni og keyrðu skipunina ping:
__gpp('ping', function (data) { console.log(data); });
Hluturinn sem skilað er segir mikið við fyrstu sýn:
- gppVersion — ætti að vera 1.1 í núverandi útfærslum.
- cmpStatus — hvort CMP hefur hlaðist eða rekist á villu.
- cmpDisplayStatus — hvort borðinn er sýnilegur, falinn eða óvirkur fyrir þennan gest.
- signalStatus — “ready” þegar CMP hefur ákveðið samþykkisstöðu, “not ready” meðan það er enn að ákveða.
- supportedAPIs — hlutarnir sem CMP getur framleitt.
- applicableSections — auðkenni þeirra hluta sem gilda um þennan gest núna.
- gppString — kóðaði strengurinn sjálfur.
Ef __gpp er óskilgreint vantar CMP stub eða það hleðst of seint. Stub-ið þarf að vera til staðar á undan öllum auglýsingaskriftum sem búast við því, annars sjá þær ekkert CMP og bíða annaðhvort eða halda áfram án merkis.
Skref 2: Athugaðu gildandi hluta
Hver persónuverndarrammi í GPP hefur talnaauðkenni hluta. Þeir sem útgefendur rekast oftast á eru 2 (EU TCF v2), 5 (kanadískt TCF), 7 (US National, “usnat”) og 8 og áfram fyrir einstaka ríkishluta eins og Kaliforníu, Virginíu, Colorado, Utah og Connecticut. Gestur frá bandarísku ríki ætti venjulega að sjá annaðhvort landshlutann eða viðkomandi ríkishluta í applicableSections, ekki ESB-hlutann.
Prófaðu frá nokkrum stöðum. Algeng villa er CMP sem greinir staðsetningu rétt fyrir borðann en skrifar sjálfgefinn hluta í strenginn óháð því, eða öfugt. Notaðu VPN eða forskoðunartól CMP-kerfisins þíns og berðu saman það sem borðinn sýnir við það sem applicableSections skilar.
Skref 3: Lestu gögn hlutans
Í stað þess að afkóða strenginn í höndunum skaltu biðja CMP um þáttuðu útgáfu hlutans:
__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');
Í US National hlutanum nota afþökkunarreitirnir einfalda reglu: 0 þýðir á ekki við, 1 þýðir að notandinn afþakkaði og 2 þýðir að notandinn afþakkaði ekki. Einbeittu þér fyrst að þessum reitum:
- SaleOptOut og SharingOptOut
- TargetedAdvertisingOptOut
- Samsvarandi notice reiti, sem skrá hvort gesturinn fékk tilkynningu um hverja framkvæmd
Framkvæmdu nú afþökkunina á síðunni — smelltu á tengilinn “Do Not Sell or Share” eða breyttu stillingunni í stillingamiðstöðinni — og keyrðu getSection aftur. Afþökkunarreitirnir ættu að breytast úr 2 í 1. Ef þeir gera það ekki eru viðmótið og merkið ekki í takt.
Skref 4: Prófaðu leið Global Privacy Control
Nokkur ríkislög krefjast þess að fyrirtæki meðhöndli Global Privacy Control merki sem afþökkun. Virkjaðu GPC í vafra eða viðbót sem styður það, staðfestu að navigator.globalPrivacyControl skili true í konsólinni og hlaðið síðan síðunni í nýrri lotu. Viðeigandi afþökkunarreitir ættu þegar að sýna 1 án þess að gesturinn snerti borðann. Sumir hlutar innihalda einnig reit sem sýnir að valið kom frá GPC-merki.
Skref 5: Fylgstu með atburðum, ekki bara skyndimyndum
Auglýsingaskriftir ættu ekki að lesa strenginn einu sinni við hleðslu síðu og gleyma honum. Skráðu listener til að sjá hvað samstarfsaðilar sjá:
__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });
Þú ættir að sjá atburði eins og listenerRegistered, signalStatus og sectionChange. Þegar gesturinn breytir vali ætti sectionChange atburður með uppfærðum streng að fylgja. Ef header bidding umgjörðin þín eða samþætting auglýsingaþjóns les aðeins strenginn áður en signalStatus verður “ready” gæti hún sent tómt eða úrelt gildi.
Skref 6: Fylgdu strengnum inn í auglýsingabeiðnir
Opnaðu að lokum Network flipann og síaðu eftir auglýsingabeiðnum þínum. Margir auglýsingaendapunktar taka við breytunum gpp og gpp_sid (strengurinn og auðkenni gildandi hluta). Athugaðu að:
- báðar breyturnar séu til staðar í beiðnum frá bandarískum gestum;
- strengurinn passi við þann sem ping skilaði þegar beiðnin var send;
- eftir afþökkun beri síðari beiðnir nýja strenginn en ekki þann sem var í skyndiminni.
Ef þú notar Prebid.js skaltu staðfesta að samþykkisstjórnunareining þess sé stillt fyrir GPP og skoða tilboðsbeiðnirnar sem fara út úr umgjörðinni auk lokakallsins í auglýsingaþjóninn.
Algeng bilunarmynstur
- Stub hleðst á eftir auglýsingatögum — samstarfsaðilar sjá ekkert CMP.
- Rangur hluti fyrir svæðið — ESB-hluti sendur fyrir bandaríska umferð, eða enginn hluti.
- Viðmót og merki ekki í takt — rofinn breytist, strengurinn ekki.
- GPC hunsað — vaframerkið verður aldrei að afþökkun.
- Úreltir strengir í beiðnum — umgjörðin geymir fyrsta gildið sem hún sá.
Lykilatriði
- Byrjaðu á ping: útgáfa, staða, gildandi hlutar og strengurinn segja þér mestan hluta sögunnar.
- Notaðu getSection til að lesa afþökkunarreiti; 1 þýðir afþakkað, 2 þýðir ekki afþakkað.
- Prófaðu afþökkunartengilinn og GPC hvort í sínu lagi og staðfestu að bæði breyti merkinu.
- Hlustaðu á atburði og bíddu eftir “ready” merki áður en auglýsingabeiðnir lesa strenginn.
- Staðfestu gpp og gpp_sid í raunverulegum netbeiðnum, fyrir og eftir afþökkun.