IAB ES PPI versijas 2.2 ieviešanas problēmu novēršana

Google kā pakalpojumu sniedzējs tagad pieņem PP virknes, izmantojot IAB ES PPI versiju 2.2.

• PPI versija 2.1: mēs turpināsim pieņemt PPI versijas 2.1 virknes, taču aicinām PPP ievērot IAB vadlīnijas par ieviešanas atskaites punktiem, nozares standartam mainoties uz PPI versiju 2.2.
• Google piekrišanas pārvaldības risinājumi: Google piekrišanas pārvaldības risinājumi, kas ir pieejami Ad Manager, AdSense un AdMob cilnē “Konfidencialitāte un ziņojumapmaiņa”, atbalsta PPI versiju 2.2 Eiropas regulu ziņojumiem saskaņā ar IAB atjauninātajām prasībām par PPP.

Lai palīdzētu izdevējiem novērst ar IAB Europe pārredzamības un piekrišanas ietvara versijas 2.2 darbības uzsākšanu saistītās kļūdas un konfigurācijas problēmas, mēs nodrošinām pārskatu par konstatētajām kļūdām.

---

Šajā rakstā ir sniegta plašāka informācija par PPI versijas 2.2 ieviešanas kļūdu novēršanu, tostarp tālāk minētajām tēmām.

• Atjauninātas norādes
• Politiku centrs
• Kļūdu pārskats
• Problēmu novēršana

---

Atjauninātas norādes

Atjauninājumi

• Atgādinājums par PPI prasību atkārtoti saņemt piekrišanu ik pēc 13 mēnešiem

  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.

• Kļūdas veids 3.2 ir noņemts. PP virknes, kas ir atjauninātas pēdējo 13 mēnešu laikā, joprojām būs derīgas.

Bieži sastopamo kļūdu labojumi

Dažas izplatītākās kļūdas pakalpojumos Ad Manager, AdSense un AdMob varat novērst, veicot tālāk norādītās darbības.

Apsveriet iespēju atkārtoti pieprasīt lietotāju piekrišanu, izmantojot PP virknes, kas negūs peļņu
^{(kļūdas 1.1, 3.1, 4.1, 5.1, 5.2 un 6.1)}

Saistītās kļūdas

Kļūda 1.1.Šī norāde var tikt piemērota arī kļūdām 3.1, 4.1, 5.1, 5.2 un 6.1.

Atjauninātās norādes

Apsveriet iespēju atkārtoti pieprasīt lietotāju piekrišanu.

Pamatojums

Izdevējiem būs lietderīgi atkārtoti pieprasīt piekrišanu, ja viņi iepriekš izmantojuši virknes ar ārpusjoslas vai vispārēju tvērumu, nederīgus PPP ID (no testēšanas) vai nederīgus GPSS ID (no testēšanas) vai ja uzņēmums Google kādā ieviešanas brīdī nav bijis norādīts kā pakalpojumu sniedzējs ar atbilstošu piekrišanas statusu.

Kļūdas 1.1, 1.2, 1.3. Ir svarīgi pārbaudīt, vai šīs kļūdas ir saistītas ar būtisku datplūsmas apjomu. Ja tā ir, apsveriet iespēju, ka kļūda varētu būt PPP pusē, un pārliecinieties, vai uzņēmumam Google ir sniegta piekrišana nepieciešamajiem mērķiem un vai tas ir ietverts kā pakalpojumu sniedzējs piekrišanas statusam UN likumīgai interesei (pakalpojumu sniedzēja ID 755).

IAB specifikācija

Atbilstoši IAB specifikācijām PPP var glabāt piekrišanas virknes kešatmiņā 13 mēnešus.

Piezīme. Dažas PPP iepriekš saglabāja pirmo piekrišanas datumu un pēc tam to pagarināja, bet tas nav pareizi. Piekrišanas datumam katru reizi ir jābūt jaunam noteiktas piekrišanas virknes datumam.

Ieteikums: jūsu PPP ir jāatbild uz AddEventHandler izsaukumiem 500 ms laikā
^{(kļūdas 2.1a, 2.1b, 2.0a, 2.0b un 2.0c)}

Saistītās kļūdas

Kļūda 2.1a. Šī norāde var tikt piemērota arī kļūdām 2.1b, 2.0a, 2.0b un 2.0c.

Atjauninātās norādes

Kaut arī vairs nepastāv noildzes prasība, piekrišanas pārvaldības platformām ieteicams rūpīgi pārskatīt savus ieviešanas gadījumus, lai nodrošinātu, ka tie nekavējoties atbild uz funkcijas AddEventListener getTCData izsaukumiem.

Ja PPP neatbild, pieprasījums var negūt peļņu.

Pamatojums

Google ievēro IAB specifikāciju, kurā norādīts, ka PPP ir nekavējoties jāatbild uz funkcijas AddEventListener izsaukumu. Ja PPP neatbild nekavējoties, pieprasījums var negūt peļņu.

Turklāt PPP atbildes ir tādu notikumu ķēdes daļa, kuri ietekmē to, cik drīz var tikt izveidots reklāmas pieprasījums. Samazinot laiku starp lapas ielādi un reklāmu pieprasījumiem, izdevējam samazināsies zaudēto seansu skaits.

IAB specifikācija

Piemērojamā IAB specifikācija: IAB “AddEventListener” specifikācija (vietnē GitHub)

Piezīme. Atzvanīšanas funkcija AddEventListener ir jāizsauc uzreiz pēc reģistrēšanas ar pašreizējiem PP datiem, pat ja PPP statuss ir loading un PPP rīcībā ir nepilnīgi PP dati. Tādējādi izsaukuma skripts var piekļūt savam reģistrētajam listenerId. Turklāt katrā PP virknes izmaiņu gadījumā ir jāizsauc atzvanīšanas funkcija, ja vien tā nav noņemta, izmantojot RemoveEventListener.

Politiku centrs

Politiku centrā izdevēji tiek informēti, ja lietotne vai vietne neatbilst Google piekrišanas pārvaldības prasībām.

Kļūdu pārskats

Ja konstatēsim kādu problēmu PP virknē, kas saistīta ar vienu vai vairākām attiecīgo izdevēju vietnēm vai lietotnēm, izdevēji tiks informēti produkta lietotāja saskarnē. Izdevēji, kuriem ir konstatētas kļūdas, sava konta lapā “ES lietotāju piekrišana” var noklikšķināt uz opcijas Lejupielādēt PPI kļūdu pārskatu, lai lejupielādētu detalizētu pārskatu par pēdējo septiņu dienu laikā konstatētajām kļūdām.

Padoms. Šis pārskats ir pieejams tikai tad, ja kļūdas ir konstatētas pēdējo septiņu dienu laikā.

Lai piekļūtu lapai “ES lietotāju piekrišana” un PPI kļūdu pārskatam, veiciet tālāk norādītās darbības.

• Ad Manager: noklikšķiniet uz Administrēšana un pēc tam uz ES lietotāju piekrišana.
• AdMob un AdSense: noklikšķiniet uz vienuma Bloķēšanas vadīklas un pēc tam uz ES lietotāju piekrišana.

Pārskatā būs ietverta tālāk norādītā informācija par katru no konstatētajām kļūdām.

• Domēns/MobileAppID: nepareizi konfigurētā vietne vai mobilā lietotne.
• Reklāmu vienības ceļš: ar kļūdu saistītā reklāmu vienība.
• Kļūdas kods: kļūdai piešķirtais kods.
• Kļūdu skaits: to iepriekšējā nedēļā izmantoto vaicājumu skaits, kuros ietverta konstatētā kļūda.
• Pēdējās konstatēšanas datums: pēdējais datums, kad kļūda tika konstatēta. 

Izdevēji var izmantot pārskatā norādītos kļūdu kodus, lai atrastu ieteicamās darbības, kas minētas tālāk sniegtajās problēmu novēršanas tabulās, un novērstu kļūdas.

Problēmu novēršana

Lai palīdzētu izdevējiem izlabot nepareizi konfigurētu IAB PPI versijas 2.2 integrāciju, esam izveidojuši tālāk redzamās tabulas, kurās norādīti izplatītākie PP virknes kļūdu veidi, kā arī sniegti atbilstošie problēmu novēršanas ieteikumi.

Izmantojiet tālāk sniegtās tabulas, lai izprastu problēmas, kas rodas reklāmu pieprasījuma līmenī, kā arī attiecīgo sistēmas darbību.

Ierobežotas piekrišanas situācijas

Visas šīs trīs situācijas vienmēr ir prioritāras salīdzinājumā ar nepareizas konfigurācijas kļūdām, pat ja pieprasījumā ir vairākas kļūdas.

Situācija	Apraksts	Ieteicamā rīcība
1.1	Piekrišanas statusa vai likumīgas intereses dēļ nav atļauts norādīt uzņēmumu Google kā pakalpojumu sniedzēju.	Noskaidrojiet, vai lietotājs ar nolūku ir noraidījis Google kā pakalpojumu sniedzēju, vai ir radušās CMP ieviešanas kļūdas vai arī ir spēkā izdevēju ierobežojumi.
1.2	EEZ valstīs un Apvienotajā Karalistē nav nepieciešams iegūt piekrišanu 1. mērķim.	Noskaidrojiet, vai lietotājs ar nolūku nav atļāvis īstenot 1. mērķi, vai arī problēma ir saistīta ar PPP ieviešanas kļūdām. Ja izdevēji, kas atrodas Šveicē, nelūdz lietotāju piekrišanu, viņiem ir jāgādā par lauku PublisherCC un PurposeOneTreatment pareizu aizpildīšanu.   Sākot ar 2021. gada decembri, mēs vairs nepārbaudīsim lauka PurposeOneTreatment apstrādi reklāmu pieprasījumos, kuru izcelsme ir Vācija (atbilstoši Vācijas Telekomunikāciju un telemediju datu aizsardzības likumam).
1.3	Ir sniegta piekrišana 1. mērķim, taču nav likumīga pamatojuma pamatreklāmām.	Noskaidrojiet, vai lietotājs ar nolūku ir noraidījis likumīgas intereses citiem mērķiem vai arī problēma ir saistīta ar PPP ieviešanas kļūdām.

Nepareiza konfigurācija

Ja būs radušās ar nepareizu konfigurāciju saistītas kļūdas, reklāmu pieprasījumi netiks izpildīti.

Kļūda	Apraksts	Ieteicamā rīcība
2.1a	Tags vai SDK nesaņem PP virkni, jo PPP statuss ir stub, loading vai error.	Ja reklāmu pieprasīšanai funkciju izsaucat manuāli, gādājiet, lai atbilde uz getTCData TCData.eventStatus = 'tcloaded' VAI 'cmpuishown' + 'useractioncomplete'. Šādi tiek norādīts, ka PPP ir gatava lietotājam nodrošināt izvēli saistībā ar piekrišanu. Ja reklāmu pieprasīšanai funkciju neizsaucat manuāli, sazinieties ar savu PPP pakalpojumu sniedzēju, lai nodrošinātu, ka platformā tiek ieviests atbalsts “getTCData” un atgriezts “TCData.eventStatus” = “tcloaded” VAI “cmpuishow” + “useractioncomplete”, lai norādītu, ka lietotāja piekrišanas mehānisms ir gatavs lietošanai, izmantojot API.
2.1b	Tiek izpildīti abi tālāk minētie nosacījumi. PPP iestatījums &gdpr=1 Atribūts &gdpr_consent= pieprasījumā ir iekļauts, bet PP virkne ir tukša.	Sazinieties ar savu PPP pakalpojumu sniedzēju, lai gādātu par pareizu tā API ieviešanu, pamatojoties uz IAB PPI tehnisko specifikāciju.
2.2a	PP virkne nav parsējama, jo tā nav kodēta, izmantojot metodi base64. Piemērs: “2”	PPP (vai izdevējiem) ir jāsūta tikai ar metodi base64 kodēti dati atribūta gdpr_consent= parametros.
2.2b	PP virkne nav parsējama dekodēšanas kļūdas dēļ. Piemērs: iekļauts nepareizs bitu skaits	PPP ir jāizlabo PP virknes ievietošanas kļūdas.
2.2c	PP virkne nav parsējama datu kļūdas dēļ. Piemēri: nepareizs laikspiedols, pārāk liels pakalpojumu sniedzēja ID.	PPP ir jāizlabo PP virknes ievietošanas kļūdas.

PP virknes problēmas

Problēmas ar PP virkni, kas saistīta ar reklāmu pieprasījumu. Reklāmu pieprasījumu skaits samazināsies, un tie netiks izpildīti.

Kļūda	Apraksts	Ieteicamā rīcība
3.1	Nederīgs PPP ID.	Gādājiet, lai tiktu izmantota IAB apstiprināta PPP un tās ID būtu pareizi iestatīts PP virknēs. Ja PPP vērtība bija derīga PP virknes izveides brīdī, bet vēlāk IAB to izdzēsa, jums ir atkārtoti jāiegūst piekrišana, izmantojot derīgu PPP vērtību.
3.2	Vairs netiek izmantots.	Nav. Iepriekšējā nozīme: PP virkne tika izveidota pirms vairāk nekā 13 mēnešiem.

Nepieciešamība atkārtoti saņemt piekrišanu

No lietotāja ir jāsaņem piekrišana. Ja saņēmāt lietotāja piekrišanu pirms vairāk nekā 13 mēnešiem vai izmantojat tādu GPSS versiju, kurā uzņēmums Google vēl nebija norādīts, jums ir atkārtoti jāsaņem lietotāja piekrišana. Pretējā gadījumā reklāmu pieprasījumi tiks atstāti bez ievērības un netiks izpildīti.

Kļūda	Apraksts	Ieteicamā rīcība
3.3	PP virkne pēdējo reizi tika atjaunināta pirms vairāk nekā 13 mēnešiem.	PPP ir jāizdzēš iepriekšējā PP virkne un atkārtoti jāsaņem piekrišana. Paredzams, ka dažas šādas kļūdas var rasties, ja reklāmu pieprasījumi tiek nosūtīti ar PP virkni, kurai beidzies derīguma termiņš, pirms PPP ir atzinusi lietotāja piekrišanu par nederīgu un saņēmusi to atkārtoti. Ja savā lietotnē izmantojat Google piekrišanas pārvaldības risinājumus un LZP SDK, pārbaudiet, vai LZP SDK ir pareizi ieviests un katru reizi lietotnes palaišanas laikā tiek izsaukta metode requestConsentInfoUpdate.
4.1	PP virkne tika ģenerēta, izmantojot GPSS versiju, kurā uzņēmums Google vēl nebija norādīts.	Saņemiet piekrišanu atkārtoti, izmantojot pašreizējo GPSS versiju.

Vispārējs tvērums un ārpusjoslas tvērums

Tālāk ir norādītas problēmas saistībā ar vispārēju un ārpusjoslas tvērumu (Ad Manager, AdMob, AdSense). Reklāmas netiks rādītas, ja PP virknē būs norādīts ārpusjoslas vai vispārējs tvērums.

Kļūda	Apraksts	Ieteicamā rīcība
5.1	PP virkne atļauj izmantot ārpusjoslas piekrišanu.	Norādiet PPP, lai tā no PP virknēm noņemtu ārpusjoslas signālus.
5.2	PP virkne vispārējā darbības jomā.	Norādiet PPP, ka ir jāatjaunina PP virknes, lai tās atbilstu konkrētam pakalpojumam.

Ierobežota reklāmu rādīšana

Reklāmu rādīšana tiks ierobežota.

Kļūda	Apraksts	Ieteicamā rīcība
6.1	PP virknes versija ir 1 vai 1.1 (versijas 1.0 virkne).	PPP ir jāsūta PPI versijas 2.2 virknes.

Google risinās problēmas

Ja radīsies šādas problēmas, Google pēc nepieciešamības patstāvīgi mazinās šīs problēmas ietekmi un turpinās normālu darbu ar PPI.

Kļūda	Apraksts	Ieteicamā rīcība
7.1	gdprApplies ir nedefinēta vērtība, iestatīta kā nederīga vai neatšifrējama vērtība, bet ir pieejama derīga PP virkne.	Neattiecas
7.2	PP virkne tika ģenerēta, izmantojot GPSS versiju, kas ir jaunāka par versiju, ko pašlaik izmanto Google reklāmu rādīšanas tehnoloģija.	Neattiecas
7.3	Daži mērķi, funkcijas un/vai pakalpojumu sniedzēji ir ārpus darbības jomas (nav zināmi).	Neattiecas
7.4	PP virknes kods tcf_policy_version ir vecāks nekā tas, kas norādīts jaunākajā GPSS.	PPP ir jāizdzēš vecākā PP virkne un atkārtoti jāsaņem piekrišana, izmantojot jaunāko GPSS.
7.5	Pieprasījumā ir kods &dgpr=1, taču pieprasījuma vietrādī URL nav parametra &gdpr_consent.	Neattiecas
7.6	Nederīgs izdevēja valsts kods, bet ir saņemta piekrišana 1. mērķim.	PPP ir jāizlabo PP virknes ievietošanas kļūdas.
7.7	Nederīgs valodas kods.	PPP ir jāizlabo PP virknes ievietošanas kļūdas.
7.8	PP virknes versijas lauks nav ne 1, ne 2.	PPP ir jāizlabo PP virknes ievietošanas kļūdas, pieprasot jaunu saturu, ja tiek konstatēta nederīga PP virkne. Ja savā lietotnē izmantojat Google piekrišanas pārvaldības risinājumus un LZP SDK, pārbaudiet, vai LZP SDK ir pareizi ieviests un katru reizi lietotnes palaišanas laikā tiek izsaukta metode requestConsentInfoUpdate.
7.9	Papildu piekrišanas virknes versija nav ne 1, ne 2.	PPP ir jāiestata papildu piekrišanas virknes versija kā 1 vai 2.

Papildu piekrišanas virknes problēmas

Ja radīsies šādas problēmas, Google uzskatīs papildu piekrišanas virkni par nederīgu, un netiks ņemti vērā nekādi papildu pakalpojumu sniedzēji, kas nav iekļauti PP virknē.

Kļūda	Apraksts	Ieteicamā rīcība
8.1	Papildu piekrišanas virknē nav izmantots versijas atdalītājs (~).	Piekrišanas pārvaldības platformai kā papildu piekrišanas virknes otrā rakstzīme jāizmanto “~”, lai atdalītu versijas numuru no piekritušo pakalpojumu sniedzēju saraksta.
8.2	Papildu piekrišanas virkne ietver pakalpojumu sniedzēju sarakstu, kas neatbilst paredzētajam formātam — sarakstam ar int64 skaitļiem, kas atdalīti ar punktu (“.”).	PPP ir jānovērš papildu piekrišanas virknes ieviešanas kļūdas.

PPP sertifikācija

Ja rodas šādas problēmas, Google mēģinās rādīt nepersonalizētas reklāmas.

Kļūda	Apraksts	Ieteicamā rīcība
9.1	Pieprasījumā norādītā PPI PPP nav Google sertificēta.	PPP ir jābūt Google sertificētai.

Reklāmu pieprasījumos netiek iekļauti PPI signāli

Ja radīsies šādas problēmas, Google mēģinās rādīt ierobežotas reklāmas.

Kļūda	Apraksts	Ieteicamā rīcība
10.1	Pieprasījums nāk no EEZ, Apvienotās Karalistes vai Šveices, taču tajā nav iekļauti PPI signāli.	Izdevējam ir jāintegrē PPI PPP, kas ir Google sertificēta.