- TCF v2.1: Továbbra is elfogadjuk a TCF 2.1-es karakterláncait, de javasoljuk a beleegyezés-kezelési platformoknak, hogy kövessék az IAB útmutatását a megvalósítási mérföldkövekkel kapcsolatban, ahogy az iparág egyre inkább átáll a TCF 2.2-es verziójára.
- A Google hozzájárulás-kezelési megoldásai: A Google hozzájárulás-kezelési megoldásai – amelyek az Ad Manager, az AdSense és az AdMob Adatvédelem és üzenetek lapján állnak rendelkezésre – az IAB beleegyezés-kezelési platformokra vonatkozó frissített követelményeivel összhangban az európai szabályozással kapcsolatos üzenetek esetében támogatják a TCF 2.2-es verzióját.
Szeretnénk segíteni a megjelenítőknek, hogy könnyebben tudják kezelni az IAB Europe Átláthatósági és Hozzájárulási Keretrendszer 2.2-s verziójával kapcsolatos hibákat és helytelen konfigurációkat, ezért egy jelentésben foglaltuk össze az észlelt hibákat.
Ebben a cikkben a TCF v2.2 implementációs hibáinak javításáról olvashat bővebben, beleértve az alábbiakat:
Frissített útmutató
Frissítések
- Emlékeztető a beleegyezés 13 havonta esedékes újbóli megszerzésére vonatkozó TCF-követelményről:
Az IAB TCF-irányelvei szerint Önnek kötelessége legalább 13 havonta (390 naponta) emlékeztetni a felhasználókat a beleegyezési döntésükre. Ha a beleegyezési döntés 13 hónapnál régebbi, a TC-karakterláncot a Google már nem tekinti érvényesnek, és a Google nem jelenít meg hirdetéseket az érintett felhasználónak. Javasoljuk, hogy a hozzájárulás-kezelési platform használatával emlékeztesse a felhasználókat a beleegyezési döntésükre, még a 13 hónapos korlát elérése előtt.
- A 3.2-es hibatípust megszüntettük. Az elmúlt 13 hónapban frissített TC-karakterláncok érvényesek maradnak.
A gyakori hibák elhárítása
Az Ad Manager, az AdSense és az AdMob szolgáltatással kapcsolatos leggyakoribb problémák megoldásához próbálja meg elvégezni a következő műveleteket:
Fontolja meg, hogy a felhasználóktól ismét beleegyezést kér olyan TC-karakterláncokkal, amelyek nem szereznek bevételt(1.1-es, 3.1-es, 4.1-es, 5.1-es, 5.2-es és 6.1-es hiba)
Kapcsolódó hiba/hibák
Frissített útmutató
Fontolja meg a felhasználók beleegyezésének ismételt kérését.
Indoklás
A megjelenítők számára akkor jelent előnyt a beleegyezés újbóli kérése, ha korábban keretrendszeren kívüli, globális hatókörű karakterláncokat, (tesztelésből származó) érvénytelen beleegyezéskezelésiplatform-azonosítókat, (tesztelésből származó) érvénytelen globálisszolgáltatóilista-azonosítókat használtak, vagy hiányzott a Google mint szolgáltató megfelelő elfogadása valamikor a megvalósítás során.
1.1-es, 1.2-es, 1.3-as hiba: Fontos, hogy ellenőrizze, hogy ezek a hibák jelentős mennyiségű forgalmat képviselnek-e. Ha igen, vizsgálja meg, előfordulhat-e hiba a beleegyezés-kezelési platform oldalán, és győződjön meg arról, hogy a Google kapott-e beleegyezést a szükséges célokhoz, valamint szolgáltatóként Ön regisztrált-e beleegyezés ÉS jogos érdek lehetőséget (szolgáltatóazonosító: 755).
IAB-specifikáció
Az IAB specifikációinak megfelelően a beleegyezés-kezelési platformok a beleegyezési karakterláncokat 13 hónapig gyorsítótárazhatják.
AddEventHandler elemtől érkező hívásokat 500 ms-on belül viszonozza(2.1a, 2.1b, 2.0a, 2.0b és 2.0c hiba)
Kapcsolódó hiba/hibák
2.1a hiba. Ez az útmutató a 2.1b, 2.0a, 2.0b és 2.0c hibákra is érvényes.
Frissített útmutató
Bár már nincs időkorlátra vonatkozó követelmény, azt javasoljuk, hogy a beleegyezés-kezelési platformok alaposan tekintsék át az implementációjukat, hogy biztosítsák a hívások azonnali viszonzását az AddEventListener getTCData számára.
Ha a beleegyezés-kezelési platform nem válaszol, akkor lehetséges, hogy a kérelemből nem történik bevételszerzés.
Indoklás
A Google betartja az IAB-specifikációban foglaltakat, amely szerint a beleegyezés-kezelési platformnak azonnal válaszolnia kell az AddEventListener függvényre. Ha a beleegyezés-kezelési platform nem válaszol azonnal, akkor lehetséges, hogy a kérelemből nem történik bevételszerzés.
Ezenkívül a beleegyezés-kezelési platform válaszai azon eseménylánc részét képezik, amely befolyásolja, hogy milyen gyorsan küldhető el a hirdetési kérelem. Az oldalbetöltés és a hirdetési kérelmek közötti idő csökkentése kevesebb megjelenítésveszteséget eredményez a megjelenítő számára.
IAB-specifikáció
Vonatkozó IAB-specifikáció: IAB AddEventListener specifikáció (a GitHub szolgáltatásban)
AddEventListener visszahívást azonnal el kell végezni az aktuális TC-adatokkal történő regisztrációkor, még akkor is, ha a beleegyezés-kezelési platform állapota töltődik és a beleegyezés-kezelési platform hiányos TC-adatokkal rendelkezik. A hívószkript így hozzáférhet a regisztrált listenerId azonosítóhoz. Továbbá minden TC-karakterlánc módosításánál végre kell hajtani a visszahívást, ha a TC-karakterlánc nem lett eltávolítva a RemoveEventListener használatával.Irányelvközpont
Az irányelvközpontban a megjelenítők értesítést kapnak, ha valamelyik alkalmazás vagy webhely nem felel meg a Google beleegyezés-kezelési követelményeinek.
Hibajelentés
A termék kezelőfelületén fogjuk értesíteni a megjelenítőket, ha egy vagy több webhelyükhöz vagy alkalmazásukhoz társított TC-karakterlánccal kapcsolatos problémát észlelünk. A fiók „EU-beli felhasználók hozzájárulása” oldalán a hibával rendelkező megjelenítők a TCF-hibajelentés letöltése lehetőségre kattintva letölthetik az elmúlt 7 nap során észlelt hibákkal kapcsolatos részletes jelentést.
- Ad Manager: Kattintson az Adminisztrálás, majd az EU-beli felhasználók hozzájárulása lehetőségre.
- AdMob és AdSense: Kattintson a Letiltás vezérlése, majd az EU-beli felhasználók hozzájárulása lehetőségre.
A jelentés a következő információkat tartalmazza a talált hibákról:
- Domain/MobileAppID: Az a webhely vagy mobilalkalmazás, amely hibásan van konfigurálva.
- Hirdetési egység elérési útja: A hibához kapcsolódó hirdetési egység.
- Hibakód: A hibához hozzárendelt kód.
- Hibák száma: Az elmúlt héten megfigyelt, hibát tartalmazó lekérdezések száma.
- Utolsó észlelés dátuma: A hiba legutóbbi észlelésének dátuma.
A megjelenítők a jelentésben található hibakódok alapján megkereshetik a javasolt műveleteket az alábbi hibaelhárítási táblázatokban, és kijavíthatják a hibákat.
Problémamegoldás
Szeretnénk segítséget nyújtani a megjelenítőknek a hibásan konfigurált IAB TCF 2.2-integrációk kijavításához, ezért összeállítottuk a következő táblázatokat, amelyekben a TC-karakterlánccal kapcsolatban leggyakrabban felmerülő hibatípusok, valamint a kapcsolódó problémamegoldási javaslatok láthatók.
A táblázatokból megismerheti a hirdetési kérelmek szintjén felmerülő problémákat, valamint azt, hogyan viselkedik a rendszer ezeknek a problémáknak az előfordulásakor.
Korlátozott beleegyezési esetek
Mindhárom eset elsőbbséget élvez a hibás konfigurációból fakadó hibákkal szemben, még akkor is, ha egy adott kérelem több hibával rendelkezik.
| Eset | Leírás | Javasolt intézkedés |
|---|---|---|
| 1.1 | A beleegyezés, illetve jogos érdek alapján nem engedélyezett a Google szolgáltatóként történő használata. | Győződjön meg arról, hogy a felhasználó szándékosan utasította el a Google szolgáltatóként történő használatát, esetleg hiba lépett fel a beleegyezés-kezelési platform implementálásával kapcsolatban, vagy megjelenítői korlátozások vannak érvényben. |
| 1.2 | Nincs beleegyezés az 1. célhoz az EGT országaiban és az Egyesült Királyságban. |
Ellenőrizze, hogy a felhasználó szándékosan tiltotta-e le az 1. célra való felhasználást, vagy az a beleegyezés-kezelési platform implementálási hibái miatt történt-e. A svájci megjelenítőknek gondoskodniuk kell arról, hogy helyesen állítsák be a
PublisherCC és a PurposeOneTreatment mezőt, ha nem kérik a felhasználók beleegyezését. 2021 decemberétől a német távközlési és televíziós adatvédelmi törvénynek megfelelően nem ellenőrizzük a |
| 1.3 | Beleegyezést kapott az 1. célra vonatkozóan, azonban nem rendelkezik jogalappal az alaphirdetésekre vonatkozóan. |
Győződjön meg róla, hogy a felhasználó szándékosan utasította-e el a többi célhoz kapcsolódó jogos érdeket, vagy az a beleegyezés-kezelési platform implementálásával kapcsolatos hibák miatt történt-e. |
Hibás konfiguráció
Amíg a hibás konfiguráció hibája fennáll, addig a hirdetési kérelem nem teljesül.
| Hiba | Leírás | Javasolt intézkedés |
|---|---|---|
| 2.1a | A címke vagy az SDK nem kap TC-karakterláncot, mivel a beleegyezés-kezelési platform állapota stub, loading vagy error. |
Ha manuálisan hívja meg a hirdetéskérelmezési funkciót, gondoskodjon arról, hogy a válasz Ha nem manuálisan hívja meg a hirdetéskérelmezési funkciót, akkor a beleegyezés-kezelési platformmal együttműködve biztosítsa azt, hogy a beleegyezés-kezelési platform támogassa a |
| 2.1b |
Mindkét feltétel teljesül:
|
Tájékozódjon arról, hogy a beleegyezés-kezelési platform API-jai az IAB TCF technikai specifikációinak megfelelően vannak-e implementálva. |
| 2.2a |
A TC-karakterláncot nem lehet szintaktikailag elemezni, mert nem base64 kódolású. Példa: |
A beleegyezés-kezelési platformoknak (vagy a megjelenítőknek) base64 kódolású adatokat kell küldeniük a gdpr_consent= paraméterekben. |
| 2.2b |
A TC-karakterláncot dekódolási hiba miatt nem lehet szintaktikailag elemezni. Példa: a karakterlánc helytelen számú bitet tartalmaz |
A beleegyezés-kezelési platformnak ki kell javítania a TC-karakterlánc implementációjában található hibákat. |
| 2.2c |
A TC-karakterláncot adathiba miatt nem lehet szintaktikailag elemezni. Példa: helytelen időbélyeg, túl hosszú szolgáltatói azonosító |
A beleegyezés-kezelési platformnak ki kell javítania a TC-karakterlánc implementációjában található hibákat. |
TC-karakterlánccal kapcsolatos problémák
Egy adott hirdetési kérelemhez társított TC-karakterlánccal kapcsolatos problémák. A rendszer elutasítja és nem teljesíti a hirdetési kérelmeket.
| Hiba | Leírás | Javasolt intézkedés |
|---|---|---|
| 3.1 | Érvénytelen a beleegyezés-kezelési platform-azonosítója. |
Győződjön meg arról, hogy valamelyik, az IAB által jóváhagyott beleegyezés-kezelési platformot használja, és az azonosítóját helyesen adta meg a TC-karakterláncokban. Ha a beleegyezés-kezelési platform a TC-karakterlánc létrehozásakor érvényes volt, ám később az IAB törölte, akkor Önnek újból beleegyezést kell kérnie a felhasználóktól egy érvényes beleegyezés-kezelési platform használatával. |
| 3.2 | Már nincs használatban. | Nincs. Előző jelentés: A TC-karakterlánc létrehozása óta 13 hónapnál több telt el. |
Ismét beleegyezést kell kérni
A felhasználótól beleegyezést kell kérni. Ha egy adott felhasználó beleegyezését több mint 13 hónappal ezelőtt szerezte meg, vagy a globális szolgáltatói lista olyan verzióját használja, amelyben a Google még nem szerepel, akkor ismét kérnie kell a felhasználó beleegyezését, különben a rendszer elveti és nem teljesíti a hirdetési kérelmeket.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 3.3 | A TC-karakterlánc utolsó frissítése óta 13 hónapnál több telt el. |
A beleegyezés-kezelési platformnak törölnie kell a régi TC-karakterláncot, és ismét beleegyezést kell kérnie. Várható, hogy kevés ilyen hiba előfordulhat, ha a hirdetési kérelmeket lejárt TC-karakterlánccal küldik el, mielőtt a beleegyezés-kezelési platform érvénytelenítette és újra megszerezte volna a felhasználó beleegyezését. Ha a Google hozzájárulás-kezelési megoldásait és az UMP SDK-t használja az alkalmazásban, győződjön meg arról, hogy az UMP SDK megvalósítása megfelelő, illetve hogy minden alkalommal megtörténik a |
| 4.1 | A TC-karakterláncot a globális szolgáltatói lista olyan verziójával állították elő, amelyben még nem szerepelt a Google. | Szerezze meg ismét a beleegyezést a globális szolgáltatói lista aktuális verziójának használatával. |
Globális hatókör és a keretrendszeren kívül beállított hatókör
A következők a globális vagy a keretrendszeren kívül beállított hatókörrel kapcsolatos problémák (Ad Manager, AdMob, AdSense). A hirdetések nem jelennek meg, ha a TC-karakterláncban a „keretrendszeren kívül beállított” vagy a „globális hatókör” szerepel.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 5.1 | A TC-karakterlánc engedélyezi a keretrendszeren kívül megszerzett beleegyezést. | Utasítsa a beleegyezés-kezelési platformot, hogy távolítsa el a keretrendszeren kívüli jeleket a TC-karakterláncokból. |
| 5.2 | Globális hatókörű TC-karakterlánc. | Utasítsa a beleegyezés-kezelési platformot, hogy tegye szolgáltatásspecifikussá a TC-karakterláncokat. |
Mennyiségileg korlátozott hirdetésmegjelenítés
Korlátozott mennyiségű hirdetés jelenik meg.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 6.1 | A TC-karakterlánc verziószáma 1 vagy 1.1 (1.0-s verziójú karakterlánc). |
A beleegyezés-kezelési platformnak TCF 2.2-karakterláncokat kell küldenie. |
A Google kezeli a problémákat
Ha ilyen problémák jelentkeznek, a Google szükség esetén kijavítja a hibát, és a továbbiakban a normál módon végzi a TCF kezelését.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 7.1 | A gdprApplies nincs megadva, esetleg érvénytelen vagy nem dekódolható értékre van állítva, ám van érvényes TC-karakterlánc. |
– |
| 7.2 | A globális szolgáltatói lista olyan verziójával hozták létre a TC-karakterláncot, amely újabb a Google hirdetésmegjelenítési technológiája által ismertnél. | – |
| 7.3 | Bizonyos célok, funkciók és/vagy szolgáltatók kívül esnek az érvényes tartományon (ismeretlenek). | – |
| 7.4 | A TC-karakterlánc tcf_policy_version verziója régebbi a legújabb globális szolgáltatói lista verziójánál. |
A beleegyezés-kezelési platformnak törölnie kell a régi TC-karakterláncot, és ismét beleegyezést kell kérnie a legújabb globális szolgáltatói lista használatával. |
| 7.5 |
A kérelemben szerepel a |
– |
| 7.6 | A megjelenítő országkódja érvénytelen, de az 1. célhoz van beleegyezés. | A beleegyezés-kezelési platformnak ki kell javítania a TC-karakterlánc implementációjában található hibákat. |
| 7.7 | Érvénytelen nyelvkód. | A beleegyezés-kezelési platformnak ki kell javítania a TC-karakterlánc implementációjában található hibákat. |
| 7.8 | A TC-karakterlánc verziómezőjében nem az 1 vagy a 2 érték szerepel. |
A beleegyezés-kezelési platformnak ki kell javítania a TC-karakterlánc implementációjában található hibákat úgy, hogy érvénytelen TC-karakterlánc észlelése esetén új beleegyezést kér. Ha a Google hozzájárulás-kezelési megoldásait és az UMP SDK-t használja az alkalmazásban, győződjön meg arról, hogy az UMP SDK megvalósítása megfelelő, illetve hogy minden alkalommal megtörténik a |
| 7.9 | A kiegészítő hozzájárulás karakterláncának verziója nem 1 vagy 2. |
A beleegyezés-kezelési platformnak az 1 vagy a 2 értéket kell beállítania a kiegészítő hozzájárulás karakterláncának verziójaként. |
A kiegészítő hozzájárulás karakterláncával kapcsolatos problémák
Ilyen problémák esetén a Google a kiegészítő hozzájárulás (AC) karakterláncát érvénytelenként kezeli, és a TC-karakterláncon túl nem vesz figyelembe további szolgáltatókat.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 8.1 | A kiegészítő hozzájárulás karakterlánca nem használja a verzió elválasztóját (~). |
A beleegyezés-kezelési platformnak a „~” karaktert kell használnia a kiegészítő hozzájárulás karakterláncának második karaktereként, hogy elválassza a verziószámot a beleegyezéssel rendelkező szolgáltatók listájától. |
| 8.2 | A kiegészítő hozzájárulás karakterlánca olyan szolgáltatólistát tartalmaz, amely nem felel meg az elvárt formázásnak (int64 elemek listája, amelyeket „.”' karakter választ el). | A beleegyezés-kezelési platformnak ki kell javítania a kiegészítő hozzájárulás karakterláncában található megvalósítási hibákat. |
A beleegyezés-kezelési platform tanúsítványa
Az ilyen problémák előfordulásakor a Google megpróbál nem személyre szabott hirdetéseket megjeleníteni.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 9.1 | A kérelemben szereplő TCF-beleegyezés-kezelési platform nem rendelkezik Google-tanúsítvánnyal. | A beleegyezés-kezelési platformnak tanúsítvánnyal kell rendelkeznie a Google-tól. |
Nincsenek TCF-jelek a hirdetési kérelmekben
Ha ilyen hibák fordulnak elő, a Google megpróbál korlátozott hirdetéseket megjeleníteni.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 10.1 |
A kérelem az EGT-ből, az Egyesült Királyságból vagy Svájcból származik, de nem tartalmaz TCF-jeleket. |
A megjelenítőnek integrálnia kell egy, a Google tanúsítványával rendelkező TCF-vel rendelkező beleegyezés-kezelési platformot. |