- 2.1 versijos SSP: ir toliau priimsime 2.1 versijos SSP eilutes, bet raginame STP laikytis IAB gairės diegimo etapuose, kai pramonės sritis perkeliama į 2.2 versijos SSP.
- „Google“ sutikimų tvarkymo sprendimai: „Google“ sutikimų tvarkymo sprendimai, pasiekiami „Ad Manager“, „AdSense“ ir „AdMob“ skirtuke „Privatumas ir pranešimai“, palaiko 2.2 versijos SSP, skirtus Europos reglamentų pranešimams, kartu su IAB atnaujintais STP reikalavimais.
Siekdami padėti leidėjams ištaisyti klaidas ir netinkamas konfigūracijas, susijusias su 2.2 versijos „IAB Europe“ skaidrumo ir sutikimo principų pristatymu, pateikiame aptiktų klaidų ataskaitą.
Šiame straipsnyje rasite daugiau informacijos, kaip spręsti 2.2 versijos SSP diegimo klaidas, įskaitant toliau nurodytą informaciją.
Atnaujintos gairės
Naujienos
- Priminimas apie SSP reikalavimą pakartotinai gauti sutikimą kas trylika mėnesių.
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.
- Pašalintas 3.2 klaidos tipas. Per pastaruosius trylika mėnesių atnaujintos SS eilutės toliau galios.
Dažnai pasitaikančių klaidų pataisymai
Pašalinkite kai kurias dažnai pasitaikančias klaidas sistemose „Ad Manager“, „AdSense“ ir „AdMob“ atlikdami toliau nurodytus veiksmus.
Apsvarstykite galimybę prašyti pakartotinio naudotojų sutikimo naudodami SS eilutes, iš kurių nebus galima gauti pajamų(1.1, 3.1, 4.1, 5.1, 5.2 ir 6.1 klaidos)
Susijusi (-ios) klaida (-os)
Atnaujintos gairės
Apsvarstykite galimybę prašyti naudotojų sutikimo pakartotinai.
Paaiškinimas
Leidėjams bus naudinga prašyti sutikimo pakartotinai, jei anksčiau naudojo ne diapazono, bendrosios taikymo srities eilutes, netinkamus STP ID (iš testavimo), netinkamus VPTS ID (iš testavimo) arba bet kuriuo metu diegiant nebuvo „Google“ kaip paslaugos teikėjos su tinkamu sutikimu.
1.1, 1.2, 1.3 klaidos: svarbu patikrinti, ar šios klaidos kyla didelėje srauto dalyje. Jei taip, apsvarstykite galimybę, kad tai yra STP problema, ir įsitikinkite, kad „Google“ suteiktas leidimas reikalingiems tikslams įgyvendinti bei kad „Google“ yra sutikimo IR teisėto intereso paslaugos teikėja (paslaugos teikėjo ID: 755).
IAB specifikacijos
Pagal IAB specifikacijas STP gali sutikimo eilutes saugoti talpykloje trylika mėnesių.
AddEventHandler per 500 ms(2.1a, 2.1b, 2.0a, 2.0b ir 2.0c klaidos)
Susijusi (-ios) klaida (-os)
2.1a klaida. Šias gaires taip pat galima taikyti 2.1b, 2.0a, 2.0b ir 2.0c klaidoms.
Atnaujintos gairės
Nebėra skirtojo laiko reikalavimo, todėl siūlome STP atidžiai peržiūrėti diegimą, kad būtų nedelsiant atsakoma į AddEventListener getTCData.
Jei STP neatsakys, iš užklausos gali būti negaunama pajamų.
Paaiškinimas
„Google“ laikosi IAB specifikacijų, kuriose nurodoma, kad STP turi nedelsdama atsakyti į funkciją AddEventListener. Jei STP neatsako iš karto, iš užklausos gali būti negaunama pajamų.
Be to, STP atsakymai yra įvykių grandinės, darančios įtaką tam, kaip greitai galima pateikti skelbimų užklausą, dalis. Sutrumpinus laiką tarp puslapio įkėlimo ir skelbimų užklausų rezultatų leidėjas praranda mažiau parodymų.
IAB specifikacijos
Taikomos IAB specifikacijos: IAB „AddEventListener“ specifikacijos („GitHub“)
AddEventListener atsakymo funkcija turi būti iškviečiama iš karto registruojant dabartinius SS duomenis, net jei STP būsena yra loading ir STP yra nebaigtų SS duomenų. Taip iškvietimo scenarijus įgalinamas pasiekti užregistruotą listenerId. Be to, kaskart pakeitus SS eilutę turi būti iškviečiama atsakymo funkcija, nebent ji pašalinama naudojant RemoveEventListener.Politikos centras
Politikos centre leidėjams pranešama, jei programa arba svetainė neatitinka „Google“ sutikimų tvarkymo reikalavimų.
Klaidų ataskaita
Jei aptiksime su viena ar daugiau leidėjų svetainių ar programų susijusios SS eilutės problemą, apie tai pranešime leidėjams produkto naudotojo sąsajoje. Paskyros puslapyje „ES naudotojo sutikimas“ klaidų turintys leidėjai gali spustelėti Atsisiųsti SSP klaidų ataskaitą, kad atsisiųstų išsamią klaidų, aptiktų per pastarąsias septynias dienas, ataskaitą.
- „Ad Manager“: spustelėkite Administratorius, tada ES naudotojo sutikimas.
- „AdMob“ ir „AdSense“: spustelėkite Blokavimo valdikliai, tada ES naudotojo sutikimas.
Ataskaitoje bus pateikta toliau nurodyta informacija apie kiekvieną aptiktą klaidą.
- Domenas ir (ar) MobileAppID: netinkamai sukonfigūruota svetainė arba programa mobiliesiems.
- Skelbimų rinkinio kelias: su klaida susijęs skelbimų rinkinys.
- Klaidos kodas: klaidai priskirtas kodas.
- Klaidų skaičius: užklausų su klaida skaičius per praėjusią savaitę.
- Pastarojo aptikimo data: data, kada buvo paskutinį kartą aptikta klaida.
Leidėjai gali naudoti ataskaitoje pateiktus klaidų kodus, kad rastų siūlomus veiksmus, kuriuos reikia atlikti, toliau nurodytose trikčių šalinimo lentelėse, ir pašalintų klaidas.
Trikčių šalinimas
Siekdami padėti leidėjams sutvarkyti netinkamai sukonfigūruotą 2.2 versijos IAB SSP integravimą, sudarėme toliau nurodytas dažniausių SS eilučių klaidų tipų lenteles ir pateikėme atitinkamas trikčių šalinimo rekomendacijas.
Vadovaukitės lentelėmis, kad suprastumėte problemas, kylančias skelbimų užklausos lygiu, ir atitinkamą sistemos elgseną.
Riboto sutikimo scenarijai
Visiems šiems trims scenarijams visada teikiama pirmenybė, palyginti su netinkamos konfigūracijos klaidomis, net jei konkrečioje užklausoje yra kelios klaidos.
| Scenarijus | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 1.1 | „Google“, kaip paslaugos teikėja, neleidžiama pagal sutikimą ar teisėtą interesą. | Patvirtinkite, ar naudotojas tikslingai atmetė „Google“ kaip paslaugos teikėją, ar įvyko STP diegimo klaidų arba yra leidėjo apribojimų. |
| 1.2 | Nėra sutikimo dėl 1 tikslo EEE šalyse ir JK. |
Patvirtinkite, ar naudotojas tikslingai neleido 1 tikslo, ar tai nurodyta dėl STP diegimo klaidų. Šveicarijoje esantys leidėjai turi įsitikinti, kad tinkamai nustatė laukus
PublisherCC ir PurposeOneTreatment, jei neprašo naudotojų sutikimo. Nuo 2021 m. gruodžio mėn. nebetikrinsime, ar laukas |
| 1.3 | Yra sutikimas dėl 1 tikslo, bet trūksta pagrindinių skelbimų teisinių pagrindų. |
Patvirtinkite, ar naudotojas tikslingai atmetė teisėtus interesus dėl kitų tikslų, ar taip nutiko dėl STP diegimo klaidų. |
Netinkama konfigūracija
Jei bus netinkamos konfigūracijos klaidų, skelbimų užklausos nebus užpildytos.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 2.1a | Žyma arba SDK negauna SS eilutės dėl STP būsenos stub, loading arba error. |
Jei neautomatiškai iškviečiate funkciją, skirtą skelbimų užklausoms teikti, įsitikinkite, kad atsakymas į Jei neautomatiškai neiškviečiate funkcijos, skirtos skelbimų užklausoms teikti, tada bendradarbiaudami su STP užtikrinkite, kad juose palaikoma |
| 2.1b |
Įvykdytos abi toliau nurodytos sąlygos.
|
Paprašykite STP įsitikinti, kad jų API tinkamai įdiegtos pagal IAB SSP technines specifikacijas. |
| 2.2a |
Nepavyksta išanalizuoti SS eilutės, nes ji neužkoduota taikant „base64“. Pavyzdys: |
STP (arba leidėjai) turėtų siųsti tik „base64“ koduotus duomenis parametruose gdpr_consent=. |
| 2.2b |
Nepavyksta išanalizuoti SS eilutės dėl iššifravimo klaidos. Pavyzdys: apima netinkamą bitų skaičių |
STP turėtų ištaisyti SS eilučių diegimo klaidas. |
| 2.2c |
Nepavyksta išanalizuoti SS eilutės dėl duomenų klaidos. Pavyzdys: netinkama laiko žymė, paslaugos teikėjo ID per didelis |
STP turėtų ištaisyti SS eilučių diegimo klaidas. |
SS eilučių problemos
SS eilučių problemos, susijusios su skelbimo užklausa. Skelbimų užklausos bus atmestos ir neužpildytos.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 3.1 | Netinkamas STP ID. |
Įsitikinkite, kad naudojama IAB patvirtinta STP ir jos ID tinkamai nustatytas SS eilutėse. Jei STP galiojo, kai buvo sugeneruota SS eilutė, bet ją vėliau ištrynė IAB, turite iš naujo gauti sutikimą naudodami galiojančią STP. |
| 3.2 | Nebenaudojama. | Nėra. Ankstesnė reikšmė: SS eilutė sukurta daugiau nei prieš trylika mėnesių. |
Būtina iš naujo gauti sutikimą
Būtina gauti naudotojo sutikimą. Jei naudotojo sutikimą gavote daugiau nei prieš trylika mėnesių arba naudojote BPTS versiją, kurioje „Google“ dar nebuvo pateikta, turėtumėte iš naujo gauti naudotojo sutikimą, antraip skelbimų užklausos bus atmestos ir neužpildytos.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 3.3 | SS eilutė paskutinį kartą atnaujinta daugiau nei prieš trylika mėnesių. |
STP turėtų ištrinti seną SS eilutę ir iš naujo gauti sutikimą. Numatoma, kad tokių klaidų gali įvykti, jei skelbimų užklausos siunčiamos su nebegaliojančia SS eilute, kol STP nepatvirtina ir iš naujo gauna naudotojo sutikimą. Jei programoje naudojate „Google“ sutikimų tvarkymo priemones ir UMP SDK, patvirtinkite, kad UMP SDK tinkamai įdiegtas ir kaskart paleidžiant programą iškviečiamas |
| 4.1 | SS eilutė, sugeneruota naudojant VPTS versiją, kurioje „Google“ dar nepateikta. | Gaukite sutikimą iš naujo naudodami dabartinės versijos VPTS. |
Bendroji ir ne diapazono taikymo sritys
Toliau nurodytos problemos, susijusios su bendrąja ir ne diapazono taikymo sritimis („Ad Manager“, „AdMob“, „AdSense“). Skelbimai nebus teikiami, jei SS eilutėje bus nurodyta „Ne diapazono taikymo sritis“ arba „Bendroji taikymo sritis“.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 5.1 | SS eilutėje leidžiamas ne diapazono sutikimas. | Nurodykite savo STP pašalinti ne diapazono signalus iš SS eilučių. |
| 5.2 | Bendrosios taikymo srities SS eilutė. | Nurodykite savo STP atnaujinti SS eilutes, kad atitiktų konkrečią paslaugą. |
Ribotas skelbimų teikimas
Bus teikiami apriboti skelbimai.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 6.1 | SS eilutės versija yra 1 arba 1.1 (1.0 versijos eilutė). |
STP turėtų siųsti 2.2 versijos SSP eilutes. |
„Google“ tvarkys problemas
Iškilus šioms problemoms, „Google“ pati sušvelnins problemą, kai reikės, ir vykdys įprastą SSP apdorojimo procesą.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 7.1 | gdprAppplies yra neapibrėžtas arba nustatytas kaip netinkama ar neiššifruojama vertė, bet yra tinkama SS eilutė. |
Netaikoma |
| 7.2 | SS eilutė sugeneruota taikant VPTS versiją, kuri buvo naujesnė nei dabartinė „Google“ skelbimų teikimo technologijų žinoma versija. | Netaikoma |
| 7.3 | Kai kurie tikslai, funkcijos ir (arba) paslaugų teikėjai nepasiekiami (nežinomi). | Netaikoma |
| 7.4 | SS eilutės tcf_policy_version senesnis nei naujausio VPTS. |
STP turėtų ištrinti seną SS eilutę ir iš naujo gauti sutikimą naudodama naujausią VPTS. |
| 7.5 |
Užklausoje yra |
Netaikoma |
| 7.6 | Netinkamas leidėjo šalies kodas, bet yra sutikimas dėl 1 tikslo. | STP turėtų ištaisyti SS eilučių diegimo klaidas. |
| 7.7 | Netinkamas kalbos kodas. | STP turėtų ištaisyti SS eilučių diegimo klaidas. |
| 7.8 | SS eilutės versijos laukas nėra nei 1, nei 2. |
STP turėtų ištaisyti SS eilučių diegimo klaidas pateikdama naujo sutikimo užklausą, jei aptinkama netinkama SS eilutė. Jei programoje naudojate „Google“ sutikimų tvarkymo priemones ir UMP SDK, patvirtinkite, kad UMP SDK tinkamai įdiegtas ir kaskart paleidžiant programą iškviečiamas |
| 7.9 | PS eilutės versija nėra nei 1, nei 2. |
STP turėtų nustatyti 1 arba 2 versijos PS eilutę. |
PS eilutės problemos
Iškilus šioms problemoms, „Google“ papildomo sutikimo (PS) eilutę naudos kaip netinkamą ir nebus atsižvelgta į jokius papildomus paslaugų teikėjus, kurie neįtraukti į SS eilutę.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 8.1 | PS eilutėje nenaudojamas versijos skyriklis (~). |
STP turi naudoti ~ kaip antrą PS eilutės simbolį, kad atskirtų versijos numerį iš sutikusių paslaugų teikėjų sąrašo. |
| 8.2 | PS eilutėje yra paslaugų teikėjų sąrašas, neatitinkantis numatomo formatavimo („Int64“, atskirtų „.“) | STP turėtų ištaisyti PS eilučių diegimo klaidas. |
STP sertifikatas
Iškilus šioms problemoms, „Google“ bandys teikti nesuasmenintus skelbimus.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 9.1 | Užklausoje pateikta SSP STP nėra sertifikuota „Google“. | STP turėtų sertifikuoti „Google“. |
Nėra SSP signalų skelbimų užklausose
Iškilus šioms problemoms, „Google“ bandys teikti apribotus skelbimus.
| Klaida | Aprašas | Siūlomas veiksmas |
|---|---|---|
| 10.1 |
Užklausa yra iš EEE, JK arba Šveicarijos, bet trūksta SSP signalų. |
Leidėjas turėtų integruoti SSP STP, kurią sertifikavo „Google“. |