Hvorfor GPP-problemer er vanskelige å oppdage

Når en amerikansk besøkende reserverer seg mot salg eller deling av dataene sine, må det valget nå hver annonsepartner på siden. Med IAB Global Privacy Platform (GPP) reiser det som en kompakt streng og en liste over seksjons-ID-er. Hvis en av dem er feil — mangler, er utdatert eller inneholder feil seksjon — går ingenting synlig i stykker. Annonser lastes fortsatt, banneret ser fortsatt fint ut, og problemet viser seg først senere ved at partnere ignorerer opt-outer eller byr mindre på inventaret ditt.

Den gode nyheten er at du kan inspisere nesten alt fra nettleserkonsollen. Denne veiledningen går gjennom sjekkene i den rekkefølgen vi ville kjørt dem på en live side.

Trinn 1: Bekreft at API-et finnes og er klart

En GPP-kompatibel CMP eksponerer en global funksjon __gpp. Åpne DevTools på siden din og kjør en ping-kommando:

__gpp('ping', function (data) { console.log(data); });

Objektet som returneres, forteller mye med ett blikk:

• gppVersion — bør være 1.1 for dagens implementeringer.
• cmpStatus — om CMP-en er lastet eller har støtt på en feil.
• cmpDisplayStatus — om banneret er synlig, skjult eller deaktivert for denne besøkende.
• signalStatus — «ready» når CMP-en har bestemt seg for en samtykketilstand, «not ready» mens den fortsatt avgjør.
• supportedAPIs — seksjonene CMP-en kan produsere.
• applicableSections — seksjons-ID-ene som gjelder for denne besøkende akkurat nå.
• gppString — selve den kodede strengen.

Hvis __gpp er udefinert, mangler CMP-stubben eller lastes for sent. Stubben må være på plass før ethvert annonseskript som forventer den, ellers ser disse skriptene ingen CMP og venter enten eller fortsetter uten signal.

Trinn 2: Sjekk den gjeldende seksjonen

Hvert personvernrammeverk i GPP har en numerisk seksjons-ID. De utgivere oftest møter, er 2 (EU TCF v2), 5 (kanadisk TCF), 7 (US National, «usnat») og 8 og oppover for individuelle delstatsseksjoner som California, Virginia, Colorado, Utah og Connecticut. En besøkende fra en amerikansk delstat bør normalt se enten den nasjonale seksjonen eller den relevante delstatsseksjonen i applicableSections, ikke EU-seksjonen.

Test fra flere steder. En vanlig feil er en CMP som oppdager geografien riktig for banneret, men skriver en standardseksjon i strengen uansett, eller omvendt. Bruk en VPN eller CMP-ens forhåndsvisningsverktøy for å sammenligne hva banneret viser med hva applicableSections melder.

Trinn 3: Les seksjonsdataene

I stedet for å dekode strengen for hånd kan du be CMP-en om den parsede seksjonen:

__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');

I US National-seksjonen følger opt-out-feltene en enkel konvensjon: 0 betyr ikke aktuelt, 1 betyr at brukeren har reservert seg, og 2 betyr at brukeren ikke har reservert seg. Fokuser først på disse feltene:

• SaleOptOut og SharingOptOut
• TargetedAdvertisingOptOut
• De tilhørende notice-feltene, som registrerer om den besøkende fikk beskjed om hver praksis

Utfør nå opt-outen på siden — klikk på lenken «Do Not Sell or Share» eller bytt innstillingen i preferansesenteret — og kjør getSection på nytt. Opt-out-feltene bør bytte fra 2 til 1. Gjør de ikke det, er UI og signal ute av synk.

Trinn 4: Test Global Privacy Control-stien

Flere delstatslover krever at virksomheter behandler et Global Privacy Control-signal som en opt-out. Aktiver GPC i en nettleser eller utvidelse som støtter det, bekreft at navigator.globalPrivacyControl returnerer true i konsollen, og last deretter siden i en ny økt. De relevante opt-out-feltene bør allerede vise 1 uten at den besøkende rører banneret. Noen seksjoner inneholder også et felt som angir at valget kom fra et GPC-signal.

Trinn 5: Følg hendelser, ikke bare øyeblikksbilder

Annonseskript bør ikke lese strengen én gang ved sideinnlasting og glemme den. Registrer en listener for å se hva partnere ser:

__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });

Du bør observere hendelser som listenerRegistered, signalStatus og sectionChange. Når den besøkende endrer et valg, bør en sectionChange-hendelse med en oppdatert streng følge. Hvis header bidding-wrapperen eller annonseserverintegrasjonen din bare leser strengen før signalStatus blir «ready», kan den sende en tom eller utdatert verdi.

Trinn 6: Følg strengen inn i annonseforespørsler

Åpne til slutt fanen Network og filtrer på annonseforespørslene dine. Mange annonseendepunkter godtar parameterne gpp og gpp_sid (strengen og de gjeldende seksjons-ID-ene). Sjekk at:

1. begge parameterne finnes på forespørsler fra amerikanske besøkende;
2. strengen samsvarer med den ping returnerte på tidspunktet for forespørselen;
3. påfølgende forespørsler etter en opt-out bærer den nye strengen i stedet for en bufret.

Hvis du bruker Prebid.js, bekreft at consent management-modulen er konfigurert for GPP, og inspiser både budforespørslene som forlater wrapperen og det endelige annonseserverkallet.

Vanlige feilmønstre

• Stub lastes etter annonsetaggene — partnere ser ingen CMP i det hele tatt.
• Feil seksjon for regionen — EU-seksjon sendt for amerikansk trafikk, eller ingen seksjon i det hele tatt.
• UI og signal ute av synk — bryteren endrer seg, strengen gjør ikke det.
• GPC ignorert — nettlesersignalet blir aldri en opt-out.
• Utdaterte strenger i forespørsler — wrapperen bufrer den første verdien den så.

Viktigste poenger

• Start med ping: versjon, status, gjeldende seksjoner og strengen forteller det meste av historien.
• Bruk getSection til å lese opt-out-felt; 1 betyr reservert, 2 betyr ikke reservert.
• Test opt-out-lenken og GPC hver for seg og bekreft at begge endrer signalet.
• Lytt etter hendelser og vent på et «ready»-signal før annonseforespørsler leser strengen.
• Verifiser gpp og gpp_sid i ekte nettverksforespørsler, før og etter en opt-out.