Rješavanje problema s implementacijom verzije 2.2 IAB-ovog Okvira za transparentnost i pristanak za Europsku uniju

IAB je najavio verziju 2.2 svojeg Okvira za transparentnost i pristanak (TCF) 16. svibnja 2023. Google kao dobavljač počet će prihvaćati TC nizove koji koriste TCF 2.2 od 11. srpnja 2023. Svi zahtjevi s nizovima TCF-a 2.2 poslanim prije tog datuma mogu rezultirati pogreškama.

• TCF 2.1: nastavit ćemo prihvaćati nizove TCF-a 2.1, ali preporučujemo da CMP-ovi slijede IAB-ove smjernice o pragovima implementacije dok se djelatnost prebacuje na TCF 2.2.
• Googleova rješenja za upravljanje pristankom: planira se da Googleova rješenja za upravljanje pristankom, dostupna na kartici Upravljanje privatnošću i porukama o privatnosti u Ad Manageru, AdSenseu i AdMobu, počnu podržavati TCF 2.2 za poruke za traženje pristanka za GDPR do početka studenog, u skladu s IAB-ovim ažuriranim rokom za implementaciju CMP-ova (20. studenog 2023.).

IAB Europe dovršio je verziju 2.0 Okvira za transparentnost i pristanak, koji je razvio u suradnji s organizacijom IAB Tech Lab i zajedničkim tvrtkama članicama. Google sada u potpunosti podržava verziju 2.0 TCF-a.

Kako bi izdavačima dao vremena za upravljanje pogreškama i pogrešnim konfiguracijama povezanim s pokretanjem verzije 2.0 Okvira za transparentnost, Google će im pripremiti izvješće o otkrivenim pogreškama i odobriti 150-dnevno razdoblje odgode za otklanjanje pogrešaka.

---

U ovom članku pronaći ćete više informacija o tome kako riješiti pogreške u implementaciji verzije 2.2 Okvira za transparentnost i pristanak, uključujući sljedeće:

• Ažurirane smjernice
• Centar za pravila
• Izvješće o pogrešci
• Rješavanje problema

 

---

Ažurirane smjernice

Ažuriranja

• Podsjetnik o zahtjevu TCF-a za ponovno dobivanje pristanka svakih 13 mjeseci: 

  You are required by IAB TCF policy to remind users about their consent choices at least once every 13 months. If the consent decision is more than 13 months old, the TC string will no longer be considered valid by Google and Google will not serve ads to that user. We suggest that you work with your CMP to remind users about their consent choices before the 13-month limit is reached.

• Uklonjena je vrsta pogreške 3.2. TC nizovi koji su ažurirani u posljednjih 13 mjeseci ostat će važeći.

Otklanjanje uobičajenih pogrešaka

Ispravite neke od najčešćih pogrešaka u Ad Manageru, AdSenseu i AdMobu poduzimanjem sljedećih radnji:

Razmislite o ponovnom pristanku za korisnike s TC nizovima koji se neće unovčavati.
^{(Pogreške 1.1, 3.1, 4.1, 5.1, 5.2 i 6.1).}

Povezane pogreške

Pogreška 1.1. Ove se smjernice mogu primijeniti i na pogreške3.1, 4.1, 5.1, 5.2 i6.1.

Ažurirane smjernice

Razmislite o ponovnom traženju pristanka korisnika.

Obrazloženje

Izdavači će moći ponovno zatražiti pristanak ako su prethodno upotrebljavali nizove s izvanrednim ili globalnim opsegom, nevažećim ID-jevima CMP-a (iz testiranja), nevažećim ID-jevima GVL-a (iz testiranja) ili nisu imali Google kao dobavljača s odgovarajućim pristankom u određenom trenutku tijekom njihove implementacije.

Pogreške 1.1, 1.2, 1,3: važno je provjeriti jesu li pogreške uočene na značajnoj količini prometa. Ako je tako, imajte u vidu da možda postoji problem na strani CMP-a i pobrinite se da Google dobije pristanak za potrebne svrhe te da bude dobavljač i za pristanak i za legitimni interes (ID dobavljača 755).

IAB-ova specifikacija

U skladu s IAB-ovim specifikacijama CMP-ovi mogu predmemorirati nizove pristanka na 13 mjeseci.

Neki CMP-ovi ranije su zadržavali datum prvog pristanka i produljivali pristanak; to nije pravilno. Datum pristanka trebao bi uvijek biti novi datum određenog niza pristanka.

Prijedlog: neka vaš CMP vraća pozive iz odjeljka AddEventHandler u roku od 500 ms
^{(pogreške 2.1a, 2.1b, 2.0a, 2.0b i 2.0c)}

Povezane pogreške

Pogreška 2.1a. Ove se smjernice mogu primijeniti i na pogreške 2.1b, 2.0a, 2.0b i 2.0c.

Ažurirane smjernice

Iako više nema uvjeta u pogledu vremena čekanja, predlažemo da CMP-ovi pažljivo pregledavaju svoju implementaciju kako bi se omogućilo da odmah uzvrate na pozive upućene funkciji getTCData u AddEventListeneru. 

Ako se CMP ne odazove, zahtjev može ostati neunovčen.

Obrazloženje

Google se pridržava IAB-ove specifikacije, koja navodi da CMP mora odmah odgovoriti na funkciju AddEventListener. Ako se CMP odmah ne odazove, zahtjev može ostati neunovčen.

Osim toga, odzivi CMP-a dio su lanca događaja koji utječu na brzinu slanja zahtjeva za oglas. Skraćivanje vremena između učitavanja stranice i zahtjeva za oglase dovodi do smanjenja broja izgubljenih pojavljivanja za izdavača. 

IAB-ova specifikacija

Primjenjiva IAB-ova specifikacija: IAB AddEventListener (na GitHubu)

Povratni poziv AddEventListener treba se pozvati odmah nakon registracije za trenutačnu verziju TC podataka, čak i ako je status CMP-aloading, a CMP sadržava nepotpune TC podatke. To skripti za pozive omogućuje da pristupi registriranom identifikatoru listenerId. Štoviše, pri svakoj promjeni TC niza trebao bi se uspostaviti povratni poziv ako nije uklonjen pomoću funkcije RemoveEventListener.

Centar za pravila

Centar za pravila obavijestit će izdavače ako aplikacija ili web-lokacija nisu usklađene s Googleovim zahtjevima za upravljanje pristankom.

Izvješće o pogrešci

Obavijestit ćemo izdavače putem korisničkog sučelja proizvoda ako otkrijemo poteškoću u TC nizu povezanu s jednom ili više web-lokacija ili aplikacija izdavača. Na stranici Pristanak za korisnike u EU-u na svojem računu izdavači s pogreškama mogu kliknuti Preuzmi izvješće o pogreškama u TCF-u da bi preuzeli detaljno izvješće o pogreškama koje su otkrivene u posljednjih sedam dana.

Izvješće je dostupno samo ako je do pogrešaka došlo tijekom posljednjih sedam dana.

Da biste pristupili stranici Pristanak za korisnike u EU-u i izvješću o pogreškama u TCF-u, učinite sljedeće: 

• Ad Manager: kliknite Administrator Pristanak za korisnike u EU-u.
• AdMob i AdSense: kliknite Kontrole za blokiranje  Pristanak za korisnike u EU-u.

Izvješće će sadržavati sljedeće podatke o svakoj otkrivenoj pogrešci: 

• Domena/MobileAppID: web-lokacija ili mobilna aplikacija koja je pogrešno konfigurirana.
• Put oglasne jedinice: oglasna jedinica povezana s pogreškom.
• Kôd pogreške: kôd koji se dodjeljuje pogrešci. 
• Broj pogrešaka: broj upita koji sadrže pogrešku zabilježenih tijekom prethodnog tjedna.
• Datum zadnjeg otkrivanja: zadnji datum otkrivanja pogreške. 

Izdavači mogu upotrebljavati kodove pogrešaka navedene u izvješću kako bi u sljedećim tablicama za rješavanje problema pronašli predložene radnje koje treba poduzeti i ispravili pogreške.

Rješavanje problema

Da bismo izdavačima olakšali ispravljanje pogrešno konfiguriranih integracija IAB-ovog TCF-a 2.2, sastavili smo sljedeće tablice najčešćih vrsta pogrešaka TC nizova i odgovarajuće preporuke za rješavanje problema.

Upotrijebite sljedeće tablice kako biste razumjeli probleme koji se javljaju na razini zahtjeva za oglas, kao i odgovarajuće ponašanje sustava.

Scenariji ograničenog pristanka

Sva tri slučaja uvijek će imati prednost pred pogreškama u konfiguraciji, čak i ako određeni zahtjev sadrži više pogrešaka.

Primjer	Opis	Predložena radnja za poduzimanje
1.1	Google, kao dobavljač, nije dobio dopuštenje na temelju pristanka ili legitimnog interesa.	Potvrdite je li korisnik namjerno odbio Google kao dobavljača, je li došlo do pogrešaka u implementaciji CMP-a ili postoje ograničenja za izdavače.
1.2	Nema pristanka za Svrhu 1 za zemlje EGP-a i Ujedinjeno Kraljevstvo.	Potvrdite je li korisnik namjerno onemogućio Svrhu 1 ili je uzrok tome pogreška u implementaciji CMP-a. Izdavači u Švicarskoj trebaju osigurati da su ispravno postavili polja PublisherCC i PurposeOneTreatment ako od korisnika ne traže pristanak.    Od prosinca 2021. više nećemo provjeravati postavke PurposeOneTreatment za zahtjeve za oglase koji potječu iz Njemačke u skladu s njemačkim Zakonom o zaštiti podataka u telekomunikaciji i elektroničkim medijima.
1.3	Postoji pristanak za Svrhu 1, ali mu nedostaju pravne osnove za Osnovne oglase.	Potvrdite je li korisnik namjerno odbio legitimne interese za druge svrhe ili je do toga došlo zbog pogrešaka u implementaciji CMP-a.

Pogrešna konfiguracija

Zahtjevi za oglase neće se ispuniti dok postoje pogreške u vidu pogrešne konfiguracije.

Pogreška	Opis	Predložena radnja za poduzimanje
2.1a	Oznaka ili SDK ne prima TC niz jer je status CMP-a zamjenski kôd, učitavanje ili pogreška.	Ako ručno pozivate funkciju za zahtijevanje oglasa, provjerite je li odgovor na getTCData TCData.eventStatus = 'tloadload' ILI 'cmpuishow' + 'useractioncomplete'. To pokazuje da je CMP spreman korisnicima pružiti izbor u vezi s pristankom. Ako funkciju za zahtijevanje oglasa ne pozivate ručno, poduzmite radnje preko CMP-a kako biste bili sigurni da će implementirati podršku za getTCData i vratiti TCData.eventStatus = 'tcloaded' ILI 'cmpuishown' + 'useractioncomplete' kako biste naznačili da je pristanak korisnika spreman za upotrebu putem API-ja.
2.1b	Oba su uvjeta ispunjena: CMP-ovi su postavljeni & gdpr=1 & gdpr_conount= prisutan je u zahtjevu, ali je TC niz prazan.	Zatražite od CMP-a da provjeri jesu li API-ji ispravno implementirani na temelju IAB-ovih tehničkih specifikacija za TCF.
2.0a	TC niz ne može se raščlaniti jer nije kodiran algoritmom base64. Primjer: "2"	CMP-ovi (ili izdavači) trebaju slati samo podatke kodirane algoritmom base64 u parametrima gdpr_concent=.
2.0b	TC niz ne može se raščlaniti zbog pogreške u dekodiranju. Primjer: uključuje netočan broj bitova	CMP treba ispraviti pogreške u implementaciji TC niza.
2.0c	TC niz ne može se raščlaniti zbog pogreške podataka. Primjer: netočna vremenska oznaka, ID dobavljača je prevelik	CMP treba ispraviti pogreške u implementaciji TC niza.

Problemi s TC nizom

Problemi s TC nizom povezanim sa zahtjevom za oglas. Zahtjevi za oglase uklonit će se i neće se ispuniti.

Pogreška	Opis	Predložena radnja za poduzimanje
3.1	Nevažeći CMP ID.	Provjerite upotrebljava li se CMP koji je potvrdio IAB i je li njegov ID ispravno postavljen u TC nizovima. Ako je CMP bio važeći kada je generiran TC niz, ali ga je IAB kasnije izbrisao, morate ponovo dobiti pristanak koristeći važeći CMP.
3.2	Više se ne upotrebljava.	Ništa. Prethodno značenje: datum izrade TC niza bio je prije više od 13 mjeseci.

Potrebno je ponovno dobiti pristanak

Pristanak se mora dobiti od korisnika. Ako ste pristanak korisnika dobili prije više od 13 mjeseci ili upotrebljavate verziju GVL-a u kojoj Google još nije bio naveden, trebate ponovno dobiti pristanak korisnika jer će se u suprotnom zahtjevi za oglase izostaviti i neće se ispuniti.

Pogreška	Opis	Predložena radnja
3.3	Datum zadnjeg ažuriranja TC niza bio je prije više od 13 mjeseci.	CMP treba izbrisati stari TC niz i ponovno dobiti pristanak. Očekuje se da se mali broj tih pogrešaka može pojaviti ako se zahtjevi za oglase pošalju s isteklim TC nizom prije nego što CMP poništi i ponovno dobije pristanak korisnika. Ako u svojoj aplikaciji upotrebljavate Googleove alate za upravljanje pristankom korisnika i UMP SDK, provjerite je li UMP SDK ispravno implementiran i poziva li se requestConsentInfoUpdate pri svakom pokretanju aplikacije.
4.1	TC niz generiran je pomoću verzije GVL-a u kojoj Google još nije bio naveden na popisu.	Ponovno pribavite pristanak pomoću trenutačne verzije GVL-a.

Globalni opseg i izvanredni opseg

Problemi povezani s globalnim opsegom i izvanrednim opsegom (Ad Manager, AdMob, AdSense). Oglasi se neće posluživati ako TC niz navodi "izvanredni" ili "globalni opseg".

Pogreška	Opis	Predložena radnja
5.1	TC niz omogućuje pristanak za izvanredni opseg.	Dajte uputu CMP-u da ukloni izvanredne signale iz TC nizova.
5.2	TC niz u globalnom opsegu.	Dajte uputu CMP-u da ažurira TC nizove tako da budu prilagođeni određenim uslugama.

Ograničeno posluživanje oglasa

Posluživat će se ograničeni oglasi.

Pogreška	Opis	Predložena radnja
6.1	Verzija TC niza je 1 ili 1.1 (niz 1.0).	CMP treba slati nizove TCF-a 2.2.

Google će rješavati probleme

Kada dođe do tih problema, Google će po potrebi primijeniti olakotne okolnosti za problem i nastaviti s normalnim postupanjem s TCF-om.

Pogreška	Opis	Predložena radnja
7.1	Parametar gdprApplies nije definiran ili je postavljen na nevažeću vrijednost ili vrijednost koja se ne može dešifrirati, no prisutan je važeći TC niz.	Nije primjenjivo
7.2	TC niz generiran je pomoću verzije GVL-a koja je novija od trenutačne verzije poznate Googleovoj tehnologiji posluživanja oglasa.	Nije primjenjivo
7.3	Neke svrhe, značajke i/ili dobavljači nalaze se izvan raspona (nepoznato).	Nije primjenjivo
7.4	TC niz ima stariju verziju tcf_policy_version od najnovijeg GVL-a.	CMP treba izbrisati stariji TC niz i ponovo pribaviti pristanak pomoću najnovijeg GVL-a.
7.5	Zahtjev sadrži &gdpr=1, ali URL zahtjeva uopće ne sadrži parametar &gdpr_consent.	Nije primjenjivo
7.6	Kôd države izdavača nije važeći, ali postoji pristanak za Svrhu 1.	CMP treba ispraviti pogreške u implementaciji TC niza.
7.7	Nevažeći kôd jezika.	CMP treba ispraviti pogreške u implementaciji TC niza.
7.8	Polje verzije TC niza nije 1 ni 2.	CMP treba ispraviti pogreške u implementaciji TC niza tako da zatraži novi pristanak ako se otkrije nevažeći TC niz. Ako u svojoj aplikaciji upotrebljavate Googleove alate za upravljanje pristankom korisnika i UMP SDK, provjerite je li UMP SDK ispravno implementiran i poziva li se requestConsentInfoUpdate pri svakom pokretanju aplikacije.
7.9	Verzija niza dodatnog pristanka nije 1 ni 2.	CMP treba postaviti verziju niza dodatnog pristanka na 1 ili 2.

Problemi s nizom dodatnog pristanka

Kada dođe do tih problema, Google će niz dodatnog pristanka (AC) smatrati nevažećim, a u razmatranje neće uzeti dodatne dobavljače izvan TC niza.

Pogreška	Opis	Predložena radnja
8.1	Niz dodatnog pristanka ne upotrebljava razdjelnik verzije (~).	CMP treba upotrebljavati "~" kao drugi znak niza dodatnog pristanka kojim se broj verzije odvaja od popisa dobavljača koji su dobili pristanak.
8.2	Niz dodatnog pristanka sadrži popis dobavljača koji ne slijedi očekivano formatiranje (popis vrijednosti int64 odvojenih točkom '. ')	CMP treba ispraviti pogreške u implementaciji niza dodatnog pristanka.