Korrigjimi i vargut IAB GPP në konsolën e shfletuesit: një tutorial hap pas hapi
Pse problemet e GPP janë të vështira për t’u vënë re
Kur një vizitor nga SHBA-ja bën opt-out nga shitja ose ndarja e të dhënave të tij, kjo zgjedhje duhet t’u arrijë të gjithë partnerëve të reklamave në faqe. Me IAB Global Privacy Platform (GPP), ajo udhëton si një varg kompakt dhe një listë ID-sh seksionesh. Nëse cilado prej tyre është e gabuar — mungon, është e vjetëruar ose mban seksionin e gabuar — nuk prishet asgjë në mënyrë të dukshme. Reklamat ngarkohen prapë, baneri duket mirë dhe problemi shfaqet vetëm më vonë, kur partnerët i injorojnë opt-out-et ose ofertojnë më pak për inventarin tuaj.
Lajmi i mirë është se pothuajse gjithçka mund të inspektohet nga konsola e shfletuesit. Ky tutorial përshkon kontrollet sipas radhës që do t’i bënim në një faqe aktive.
Hapi 1: konfirmoni që API ekziston dhe është gati
Një CMP e pajtueshme me GPP ekspozon një funksion global __gpp. Hapni DevTools në faqen tuaj dhe ekzekutoni një komandë ping:
__gpp('ping', function (data) { console.log(data); });
Objekti i kthyer ju thotë shumë me një shikim:
- gppVersion — duhet të jetë 1.1 në zbatimet e tanishme.
- cmpStatus — nëse CMP-ja është ngarkuar ose ka hasur gabim.
- cmpDisplayStatus — nëse baneri është i dukshëm, i fshehur ose i çaktivizuar për këtë vizitor.
- signalStatus — “ready” sapo CMP-ja ka vendosur një gjendje pëlqimi, “not ready” ndërsa ende po vendos.
- supportedAPIs — seksionet që CMP-ja mund t’i prodhojë.
- applicableSections — ID-të e seksioneve që zbatohen tani për këtë vizitor.
- gppString — vetë vargu i koduar.
Nëse __gpp është undefined, stub-i i CMP-së mungon ose ngarkohet shumë vonë. Stub-i duhet të jetë në vend para çdo skripti reklamash që e pret; përndryshe ato skripte nuk do të shohin asnjë CMP dhe ose do të presin ose do të vazhdojnë pa sinjal.
Hapi 2: kontrolloni seksionin e zbatueshëm
Çdo kornizë privatësie në GPP ka një ID seksioni numerike. Ato që botuesit hasin më shpesh janë 2 (EU TCF v2), 5 (TCF kanadez), 7 (US National, “usnat”) dhe 8 e tutje për seksionet e shteteve individuale, si Kalifornia, Virxhinia, Kolorado, Juta dhe Konektikati. Një vizitor nga një shtet i SHBA-së normalisht duhet të shohë në applicableSections ose seksionin kombëtar ose seksionin përkatës të shtetit, jo seksionin e BE-së.
Provoni nga disa vende. Një gabim i zakonshëm është një CMP që e zbulon saktë gjeografinë për banerin, por shkruan në varg një seksion të paracaktuar pavarësisht rastit, ose anasjelltas. Me një VPN ose me mjetet e parapamjes së CMP-së suaj, krahasoni çfarë tregon baneri me çfarë raporton applicableSections.
Hapi 3: lexoni të dhënat e seksionit
Në vend që ta dekodoni vargun me dorë, kërkojini CMP-së seksionin e analizuar:
__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');
Në seksionin US National, fushat e opt-out-it përdorin një konvencion të thjeshtë: 0 do të thotë e pazbatueshme, 1 do të thotë që përdoruesi ka bërë opt-out dhe 2 do të thotë që përdoruesi nuk ka bërë opt-out. Përqendrohuni fillimisht te këto fusha:
- SaleOptOut dhe SharingOptOut
- TargetedAdvertisingOptOut
- Fushat përkatëse të njoftimit, që regjistrojnë nëse vizitorit iu dha njoftim për secilën praktikë
Tani kryeni opt-out-in në faqe — klikoni lidhjen tuaj “Do Not Sell or Share” ose ndërroni cilësimin në qendrën e preferencave — dhe ekzekutoni përsëri getSection. Fushat e opt-out-it duhet të kalojnë nga 2 në 1. Nëse nuk e bëjnë, ndërfaqja dhe sinjali nuk janë të sinkronizuara.
Hapi 4: provoni rrugën e Global Privacy Control
Disa ligje shtetërore kërkojnë që bizneset ta trajtojnë një sinjal Global Privacy Control si opt-out. Aktivizoni GPC-në në një shfletues ose shtesë që e mbështet, konfirmoni që navigator.globalPrivacyControl kthen true në konsolë, pastaj ngarkoni faqen në një seancë të re. Fushat përkatëse të opt-out-it duhet të tregojnë tashmë 1 pa e prekur vizitori banerin. Disa seksione përfshijnë edhe një fushë që tregon se zgjedhja vjen nga një sinjal GPC.
Hapi 5: ndiqni ngjarjet, jo vetëm fotografitë e çastit
Skriptet e reklamave nuk duhet ta lexojnë vargun vetëm një herë gjatë ngarkimit të faqes dhe ta harrojnë. Regjistroni një listener për të parë çfarë shohin partnerët:
__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });
Duhet të vëreni ngjarje si listenerRegistered, signalStatus dhe sectionChange. Kur vizitori ndryshon një zgjedhje, duhet të pasojë një ngjarje sectionChange me një varg të përditësuar. Nëse wrapper-i juaj i header bidding ose integrimi i ad server-it e lexon vargun vetëm para se signalStatus të bëhet “ready”, mund të dërgojë një vlerë të zbrazët ose të vjetëruar.
Hapi 6: ndiqni vargun në kërkesat e reklamave
Së fundi, hapni skedën Network dhe filtroni kërkesat tuaja të reklamave. Shumë pika fundore reklamash pranojnë parametrat gpp dhe gpp_sid (vargun dhe ID-të e seksioneve të zbatueshme). Kontrolloni që:
- të dy parametrat janë të pranishëm në kërkesat e vizitorëve nga SHBA-ja;
- vargu përputhet me atë të kthyer nga ping në çastin e kërkesës;
- pas një opt-out-i, kërkesat pasuese mbartin vargun e ri dhe jo një të ruajtur në cache.
Nëse përdorni Prebid.js, konfirmoni që moduli i tij i menaxhimit të pëlqimit është konfiguruar për GPP dhe inspektoni kërkesat e ofertave që dalin nga wrapper-i, si dhe thirrjen përfundimtare te ad server-i.
Modele të zakonshme dështimi
- Stub-i ngarkohet pas tag-eve të reklamave — partnerët nuk shohin fare CMP.
- Seksion i gabuar për rajonin — seksioni i BE-së dërgohet për trafikun e SHBA-së, ose asnjë seksion.
- Ndërfaqja dhe sinjali të pasinkronizuara — çelësi ndryshon, vargu jo.
- GPC e injoruar — sinjali i shfletuesit nuk shndërrohet kurrë në opt-out.
- Vargje të vjetëruara në kërkesa — wrapper-i ruan në cache vlerën e parë që pa.
Pikat kryesore
- Filloni me ping: versioni, statusi, seksionet e zbatueshme dhe vargu ju tregojnë pjesën më të madhe të historisë.
- Përdorni getSection për të lexuar fushat e opt-out-it; 1 do të thotë që ka bërë opt-out, 2 që nuk ka bërë.
- Provoni veçmas lidhjen e opt-out-it dhe GPC-në dhe konfirmoni që të dyja e ndryshojnë sinjalin.
- Dëgjoni ngjarjet dhe prisni një sinjal “ready” para se kërkesat e reklamave ta lexojnë vargun.
- Verifikoni gpp dhe gpp_sid në kërkesa reale rrjeti, para dhe pas një opt-out-i.