Miért nehéz észrevenni a GPP-problémákat

Amikor egy amerikai látogató leiratkozik adatai eladásáról vagy megosztásáról, ennek a döntésnek el kell jutnia az oldal minden hirdetési partneréhez. Az IAB Global Privacy Platformban (GPP) ez egy tömör string és szekcióazonosítók listája formájában utazik. Ha bármelyik hibás — hiányzik, elavult vagy rossz szekciót hordoz —, látszólag semmi sem romlik el. A hirdetések betöltődnek, a banner rendben néz ki, és a probléma csak később jelentkezik: a partnerek figyelmen kívül hagyják a leiratkozásokat, vagy kevesebbet ajánlanak a készletére.

A jó hír, hogy szinte mindent megvizsgálhat a böngészőkonzolból. Ez az útmutató azokat az ellenőrzéseket veszi sorra, abban a sorrendben, ahogy egy éles oldalon lefuttatnánk őket.

1. lépés: Győződjön meg róla, hogy az API létezik és kész

A GPP-kompatibilis CMP egy globális __gpp függvényt tesz elérhetővé. Nyissa meg a DevToolst az oldalán, és futtasson egy ping parancsot:

__gpp('ping', function (data) { console.log(data); });

A visszaadott objektum első pillantásra sokat elárul:

• gppVersion — a jelenlegi implementációknál 1.1-nek kell lennie.
• cmpStatus — betöltött-e a CMP, vagy hibába ütközött.
• cmpDisplayStatus — látható, rejtett vagy letiltott-e a banner ennél a látogatónál.
• signalStatus — „ready”, ha a CMP kialakította a hozzájárulási állapotot, „not ready”, amíg még dönt.
• supportedAPIs — a szekciók, amelyeket a CMP elő tud állítani.
• applicableSections — a szekcióazonosítók, amelyek jelenleg erre a látogatóra vonatkoznak.
• gppString — maga a kódolt string.

Ha a __gpp nincs definiálva, a CMP-stub hiányzik vagy túl későn töltődik be. A stubnak minden olyan hirdetési script előtt a helyén kell lennie, amely számít rá, különben ezek a scriptek nem látnak CMP-t, és vagy várnak, vagy jel nélkül folytatják.

2. lépés: Ellenőrizze az érvényes szekciót

A GPP minden adatvédelmi keretrendszerének numerikus szekcióazonosítója van. A kiadók leggyakrabban a 2 (EU TCF v2), az 5 (kanadai TCF), a 7 (US National, „usnat”) és a 8-tól felfelé az egyes államok szekcióival találkoznak, például Kalifornia, Virginia, Colorado, Utah és Connecticut. Egy amerikai állambeli látogatónál az applicableSections-ben normálisan vagy a nemzeti szekciót, vagy az adott állam szekcióját kell látnia, nem az EU-s szekciót.

Tesztelje több helyről. Gyakori hiba az a CMP, amely a bannerhez helyesen érzékeli a földrajzi helyet, de a stringbe attól függetlenül egy alapértelmezett szekciót ír, vagy fordítva. VPN-nel vagy a CMP előnézeti eszközeivel hasonlítsa össze, amit a banner mutat, azzal, amit az applicableSections jelent.

3. lépés: Olvassa ki a szekció adatait

A string kézi dekódolása helyett kérje a CMP-től a feldolgozott szekciót:

__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');

A US National szekcióban a leiratkozási mezők egyszerű konvenciót használnak: a 0 azt jelenti, hogy nem alkalmazható, az 1 azt, hogy a felhasználó leiratkozott, a 2 pedig azt, hogy a felhasználó nem iratkozott le. Először ezekre a mezőkre összpontosítson:

• SaleOptOut és SharingOptOut
• TargetedAdvertisingOptOut
• A hozzájuk tartozó notice mezők, amelyek rögzítik, hogy a látogatót tájékoztatták-e az egyes gyakorlatokról

Most hajtsa végre a leiratkozást az oldalon — kattintson a „Do Not Sell or Share” hivatkozásra, vagy kapcsolja át a beállítást a beállítóközpontban — és futtassa újra a getSection-t. A leiratkozási mezőknek 2-ről 1-re kell váltaniuk. Ha nem, a felület és a jel nincs szinkronban.

4. lépés: Tesztelje a Global Privacy Control útvonalat

Több állami törvény megköveteli, hogy a vállalkozások a Global Privacy Control jelet leiratkozásként kezeljék. Kapcsolja be a GPC-t egy azt támogató böngészőben vagy bővítményben, győződjön meg róla, hogy a navigator.globalPrivacyControl true értéket ad a konzolban, majd töltse be az oldalt új munkamenetben. A megfelelő leiratkozási mezőknek már 1-et kell mutatniuk anélkül, hogy a látogató hozzányúlna a bannerhez. Egyes szekciók olyan mezőt is tartalmaznak, amely jelzi, hogy a döntés GPC-jelből származik.

5. lépés: Figyelje az eseményeket, ne csak a pillanatfelvételeket

A hirdetési scriptek ne olvassák ki a stringet egyszer az oldal betöltésekor, majd felejtsék el. Regisztráljon egy listenert, hogy lássa, mit látnak a partnerek:

__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });

Olyan eseményeket kell megfigyelnie, mint a listenerRegistered, a signalStatus és a sectionChange. Ha a látogató megváltoztatja a döntését, egy frissített stringgel járó sectionChange eseménynek kell követnie. Ha a header bidding wrapper vagy az ad server integráció csak azelőtt olvassa a stringet, hogy a signalStatus „ready” lenne, üres vagy elavult értéket küldhet.

6. lépés: Kövesse a stringet a hirdetéskérésekbe

Végül nyissa meg a Network fület, és szűrje a hirdetéskéréseit. Sok hirdetési végpont elfogadja a gpp és gpp_sid paramétereket (a stringet és az érvényes szekcióazonosítókat). Ellenőrizze, hogy:

1. mindkét paraméter jelen van az amerikai látogatók kéréseiben;
2. a string egyezik azzal, amelyet a ping a kérés pillanatában visszaadott;
3. leiratkozás után a következő kérések az új stringet viszik, nem egy gyorsítótárazottat.

Ha Prebid.js-t használ, győződjön meg róla, hogy a hozzájárulás-kezelő modulja GPP-re van konfigurálva, és vizsgálja meg a wrapperből kimenő bid requesteket és a végső ad server hívást is.

Gyakori hibaminták

• A stub a hirdetési tagek után töltődik be — a partnerek egyáltalán nem látnak CMP-t.
• Rossz szekció a régióhoz — EU-s szekció megy az amerikai forgalomra, vagy nincs szekció.
• A felület és a jel nincs szinkronban — a kapcsoló változik, a string nem.
• A GPC-t figyelmen kívül hagyják — a böngészőjel soha nem válik leiratkozássá.
• Elavult stringek a kérésekben — a wrapper gyorsítótárazza az első látott értéket.

Legfontosabb tanulságok

• Kezdje a ping-gel: a verzió, az állapot, az érvényes szekciók és a string elmondja a történet nagy részét.
• A leiratkozási mezők olvasásához használja a getSection-t; az 1 leiratkozást, a 2 nem leiratkozást jelent.
• A leiratkozási hivatkozást és a GPC-t külön tesztelje, és ellenőrizze, hogy mindkettő megváltoztatja a jelet.
• Figyelje az eseményeket, és várja meg a „ready” jelet, mielőtt a hirdetéskérések kiolvassák a stringet.
• Ellenőrizze a gpp és gpp_sid paramétereket valódi hálózati kérésekben, leiratkozás előtt és után.