- TCF:n versio 2.1: Hyväksymme jatkossakin TCF-versiota 2.1 käyttävät merkkijonot, mutta suosittelemme, että suostumustenkäsittelyalustat (CMP) seuraavat IAB:n ohjeissa kerrottua käyttöönottoaikataulua, kun alalla siirrytään käyttämään TCF-versiota 2.2.
- Googlen suostumustyökalut: Googlen suostumustyökalut, jotka ovat käytettävissä Ad Managerin, AdSensen ja AdMobin Yksityisyys ja viestit ‐välilehdellä, tukevat TCF-versiota 2.2 eurooppalaisia asetuksia koskevissa viesteissä, mikä vastaa IAB:n päivitettyjä, CMP:itä koskevia vaatimuksia.
Haluamme auttaa julkaisijoita korjaamaan IAB Europen läpinäkyvyys- ja suostumuskehyksen (TCF) version 2.2 lanseeraukseen liittyvät virheet ja virheelliset määritykset, joten tarjoamme käytettäväksi raportin havaitsemistamme virheistä.
Tässä artikkelissa on lisätietoa TCF-version 2.2 toteutusvirheiden korjaamisesta. Sisällys:
Päivitetyt ohjeet
Ohjeita yleisten virheiden korjaamiseen
Näin korjaat joitakin yleisiä Ad Manageriin, AdSenseen ja AdMobiin liittyviä virheitä:
Harkitse suostumuksen pyytämistä uudelleen TC-merkkijonojen avulla sellaisilta käyttäjiltä, joille sisältöä ei kaupallisteta(virheet 1.1, 3.1, 4.1, 5.1, 5.2 ja 6.1)
Muut vastaavanlaiset virheet
Päivitetyt ohjeet
Harkitse suostumuksen pyytämistä käyttäjiltä uudelleen.
Perustelut
Julkaisijat hyötyvät suostumuksen pyytämisestä uudelleen, jos ne ovat aiemmin käyttäneet globaalia ja ulkopuolista laajuutta hyödyntävää merkkijonoa tai virheellisiä CMP- tai GVL-tunnuksia (testauksesta) tai jos ne eivät ole jossakin toteutuksensa vaiheessa merkinneet Googlea palveluntarjoajaksi, jolla on asianmukainen suostumus.
Virheet 1.1, 1.2 ja 1.3: On tärkeää tarkistaa, koskevatko nämä virheet merkittävää määrää liikenteestä. Jos näin on, ota huomioon, että virhe voi olla CMP:n puolella, ja varmista, että Googlelle on palveluntarjoajana annettu suostumus tarvittaviin käyttötarkoituksiin JA että Googlella on oikeutettu etu (palveluntarjoajan tunnus 755).
IAB:n spesifikaatio
IAB:n spesifikaation mukaan CMP:t voivat säilyttää suostumusmerkkijonoja välimuistissa 13 kuukauden ajan.
AddEventHandler-kutsut 500 ms:n kuluessa(virheet 2.1a, 2.1b, 2.0a, 2.0b ja 2.0c)
Muut vastaavanlaiset virheet
Virhe 2.1a. Näitä ohjeita voidaan myös soveltaa virheisiin 2.1b, 2.0a, 2.0b ja 2.0c.
Päivitetyt ohjeet
Aikarajavaatimusta ei enää ole, mutta suosittelemme CMP-toimittajia kuitenkin tarkistamaan toteutuksensa huolellisesti, jotta AddEventListener getTCData ‑kutsut palautetaan varmasti heti.
Jos CMP ei vastaa, kaupallistamispyyntö voi jäädä täyttämättä.
Perustelut
Google noudattaa IAB:n spesifikaatiota, jonka mukaan CMP:n on vastattava AddEventListener-funktiolle heti. Jos CMP ei vastaa heti, kaupallistamispyyntö voi jäädä täyttämättä.
Lisäksi CMP-vastaukset ovat osa sellaisten tapahtumien ketjua, jotka vaikuttavat siihen, miten pian mainospyyntö voidaan tehdä. Sivun latauksen ja mainospyyntöjen välisen ajan lyheneminen tarkoittaa vähemmän menetettyjä impressioita julkaisijalle.
IAB:n spesifikaatio
Sovellettava IAB:n spesifikaatio: IAB:n AddEventListener-määritys (GitHubissa)
AddEventListener-vastakutsu tulee tehdä heti nykyisen TC-datan rekisteröinnin jälkeen, vaikka CMP:n tilana olisi loading (ladataan) ja CMP:n TC-data olisi puutteellista. Tällöin kutsuvalla skriptillä on pääsy sen rekisteröityyn listenerId-tunnukseen. Lisäksi vastakutsu tulee tehdä jokaisen TC-merkkijonon muutoksen yhteydessä, ellei sitä poisteta käyttämällä RemoveEventListener-funktiota.Käytäntökeskus
Julkaisijat näkevät Käytäntökeskuksessa ilmoituksen, jos sovellus tai sivusto ei ole Googlen suostumustenkäsittelyvaatimusten mukainen.
Virheraportti
Ilmoitamme julkaisijalle tuotteen käyttöliittymässä, mikäli havaitsemme TC-merkkijonossa ongelman, joka koskee yhtä tai useampaa julkaisijan sivustoa tai sovellusta. Julkaisija voi klikata tilinsä "EU-käyttäjäsuostumus"-sivulta Lataa TCF-virheraportti nähdäkseen yksityiskohtaisen raportin virheistä, jotka on havaittu seitsemän viime päivän aikana.
- Ad Manager: Klikkaa Järjestelmänvalvoja ja sitten EU-käyttäjäsuostumus.
- AdMob: Klikkaa Estoasetukset ja sitten Ylläpidä eurooppalaisia asetuksia.
- AdSense: Klikkaa Bränditurvallisuus. Klikkaa Sisältö, Estoasetukset ja sitten Eurooppalaisten asetusten hallinta.
Raportti sisältää seuraavat tiedot kaikista havaituista virheistä:
- Verkkotunnus/MobileAppID: Virheellisesti määritetty sivusto tai mobiilisovellus.
- Mainosyksikön polku: Virheeseen liittyvä mainosyksikkö.
- Virhekoodi: Virheelle annettu koodi.
- Virheiden määrä: Niiden kyselyjen määrä, joissa virhe esiintyi ja jotka havaittiin edellisen viikon aikana.
- Havaittu viimeksi: Viimeinen päivä, jolloin virhe on havaittu.
Julkaisijat voivat etsiä alla olevista vianetsintätaulukoista raportin virhekoodeja vastaavat suositellut toimenpiteet ja korjata virheet niiden avulla.
Ohjeita ongelmatilanteisiin
Auttaaksemme julkaisijoita korjaamaan virheellisesti määritettyjä TCF-version 2.2 integrointeja olemme koonneet alla oleviin taulukoihin yleisimmät TC-merkkijonoon liittyvät virhetyypit ja suositukset ongelmien ratkaisemiseksi.
Taulukot auttavat ymmärtämään mainospyyntötasolla esiintyviä virheitä ja järjestelmän toimintaa näissä tilanteissa.
Rajoitetun suostumuksen mukaiset tilanteet
Kaikki nämä kolme tilannetta ovat aina etusijalla määritysvirheisiin nähden, vaikka jossakin pyynnössä olisi useita virheitä.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 1.1 | Googlelle palveluntarjoajana ei ole annettu suostumusta tai sillä ei ole oikeutettua etua. | Tarkista, onko käyttäjä evännyt tarkoituksellisesti Googlen palveluntarjoajana, onko CMP toteutettu virheellisesti tai onko käytössä julkaisijarajoituksia. |
| 1.2 | Ei suostumusta käyttötarkoitukselle 1 ETA-maissa, Yhdistyneessä kuningaskunnassa ja Sveitsissä. |
Tarkista, onko käyttäjä evännyt tarkoituksellisesti käyttötarkoituksen 1 tai onko CMP toteutettu virheellisesti. Sveitsiläisten julkaisijoiden tulee varmistaa, että
PublisherCC- ja PurposeOneTreatment-kentät on määritetty oikein, jos käyttäjiltä ei pyydetä suostumusta.Joulukuusta 2021 alkaen emme enää tarkista |
| 1.3 | Käyttötarkoitukselle 1 on suostumus, mutta oikeusperusteet tavallisille mainoksille puuttuvat. |
Tarkista, onko käyttäjä tarkoituksellisesti evännyt oikeutetun edun muiden käyttötarkoitusten osalta tai onko CMP toteutettu virheellisesti. |
Virheellinen määritys
Jos näitä ongelmia ilmenee, Google pyrkii käyttämään rajoitettua mainontaa.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 2.1a | Tagi tai SDK ei vastaanota TC-merkkijonoa, koska CMP:n status on stub, loading tai error. |
Jos käynnistät funktion manuaalisesti mainosten pyytämistä varten, huolehdi siitä, että Jos et kutsu funktiota manuaalisesti mainosten pyytämistä varten, huolehdi siitä, että CMP ottaa käyttöön |
| 2.1b |
Molemmat ehdot täyttyvät:
|
Pyydä CMP:tä varmistamaan, että sovellusliittymät on toteutettu oikein IAB:n läpinäkyvyys- ja suostumuskehyksen teknisten vaatimusten mukaisesti. |
| 2.2a |
TC-merkkijonoa ei voida jäsentää, koska sitä ei ole base64-koodattu. Esimerkki: |
CMP-toimittajien (tai julkaisijoiden) tulisi lähettää gdpr_consent=-parametreissa vain base64-koodattua dataa. |
| 2.2b |
TC-merkkijonoa ei voida jäsentää koodin purkamisessa tapahtuneen virheen vuoksi. Esimerkki: Bittimäärä on virheellinen |
CMP-toimittajan on korjattava TC-merkkijonon toteutusvirheet. |
| 2.2c |
TC-merkkijonoa ei voida jäsentää datavirheen vuoksi. Esimerkkejä: Virheellinen aikaleima, liian pitkä palveluntarjoajan tunnus |
CMP-toimittajan on korjattava TC-merkkijonon toteutusvirheet. |
TC-merkkijonon ongelmat
Nämä ovat mainospyyntöön liittyvän TC-merkkijonon yhteydessä esiintyviä ongelmia. Jos näitä ongelmia ilmenee, Google pyrkii käyttämään rajoitettua mainontaa.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 3.1 | Virheellinen CMP-tunnus |
Varmista, että käytössä on IAB:n validoima CMP ja että sen tunnus on lisätty TC-merkkijonoihin oikein. Jos CMP oli validoitu TC-merkkijonon luomisen aikaan mutta IAB on sittemmin poistanut CMP:n, suostumusta on pyydettävä uudelleen käyttämällä validoitua CMP:tä. |
| 3.2 | Ei enää käytössä | Ei mitään. Aiempi merkitys: TC-merkkijono on luotu yli 13 kuukautta sitten. |
Suostumusta on pyydettävä uudelleen
Käyttäjältä on pyydettävä suostumusta uudelleen. Jos Googlea ei löydy käyttämästäsi GVL-versiosta, sinun on pyydettävä suostumusta uudelleen. Muuten Google pyrkii käyttämään rajoitettua mainontaa.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 3.3 | Ei enää käytössä |
Ei mitään. Aiempi merkitys: TC-merkkijono on päivitetty viimeksi yli 13 kuukautta sitten. |
| 4.1 | TC-merkkijono on luotu käyttämällä GVL-versiota, jossa Google ei ollut vielä mukana. | Pyydä suostumusta uudelleen käyttämällä ajantasaista GVL-versiota. |
Globaali ja ulkopuolinen laajuus
Seuraavat ongelmat liittyvät globaaliin ja ulkopuoliseen laajuuteen (Ad Manager, AdMob, AdSense). Jos näitä ongelmia ilmenee, Google pyrkii käyttämään rajoitettua mainontaa.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 5.1 | TC-merkkijono sallii TCF:n ulkopuolisen suostumuksen. | Pyydä CMP-toimittajaasi poistamaan TC-merkkijonoista ulkopuolista suostumusta koskevat signaalit. |
| 5.2 | TC-merkkijono, jossa on käytetty globaalia laajuutta | Pyydä CMP-toimittajaasi päivittämään TC-merkkijonot palvelukohtaisiksi. |
Mainosten näyttö rajallista
Mainoksia näkyy rajoitetusti.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 6.1 | TC-merkkijonon versio on 1 tai 1.1 (version 1.0 merkkijono). |
CMP:n tulee lähettää TCF-version 2.2 merkkijonoja. |
Google käsittelee ongelmat
Google ratkaisee ongelmat tarvittaessa itse ja jatkaa normaalia TCF-käsittelyä.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 7.1 | gdprApplies-parametria ei ole määritetty tai sen arvo on virheellinen tai ei tulkittavissa, mutta hyväksyttävä TC-merkkijono on käytössä. |
– |
| 7.2 | TC-merkkijono on luotu käyttämällä sellaista GVL-versiota, joka on uudempi kuin Googlen mainosten näyttöteknologian tunnistama nykyinen versio. | – |
| 7.3 | Jotkin käyttötarkoitukset, ominaisuudet tai toimittajat ovat tuntemattomia. | – |
| 7.4 | TC-merkkijonon tcf_policy_version on vanhempi kuin uusin GVL-versio. |
CMP-toimittajan on poistettava vanhempi TC-merkkijono, ja suostumusta on pyydettävä uudelleen käyttämällä uusinta GVL-listaa. |
| 7.5 |
Pyynnössä on |
– |
| 7.6 | Julkaisijan maatunnus on virheellinen, mutta suostumus käyttötarkoitukseen 1 on olemassa. | CMP-toimittajan on korjattava TC-merkkijonon toteutusvirheet. |
| 7.7 | Kielikoodi on virheellinen. | CMP-toimittajan on korjattava TC-merkkijonon toteutusvirheet. |
| 7.8 | TC-merkkijonon versiokenttä ei sisällä lukua 1 tai 2. |
CMP-toimittajan on korjattava TC-merkkijonon toteutusvirheet pyytämällä suostumusta uudelleen, jos virheellinen TC-merkkijono havaitaan. Jos käytät Googlen suostumustyökaluja ja UMP SDK:ta sovelluksessasi, varmista, että UMP SDK on otettu oikein käyttöön ja että |
| 7.9 | AC-merkkijonon versio ei ole 1 tai 2. |
CMP:n on asetettava AC-merkkijonon versioksi 1 tai 2. |
AC-merkkijonon ongelmat
Jos näitä ongelmia ilmenee, Google katsoo lisäsuostumuksen merkkijonon (AC-merkkijonon) virheelliseksi ja vain TC-merkkijonon palveluntarjoajat otetaan huomioon.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 8.1 | AC-merkkijonossa ei käytetä versionumeron erottavaa merkkiä (~). |
CMP-toimittajan on käytettävä ~-merkkiä AC-merkkijonon toisena merkkinä. Se erottaa versionumeron suostumuksen saaneiden palveluntarjoajien listasta. |
| 8.2 | AC-merkkijonossa on palveluntarjoajien lista, joka ei ole odotetussa muodossa (int64-lista, jossa erotinmerkkinä käytetään pistettä). | CMP-toimittajan on korjattava AC-merkkijonon toteutusvirheet. |
CMP:n sertifiointi
Jos näitä ongelmia ilmenee, Google pyrkii näyttämään personoimattomia mainoksia.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 9.1 | Pyynnössä mainittu TCF-kehykseen integroitu CMP ei ole Googlen sertifioima. | CMP:n on oltava Googlen sertifioima. |
Mainospyynnöissä ei ole TCF-signaaleja
Jos näitä ongelmia ilmenee, Google pyrkii käyttämään rajoitettua mainontaa.
| Virhe | Kuvaus | Suositellut toimenpiteet |
|---|---|---|
| 10.1 | Pyyntö on peräisin ETA-alueelta, Yhdistyneestä kuningaskunnasta tai Sveitsistä tai se on manuaalisesti tagattu GDPR-täytäntöönpanoa varten gdpr=1-parametrilla, mutta pyynnössä ei ole TCF-signaaleja. |
Julkaisijan on integroitava TCF-kehykseen integroitu CMP, joka on Googlen sertifioima, ja/tai varmistettava, että gdpr=1-parametri asetetaan vain käyttäjille, joihin GDPR:ää sovelletaan. |