IAB GPP eilutės derinimas naršyklės konsolėje: žingsnis po žingsnio vadovas
Kodėl GPP problemas sunku pastebėti
Kai JAV lankytojas atsisako savo duomenų pardavimo ar dalijimosi jais, šis pasirinkimas turi pasiekti kiekvieną puslapio reklamos partnerį. IAB Global Privacy Platform (GPP) sistemoje jis keliauja kaip glausta eilutė ir skilčių ID sąrašas. Jei bet kuris iš jų neteisingas — trūksta, pasenęs ar turi netinkamą skiltį — matomai nieko nesugenda. Reklamos vis tiek įkeliamos, reklamjuostė atrodo gerai, o problema išryškėja tik vėliau: partneriai ignoruoja atsisakymus arba siūlo mažiau už jūsų atsargas.
Gera žinia ta, kad beveik viską galima patikrinti naršyklės konsolėje. Šis vadovas pereina patikras tokia tvarka, kokia jas atliktume gyvame puslapyje.
1 žingsnis: Patvirtinkite, kad API egzistuoja ir yra paruoštas
GPP suderinamas CMP atveria visuotinę funkciją __gpp. Atidarykite DevTools savo puslapyje ir paleiskite komandą ping:
__gpp('ping', function (data) { console.log(data); });
Grąžintas objektas iš pirmo žvilgsnio daug pasako:
- gppVersion — dabartinėse implementacijose turėtų būti 1.1.
- cmpStatus — ar CMP įsikėlė, ar susidūrė su klaida.
- cmpDisplayStatus — ar reklamjuostė šiam lankytojui matoma, paslėpta ar išjungta.
- signalStatus — „ready“, kai CMP nusistovi ties sutikimo būsena, „not ready“, kol dar sprendžia.
- supportedAPIs — skiltys, kurias CMP gali sukurti.
- applicableSections — skilčių ID, kurie šiuo metu taikomi šiam lankytojui.
- gppString — pati užkoduota eilutė.
Jei __gpp neapibrėžtas, CMP stub trūksta arba jis įkeliamas per vėlai. Stub turi būti vietoje prieš bet kokį jo tikimąsi reklamos skriptą, kitaip tie skriptai nematys jokio CMP ir arba lauks, arba tęs be signalo.
2 žingsnis: Patikrinkite taikomą skiltį
Kiekvienas GPP privatumo pagrindas turi skaitinį skilties ID. Leidėjai dažniausiai sutinka 2 (ES TCF v2), 5 (Kanados TCF), 7 (US National, „usnat“) ir 8 bei aukštesnius atskirų valstijų skiltims, tokioms kaip Kalifornija, Virdžinija, Kolorado, Jutos ir Konektikuto. JAV valstijos lankytojas applicableSections turėtų matyti arba nacionalinę skiltį, arba atitinkamą valstijos skiltį, o ne ES skiltį.
Testuokite iš kelių vietų. Dažna klaida — CMP, kuris teisingai nustato geografiją reklamjuostei, bet į eilutę įrašo numatytąją skiltį nepaisydamas jos, arba atvirkščiai. Naudodami VPN ar savo CMP peržiūros įrankius palyginkite, ką rodo reklamjuostė, su tuo, ką praneša applicableSections.
3 žingsnis: Perskaitykite skilties duomenis
Užuot dekodavę eilutę rankiniu būdu, paprašykite CMP išanalizuotos skilties:
__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');
US National skiltyje atsisakymo laukai naudoja paprastą konvenciją: 0 reiškia netaikoma, 1 reiškia, kad naudotojas atsisakė, o 2 reiškia, kad naudotojas neatsisakė. Pirmiausia sutelkite dėmesį į šiuos laukus:
- SaleOptOut ir SharingOptOut
- TargetedAdvertisingOptOut
- Atitinkami notice laukai, fiksuojantys, ar lankytojui buvo pateiktas pranešimas apie kiekvieną praktiką
Dabar atlikite atsisakymą puslapyje — spustelėkite nuorodą „Do Not Sell or Share“ arba perjunkite nustatymą nuostatų centre — ir vėl paleiskite getSection. Atsisakymo laukai turėtų pasikeisti iš 2 į 1. Jei ne, sąsaja ir signalas nesinchronizuoti.
4 žingsnis: Išbandykite Global Privacy Control kelią
Keli valstijų įstatymai reikalauja, kad verslai Global Privacy Control signalą traktuotų kaip atsisakymą. Įjunkite GPC naršyklėje ar plėtinyje, kuris jį palaiko, patvirtinkite, kad navigator.globalPrivacyControl konsolėje grąžina true, tada įkelkite puslapį naujoje sesijoje. Atitinkami atsisakymo laukai jau turėtų rodyti 1, lankytojui nelietus reklamjuostės. Kai kuriose skiltyse yra ir laukas, nurodantis, kad pasirinkimas atėjo iš GPC signalo.
5 žingsnis: Stebėkite įvykius, ne tik momentines nuotraukas
Reklamos skriptai neturėtų perskaityti eilutės kartą puslapio įkėlimo metu ir pamiršti. Užregistruokite listener, kad pamatytumėte, ką mato partneriai:
__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });
Turėtumėte stebėti tokius įvykius kaip listenerRegistered, signalStatus ir sectionChange. Kai lankytojas pakeičia pasirinkimą, turėtų sekti sectionChange įvykis su atnaujinta eilute. Jei jūsų header bidding wrapper ar ad serverio integracija skaito eilutę tik prieš signalStatus tampant „ready“, ji gali išsiųsti tuščią ar pasenusią reikšmę.
6 žingsnis: Sekite eilutę į reklamos užklausas
Galiausiai atidarykite skirtuką Network ir išfiltruokite savo reklamos užklausas. Daugelis reklamos galinių taškų priima parametrus gpp ir gpp_sid (eilutę ir taikomų skilčių ID). Patikrinkite, ar:
- abu parametrai yra užklausose iš JAV lankytojų;
- eilutė sutampa su ta, kurią užklausos metu grąžino ping;
- po atsisakymo vėlesnės užklausos neša naują eilutę, o ne talpykloje saugomą.
Jei naudojate Prebid.js, patikrinkite, ar jo sutikimo valdymo modulis sukonfigūruotas GPP, ir apžiūrėkite bid requests, paliekančius wrapper, taip pat galutinį ad serverio iškvietimą.
Dažni gedimų modeliai
- Stub įkeliamas po reklamos žymų — partneriai visai nemato CMP.
- Netinkama skiltis regionui — ES skiltis siunčiama JAV srautui arba nėra jokios skilties.
- Sąsaja ir signalas nesinchronizuoti — jungiklis pasikeičia, eilutė ne.
- GPC ignoruojamas — naršyklės signalas niekada netampa atsisakymu.
- Pasenusios eilutės užklausose — wrapper išsaugo pirmą pamatytą reikšmę talpykloje.
Pagrindinės išvados
- Pradėkite nuo ping: versija, būsena, taikomos skiltys ir eilutė papasakoja didžiąją istorijos dalį.
- Atsisakymo laukams perskaityti naudokite getSection; 1 reiškia atsisakė, 2 reiškia neatsisakė.
- Atsisakymo nuorodą ir GPC išbandykite atskirai ir patvirtinkite, kad abu keičia signalą.
- Klausykitės įvykių ir laukite „ready“ signalo, kol reklamos užklausos skaito eilutę.
- Patikrinkite gpp ir gpp_sid tikrose tinklo užklausose prieš atsisakymą ir po jo.