- TCF v2.1: Az IAB TCF-irányelveinek megfelelően továbbra is elfogadjuk a 2026. február 28. előtt létrehozott TCF v2.1-es és v2.2-es karakterláncokat.
- 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.3-as 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 és 2.3-as verziójának bevezetésével kapcsolatos hibákat és helytelen konfigurációkat, ezért egy jelentésben foglaltuk össze az észlelt hibákat.
Ebben a cikkben a TCF 2.2-es és 2.3-as verziójával kapcsolatos implementációs hibák javításáról olvashat bővebben.
Ezen az oldalon:
Frissített útmutató
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, hogy 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).
addEventListener elemből érkező hívásokat 500 ms-on belül viszonozza(2.1a és 2.1b hiba)
Kapcsolódó hiba/hibák
2.1a hiba. Ez az útmutató a 2.1b hibára is alkalmazható.
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 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: Kattintson a Letiltási vezérlők, majd az Európai szabályozások kezelése lehetőségre.
- AdSense: Kattintson a Márkabiztonság lehetőségre. Kattintson a Tartalom, a Letiltási vezérlők, majd az Európai szabályozások kezelése 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-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 művelet |
|---|---|---|
| 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, az Egyesült Királyságban és Svájcban. |
Ellenőrizze, hogy a felhasználó szándékosan tiltotta-e le az 1. célra való felhasználást, vagy ez 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. |
| 1.4 | A TCF 2.3 verziójú karakterláncoknál kötelező „Közzétett szolgáltatók” szakasz hiányzik, hibásan van formázva, vagy nem tartalmazza a Google-t. |
A Google nem tudta feldolgozni ezt a kérelmet, mert a Google nem szerepelt a közzétett szolgáltatók szegmensében, a közzétett szolgáltatók szegmense hiányzik a 2.3-as verziójú karakterláncból, vagy nem tudtuk feldolgozni a közzétett szolgáltatók szegmensét. Győződjön meg arról, hogy a beleegyezés-kezelési platform beállítása támogatja a TCF 2.3 specifikációt, és hogy a beleegyezés-kezelési platformot úgy konfigurálta, hogy a szolgáltatói konfigurációban szerepeljenek a Google hirdetési termékei (azonosító: 755). Minden 2026. március 1-jén vagy azt követően létrehozott TC-karakterlánc esetén a TCF 2.3 verziója lesz kötelező. |
Hibás konfiguráció
Ha ilyen hibák fordulnak elő, a Google megpróbál korlátozott hirdetéseket megjeleníteni.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 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 az 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 az addEventListener parancsot, és |
| 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. Ha ilyen hibák fordulnak elő, a Google megpróbál korlátozott hirdetéseket megjeleníteni.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 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. |
Ismét beleegyezést kell kérni
A felhasználótól beleegyezést kell kérni. Ha 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 Google korlátozott hirdetéseket próbál majd megjeleníteni.
| Hiba | Leírás | Javasolt művelet |
|---|---|---|
| 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). Ha ilyen hibák fordulnak elő, a Google megpróbál korlátozott hirdetéseket megjeleníteni.
| 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. |
Elavult TCF-verzió használatban
Ha ilyen hibák fordulnak elő, a Google megpróbál korlátozott hirdetéseket megjeleníteni.
| 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.3-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.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, vagy manuálisan lett megcímkézve a GDPR betartatása érdekében a gdpr=1 paraméterrel, ám a kérelem nem tartalmaz TCF-jeleket. |
A megjelenítőnek integrálnia kell egy, a Google tanúsítványával rendelkező, TCF-kompatibilis beleegyezés-kezelési platformot, és/vagy gondoskodnia kell arról, hogy a gdpr=1 paraméter csak a GDPR-betartatás hatálya alá tartozó felhasználók esetében legyen beállítva. |