- Versjon 2.1 av TCF: Også fremover godtar vi strenger fra versjon 2.1, men vi oppfordrer CMP-er til å følge IAB-veiledningen til milepæler for implementering i takt med at bransjen går over til versjon 2.2 av TCF.
- Googles løsninger for samtykkestyring: Googles løsninger for samtykkestyring, som er tilgjengelige på «Personvern og meldinger»-fanen i AdMob, AdSense og Ad Manager, støtter versjon 2.2 av TCF i forbindelse med meldinger om europeiske forordninger, i tråd med IABs oppdaterte krav til CMP-er.
For å hjelpe publisister som må håndtere feil og ukorrekte konfigurasjoner i forbindelse med lanseringen av versjon 2.2 av IAB Europes rammeverk for åpenhet og samtykke, gir vi dem en rapport med feilene vi har funnet.
Denne artikkelen forklarer hvordan du løser problemer med implementeringen av TCF versjon 2.2, ved hjelp av dette:
Oppdatert veiledning
Vanlige feil som er rettet
Du kan feilsøke noen av de vanligste feilene i AdMob, AdSense og Ad Manager på denne måten:
Vurder å innhente samtykke på nytt fra brukere med ÅS-strenger som ikke genererer inntekter(Feil 1.1, 3.1, 4.1, 5.1, 5.2 og 6.1)
Relaterte feil
Oppdatert veiledning
Du bør vurdere å innhente samtykke fra brukerne på nytt.
Hensikt
Publisister kan oppnå fordeler ved å innhente samtykke fra brukerne på nytt hvis de tidligere har hatt eksterne strenger med globalt omfang, ugyldige CMP-ID-er (fra testing), ugyldige GVL-ID-er (fra testing) eller manglende samtykke fra Google som leverandør på et tidspunkt under implementeringen.
Feil 1.1, 1.2 og 1.3: Det er viktig at du sjekker om disse feilene representerer et betydelig trafikkvolum. Hvis det er tilfellet, kan det være et problem med CMP-en din. Sjekk i så fall at Google har fått samtykke til de nødvendige formålene, og at de er leverandør for samtykke OG berettiget interesse (leverandør-ID 755).
IAB-spesifikasjon
I henhold til IAB-spesifikasjonene kan CMP-er bufre samtykkestrenger i opptil 13 måneder.
AddEventHandler
innen 500 millisekunder(Feil 2.1a, 2.1b, 2.0a, 2.0b og 2.0c)
Relaterte feil
Feil 2.1a: Denne veiledningen kan også brukes for feil 2.1b, 2.0a, 2.0b og 2.0c.
Oppdatert veiledning
Selv om det ikke lenger stilles noe krav til tidsavbrudd, foreslår vi en grundig gjennomgang av implementeringen av CMP-systemer for å sjekke at de returnerer kall til AddEventListener getTCData
umiddelbart.
Hvis en CMP ikke svarer, tjener du kanskje ikke penger på forespørselen.
Hensikt
Google overholder IAB-spesifikasjonen som angir at CMP-er skal svare umiddelbart på AddEventListener
-funksjonen. Hvis en CMP ikke svarer umiddelbart, tjener du kanskje ikke penger på forespørselen.
CMP-svar er dessuten en del av kjeden av hendelser som har innvirkning på hvor raskt annonseforespørsler kan gjennomføres. Hvis publisisten kan redusere tiden mellom sideinnlastingen og annonseforespørselen, gir det færre tapte visninger.
IAB-spesifikasjon
Gjeldende IAB-spesifikasjon: IAB-spesifikasjonen for AddEventListener (på GitHub)
AddEventListener
-tilbakekallet skal kalles umiddelbart når de nåværende dataene om åpenhet og samtykke (ÅS-data) registreres, selv om CMP-statusen er loading
(lastes inn) og CMP-en har ufullstendige ÅS-data. På denne måten kan skriptet bak kallet få tilgang til det registrerte listenerId
-objektet. Ved hver endring av ÅS-strengen skal dessuten tilbakekallet kalles, med mindre det fjernes ved hjelp av RemoveEventListener
.Retningslinjesenteret
Retningslinjesenteret varsler publisister hvis de har apper eller nettsteder som ikke er i tråd med Googles krav til samtykkestyring.
Feilrapport
Vi varsler publisistene i brukergrensesnittet i produktet hvis vi oppdager et problem med ÅS-strengen som er knyttet til minst én av appene deres eller ett av nettstedene deres. På «Brukersamtykke i EU»-siden i publisistkontoer kan publisister som har fått rapportert feil, klikke på Last ned TCF-feilrapporten for å laste ned en detaljert rapport om feil som er funnet de siste 7 dagene.
- Ad Manager: Klikk på Administrator og deretter på Brukersamtykke i EU.
- AdMob og AdSense: Klikk på Blokkeringskontroller og deretter på Brukersamtykke i EU.
I rapporten finner du disse opplysningene om hver av feilene som ble funnet:
- Domene/MobileAppID: nettstedet eller mobilappen som er feilkonfigurert.
- Bane for annonseenhet: annonseenheten som er knyttet til feilen.
- Feilkode: koden som er tilordnet feilen.
- Antall feil: hvor mange søk som inneholder feilen som ble observert den foregående uken.
- Sist oppdaget (dato): den siste datoen da feilen ble oppdaget.
Publisister kan bruke feilkodene i rapporten til å se hva de bør gjøre, i feilsøkingstabellene nedenfor, og rette feilene.
Feilsøking
Vi ønsker å hjelpe publisister å korrigere feilkonfigurerte integrasjoner med versjon 2.2 av IABs TCF (rammeverket for åpenhet og samtykke), og derfor har vi utarbeidet tabeller med de vanligste typene feil i ÅS-strenger og anbefalinger om feilsøking.
Bruk disse tabellene til å forstå problemene som oppstår på annonseforespørselsnivå, og den tilsvarende systematferden.
Scenarioer med begrenset samtykke
Alle de tre scenarioene nedenfor prioriteres alltid fremfor feilkonfigurasjoner, selv om en gitt forespørsel har flere feil.
Scenario | Beskrivelse | Foreslått tiltak |
---|---|---|
1.1 | Google – som leverandør – tillates ikke, verken per samtykke eller berettiget interesse. | Sjekk om brukeren med vilje har avvist Google som leverandør, om det finnes feil med implementeringen av plattformen for samtykkestyring, eller om det er noen begrensninger for publisister. |
1.2 | Det ble ikke gitt samtykke til formål 1 for EØS-land og Storbritannia. |
Sjekk om brukeren bevisst ikke har godkjent formål 1, eller om dette kan skyldes feil med implementeringen av CMP-plattformen. Publisister i Sveits må påse at de oppgir korrekte verdier i feltene
PublisherCC og PurposeOneTreatment hvis de ikke ber om samtykke fra brukerne.Fra og med desember 2021 kommer vi ikke lenger til å sjekke feltet |
1.3 | Det ble gitt samtykke til formål 1, men det mangler juridisk grunnlag for grunnleggende annonser. |
Sjekk om brukeren med vilje har avvist berettigede interesser for de andre formålene, eller om dette kan skyldes feil med implementeringen av CMP-en. |
Feilkonfigurering
Annonseforespørsler blir ikke besvart så lenge det finnes feil med konfigurasjonen.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
2.1a | Tagger eller SDK-er mottar ingen ÅS-streng fordi CMP-statusen er stub , loading eller error . |
Hvis du manuelt kaller opp funksjonen som ber om annonser, må du sørge for at svaret som returneres, er Hvis du ikke manuelt kaller opp funksjonen som ber om annonser, må du samarbeide med CMP-leverandøren din om å sørge for at de implementerer støtte for |
2.1b |
Begge vilkårene er innfridd:
|
Be CMP-leverandøren din om å påse at API-ene deres er korrekt implementert i henhold til IABs tekniske spesifikasjon for TCF. |
2.2a |
ÅS-strengen kan ikke parses fordi den ikke er gjort om til base64-kode. Eksempel: |
Plattformer for samtykkestyring (eller publisister) skal utelukkende overføre data som er gjort om til base64-kode, via gdpr_consent= parametere. |
2.2b |
ÅS-strengen kan ikke parses på grunn av en dekodingsfeil. Eksempel: inneholder feil antall bit |
CMP-en må korrigere feilene med implementeringen av ÅS-strengen. |
2.2c |
ÅS-strengen kan ikke parses på grunn av en datafeil. Eksempel: feil tidsstempel – leverandør-ID-en er for lang |
CMP-en må korrigere feilene med implementeringen av ÅS-strengen. |
Problemer med ÅS-strengen
Dette inkluderer problemer med ÅS-strengen som er knyttet til en annonseforespørsel. Resultatet blir tapte og ubesvarte annonseforespørsler.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
3.1 | CMP-ID-en er ugyldig. |
Sørg for at du bruker en CMP som er godkjent av IAB, og at ID-en er riktig angitt i ÅS-strengene. Hvis en CMP var gyldig da en ÅS-streng ble generert, men senere ble slettet av IAB, må du innhente samtykke på nytt via en gyldig CMP. |
3.2 | Ikke lenger i bruk. | Ingen. Forrige betydning: ÅS-strengen ble opprettet for over 13 måneder siden. |
Samtykke må innhentes på nytt
Du må innhente samtykke fra brukeren på nytt. Hvis du bruker en versjon av GLV-en der Google ikke var oppført ennå, må du innhente samtykke på nytt, ellers blir ikke annonseforespørsler besvart.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
3.3 | Ikke lenger i bruk. |
Ingen. Tidligere betydning: ÅS-strengen ble sist oppdatert for over 13 måneder siden. |
4.1 | ÅS-strengen ble generert med en versjon av GVL der Google ennå ikke var oppført. | Innhent samtykke på nytt med en oppdatert versjon av GVL-en. |
Globalt omfang og eksternt omfang
Nedenfor ser du problemer knyttet til globalt omfang eller eksternt omfang (Ad Manager, AdMob, AdSense). Annonser blir ikke vist dersom ÅS-strengen indikerer globalt eller eksternt omfang.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
5.1 | ÅS-strengen tillater samtykke i eksterne kanaler. | Be CMP-en om å fjerne eksterne signaler fra ÅS-strengene. |
5.2 | ÅS-strengen har et globalt omfang. | Be CPM-en om å oppdatere ÅS-strengene til å være tjenestespesifikke. |
Begrenset annonselevering
Begrensede annonser vises.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
6.1 | Versjon 1 /1.1 av ÅS-strengen brukes (v1.0-streng). |
CMP-en skal overføre versjon 2.2 av TCF-strengene. |
Google håndterer problemer
Når disse problemene oppstår, blir de håndtert av Google, og normal TCF-håndtering fortsetter.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
7.1 | Feltet gdprApplies er ikke definert eller er tilordnet en ugyldig eller uleselig verdi, men en gyldig ÅS-streng er inkludert. |
Ikke aktuelt |
7.2 | ÅS-strengen ble generert med en GVL-versjon som er nyere enn den versjonen Googles teknologi for annonselevering har registrert. | Ikke aktuelt |
7.3 | Noen formål, funksjoner og/eller leverandører er utenfor rekkevidde (ukjent). | Ikke aktuelt |
7.4 | ÅS-strengen har en eldre tcf_policy_version enn den nyeste GVL-en (globale leverandørlisten). |
Plattformen for samtykkestyring må slette den gamle ÅS-strengen og innhente samtykke på nytt via den nyeste GVL-en. |
7.5 |
En forespørsel har |
Ikke aktuelt |
7.6 | Publisistens landskode er ugyldig, men samtykke til formål 1 er inkludert. | CMP-en må korrigere feilene med implementeringen av ÅS-strengen. |
7.7 | Språkkoden er ugyldig. | CMP-en må korrigere feilene med implementeringen av ÅS-strengen. |
7.8 | I feltet for ÅS-strengversjon er verken 1 eller 2 oppgitt. |
CMP-en må korrigere feilene med implementeringen av ÅS-strengen ved å be om nytt samtykke hvis en ugyldig ÅS-streng registreres. Hvis du bruker en av Googles løsninger for samtykkestyring og UMP SDK i appen din, kan du sjekke at dette SDK-et er riktig implementert, og at |
7.9 | Verken 1 eller 2 er oppgitt som ES-strengversjon. |
CMP-en må oppgi 1 eller 2 som ES-strengens versjon. |
Problemer med ES-strenger
Når slike problemer oppstår, anser Google strengen for ekstra samtykke (ES-strengen) som ugyldig, og bare de leverandørene som er inkludert i ÅS-strengen, blir vurdert.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
8.1 | Versjonsseparatoren (~ ) brukes ikke i ES-strengen. |
Plattformen for samtykkestyring skal bruke «~ » som det andre tegnet i ES-strengen for å skille versjonsnummeret fra listen over leverandørene som har gitt samtykke. |
8.2 | ES-strengen inneholder en liste over leverandører som ikke har den forventede formateringen (liste over int64-tegn atskilt med «.»). | CMP-en må korrigere feilene med implementeringen av ES-strengen. |
CMP-sertifisering
Når slike problemer oppstår, prøver Google å vise annonser som ikke er personlig tilpasset.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
9.1 | CMP-en for TCF som er oppgitt i forespørselen, er ikke sertifisert av Google. | CMP-en må være sertifisert av Google. |
Ingen TCF-signaler i annonseforespørsler
Når slike problemer oppstår, prøver Google å vise begrensede annonser.
Feil | Beskrivelse | Foreslått tiltak |
---|---|---|
10.1 |
Forespørselen er fra EØS, Sveits eller Storbritannia, men mangler TCF-signaler. |
Publisister må integrere med en CMP med TCF-integrering som er sertifisert av Google. |