Prečo sa problémy s GPP ťažko odhaľujú

Keď sa americký návštevník odhlási z predaja alebo zdieľania svojich údajov, táto voľba sa musí dostať ku každému reklamnému partnerovi na stránke. V rámci IAB Global Privacy Platform (GPP) putuje ako kompaktný reťazec a zoznam ID sekcií. Ak je jedno z nich nesprávne — chýba, je zastarané alebo nesie nesprávnu sekciu — navonok sa nič nepokazí. Reklamy sa stále načítavajú, banner vyzerá v poriadku a problém sa prejaví až neskôr tým, že partneri ignorujú odhlásenia alebo menej ponúkajú za váš inventár.

Dobrá správa je, že takmer všetko môžete skontrolovať z konzoly prehliadača. Tento návod prechádza kontroly v poradí, v akom by sme ich spustili na živej stránke.

Krok 1: Overte, že API existuje a je pripravené

CMP kompatibilné s GPP sprístupňuje globálnu funkciu __gpp. Otvorte DevTools na svojej stránke a spustite príkaz ping:

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

Vrátený objekt vám na prvý pohľad prezradí veľa:

• gppVersion — pri súčasných implementáciách by mala byť 1.1.
• cmpStatus — či sa CMP načítalo, alebo narazilo na chybu.
• cmpDisplayStatus — či je banner pre tohto návštevníka viditeľný, skrytý alebo vypnutý.
• signalStatus — „ready“, keď sa CMP ustálilo na stave súhlasu, „not ready“, kým sa ešte rozhoduje.
• supportedAPIs — sekcie, ktoré CMP vie vytvoriť.
• applicableSections — ID sekcií, ktoré sa na tohto návštevníka práve vzťahujú.
• gppString — samotný zakódovaný reťazec.

Ak je __gpp nedefinované, stub CMP chýba alebo sa načítava príliš neskoro. Stub musí byť na mieste pred každým reklamným skriptom, ktorý ho očakáva, inak tieto skripty neuvidia žiadne CMP a buď čakajú, alebo pokračujú bez signálu.

Krok 2: Skontrolujte príslušnú sekciu

Každý rámec ochrany súkromia v GPP má číselné ID sekcie. Tie, s ktorými sa vydavatelia stretávajú najčastejšie, sú 2 (EU TCF v2), 5 (kanadský TCF), 7 (US National, „usnat“) a 8 a vyššie pre jednotlivé štátne sekcie, ako Kalifornia, Virgínia, Colorado, Utah a Connecticut. Návštevník z amerického štátu by v applicableSections mal normálne vidieť buď národnú sekciu, alebo príslušnú štátnu sekciu, nie sekciu EÚ.

Testujte z viacerých lokalít. Častou chybou je CMP, ktoré správne zistí geografiu pre banner, ale do reťazca zapíše predvolenú sekciu bez ohľadu na ňu, alebo naopak. Pomocou VPN alebo náhľadových nástrojov vášho CMP porovnajte, čo ukazuje banner, s tým, čo hlási applicableSections.

Krok 3: Prečítajte údaje sekcie

Namiesto ručného dekódovania reťazca požiadajte CMP o rozparsovanú sekciu:

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

V sekcii US National používajú polia odhlásenia jednoduchú konvenciu: 0 znamená neuplatňuje sa, 1 znamená, že sa používateľ odhlásil, a 2 znamená, že sa používateľ neodhlásil. Najprv sa zamerajte na tieto polia:

• SaleOptOut a SharingOptOut
• TargetedAdvertisingOptOut
• Zodpovedajúce polia notice, ktoré zaznamenávajú, či bol návštevníkovi poskytnutý oznam o každej praktike

Teraz vykonajte odhlásenie na stránke — kliknite na odkaz „Do Not Sell or Share“ alebo prepnite nastavenie v centre preferencií — a spustite getSection znova. Polia odhlásenia by sa mali zmeniť z 2 na 1. Ak nie, UI a signál nie sú synchronizované.

Krok 4: Otestujte cestu Global Privacy Control

Viaceré štátne zákony vyžadujú, aby podniky považovali signál Global Privacy Control za odhlásenie. Zapnite GPC v prehliadači alebo rozšírení, ktoré ho podporuje, overte, že navigator.globalPrivacyControl v konzole vracia true, a potom načítajte stránku v novej relácii. Príslušné polia odhlásenia by už mali ukazovať 1 bez toho, aby sa návštevník dotkol bannera. Niektoré sekcie obsahujú aj pole, ktoré uvádza, že voľba pochádza zo signálu GPC.

Krok 5: Sledujte udalosti, nielen snímky

Reklamné skripty by nemali čítať reťazec raz pri načítaní stránky a zabudnúť naň. Zaregistrujte listener, aby ste videli, čo vidia partneri:

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

Mali by ste pozorovať udalosti ako listenerRegistered, signalStatus a sectionChange. Keď návštevník zmení voľbu, mala by nasledovať udalosť sectionChange s aktualizovaným reťazcom. Ak váš wrapper header biddingu alebo integrácia ad servera číta reťazec len predtým, než sa signalStatus stane „ready“, môže odoslať prázdnu alebo zastaranú hodnotu.

Krok 6: Sledujte reťazec do reklamných žiadostí

Nakoniec otvorte kartu Network a vyfiltrujte svoje reklamné žiadosti. Mnohé reklamné endpointy akceptujú parametre gpp a gpp_sid (reťazec a ID príslušných sekcií). Skontrolujte, že:

1. oba parametre sú prítomné v žiadostiach od amerických návštevníkov;
2. reťazec zodpovedá tomu, ktorý vrátil ping v čase žiadosti;
3. po odhlásení nasledujúce žiadosti nesú nový reťazec, nie uložený v cache.

Ak používate Prebid.js, overte, že jeho modul správy súhlasu je nastavený pre GPP, a skontrolujte bid requesty odchádzajúce z wrappera aj finálne volanie ad servera.

Bežné vzorce zlyhania

• Stub sa načíta po reklamných tagoch — partneri nevidia žiadne CMP.
• Nesprávna sekcia pre región — sekcia EÚ odoslaná pre americkú návštevnosť alebo žiadna sekcia.
• UI a signál nie sú synchronizované — prepínač sa zmení, reťazec nie.
• GPC ignorované — signál prehliadača sa nikdy nestane odhlásením.
• Zastarané reťazce v žiadostiach — wrapper ukladá prvú hodnotu, ktorú videl.

Kľúčové poznatky

• Začnite s ping: verzia, stav, príslušné sekcie a reťazec prezradia väčšinu príbehu.
• Na čítanie polí odhlásenia použite getSection; 1 znamená odhlásený, 2 znamená neodhlásený.
• Odkaz na odhlásenie a GPC testujte samostatne a overte, že obe menia signál.
• Počúvajte udalosti a pred čítaním reťazca v reklamných žiadostiach počkajte na signál „ready“.
• Overte gpp a gpp_sid v reálnych sieťových žiadostiach, pred odhlásením aj po ňom.