IAB GPP stringi silumine brauseri konsoolis: samm-sammuline õpetus
Miks GPP probleeme on raske märgata
Kui USA külastaja keeldub oma andmete müügist või jagamisest, peab see valik jõudma iga lehel oleva reklaamipartnerini. IAB Global Privacy Platformi (GPP) puhul liigub see kompaktse stringi ja jaotise ID-de loeteluna. Kui kumbki on vale — puudub, on aegunud või sisaldab valet jaotist — ei lähe nähtavalt midagi katki. Reklaamid laadivad endiselt, bänner näeb endiselt korras välja ning probleem ilmneb alles hiljem, kui partnerid ignoreerivad keeldumisi või pakuvad teie inventari eest vähem.
Hea uudis on see, et peaaegu kõike saab brauseri konsoolis kontrollida. See õpetus käib kontrollid läbi järjekorras, milles me neid töötaval lehel teeksime.
1. samm: veenduge, et API on olemas ja valmis
GPP-ühilduv CMP pakub globaalset funktsiooni __gpp. Avage oma lehel DevTools ja käivitage käsk ping:
__gpp('ping', function (data) { console.log(data); });
Tagastatud objekt ütleb ühe pilguga palju:
- gppVersion — praeguste teostuste puhul peaks olema 1.1.
- cmpStatus — kas CMP on laaditud või tekkis viga.
- cmpDisplayStatus — kas bänner on selle külastaja jaoks nähtav, peidetud või keelatud.
- signalStatus — “ready”, kui CMP on nõusoleku oleku kindlaks määranud, “not ready”, kuni ta veel otsustab.
- supportedAPIs — jaotised, mida CMP suudab luua.
- applicableSections — jaotiste ID-d, mis selle külastaja puhul praegu kehtivad.
- gppString — kodeeritud string ise.
Kui __gpp on undefined, puudub CMP stub või laadib liiga hilja. Stub peab olema paigas enne mis tahes reklaamiskripti, mis seda ootab, vastasel juhul ei näe need skriptid CMP-d ning ootavad kas või jätkavad ilma signaalita.
2. samm: kontrollige kehtivat jaotist
Igal GPP privaatsusraamistikul on numbriline jaotise ID. Väljaandjad kohtavad kõige sagedamini järgmisi: 2 (EL-i TCF v2), 5 (Kanada TCF), 7 (USA riiklik, “usnat”) ning 8 ja edasi üksikute osariikide jaotised, nagu California, Virginia, Colorado, Utah ja Connecticut. USA osariigi külastaja peaks applicableSections väljal tavaliselt nägema kas riiklikku jaotist või asjakohase osariigi jaotist, mitte EL-i jaotist.
Testige mitmest asukohast. Tavaline viga on CMP, mis tuvastab geograafia bänneri jaoks õigesti, kuid kirjutab stringi vaikejaotise sõltumata sellest, või vastupidi. VPN-i või oma CMP eelvaaterakenduste abil võrrelge, mida bänner näitab ja mida applicableSections teatab.
3. samm: lugege jaotise andmeid
Stringi käsitsi dekodeerimise asemel küsige CMP-lt parsitud jaotist:
__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');
USA riiklikus jaotises kasutavad keeldumisväljad lihtsat kokkulepet: 0 tähendab, et ei kehti, 1 tähendab, et kasutaja keeldus, ja 2 tähendab, et kasutaja ei keeldunud. Keskenduge esmalt neile väljadele:
- SaleOptOut ja SharingOptOut
- TargetedAdvertisingOptOut
- Vastavad notice väljad, mis salvestavad, kas külastajale anti iga tava kohta teatis
Tehke nüüd lehel keeldumine — klõpsake oma “Do Not Sell or Share” linki või lülitage säte eelistuste keskuses ümber — ja käivitage getSection uuesti. Keeldumisväljad peaksid muutuma 2-st 1-ks. Kui nad ei muutu, ei ole kasutajaliides ja signaal sünkroonis.
4. samm: testige Global Privacy Controli teed
Mitu osariigi seadust nõuab, et ettevõtted käsitleksid Global Privacy Controli signaali keeldumisena. Lubage GPC brauseris või laiendis, mis seda toetab, veenduge, et navigator.globalPrivacyControl tagastab konsoolis true, ning laadige seejärel leht värskes sessioonis. Asjakohased keeldumisväljad peaksid juba olema 1, ilma et külastaja bännerit puudutaks. Mõned jaotised sisaldavad ka välja, mis näitab, et valik tuli GPC signaalist.
5. samm: jälgige sündmusi, mitte ainult hetktõmmiseid
Reklaamiskriptid ei tohiks stringi lehe laadimisel ühe korra lugeda ja seda unustada. Registreerige listener, et näha seda, mida partnerid näevad:
__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });
Peaksite nägema sündmusi nagu listenerRegistered, signalStatus ja sectionChange. Kui külastaja valikut muudab, peaks järgnema sündmus sectionChange uuendatud stringiga. Kui teie header bidding wrapper või reklaamiserveri integratsioon loeb stringi ainult enne, kui signalStatus muutub “ready”, võib see saata tühja või aegunud väärtuse.
6. samm: jälgige stringi reklaamipäringutes
Lõpuks avage vahekaart Network ja filtreerige oma reklaamipäringud. Paljud reklaamide lõpp-punktid aktsepteerivad parameetreid gpp ja gpp_sid (string ja kehtivad jaotiste ID-d). Kontrollige, et:
- mõlemad parameetrid on USA külastajate päringutes olemas;
- string vastab sellele, mille ping päringu hetkel tagastas;
- pärast keeldumist kannavad järgnevad päringud uut stringi, mitte vahemällu salvestatut.
Kui kasutate Prebid.js-i, veenduge, et selle nõusolekuhalduse moodul on GPP jaoks seadistatud, ning kontrollige nii wrapperist väljuvaid pakkumispäringuid kui ka lõplikku reklaamiserveri kutset.
Levinumad tõrkemustrid
- Stub laadib pärast reklaamitage — partnerid ei näe CMP-d üldse.
- Piirkonna jaoks vale jaotis — USA liiklusele saadetakse EL-i jaotis või ei saadeta jaotist üldse.
- Liides ja signaal ei ole sünkroonis — lüliti muutub, string mitte.
- GPC ignoreeritakse — brauseri signaal ei muutu kunagi keeldumiseks.
- Aegunud stringid päringutes — wrapper salvestab esimese nähtud väärtuse vahemällu.
Peamised järeldused
- Alustage käsuga ping: versioon, olek, kehtivad jaotised ja string räägivad enamiku loost.
- Kasutage keeldumisväljade lugemiseks käsku getSection; 1 tähendab keeldunud, 2 tähendab mitte keeldunud.
- Testige keeldumislinki ja GPC-d eraldi ning veenduge, et mõlemad muudavad signaali.
- Kuulake sündmusi ja oodake “ready” signaali, enne kui reklaamipäringud stringi loevad.
- Kontrollige gpp ja gpp_sid päris võrgupäringutes enne ja pärast keeldumist.