Per què els problemes de GPP són difícils de detectar

Quan un visitant dels EUA decideix no permetre la venda o la compartició de les seves dades, aquesta elecció ha d'arribar a tots els socis publicitaris de la pàgina. Amb l'IAB Global Privacy Platform (GPP), viatja com una cadena compacta i una llista d'identificadors de secció. Si qualsevol dels dos és incorrecte — falta, està desactualitzat o porta la secció equivocada — no es trenca res de manera visible. Els anuncis es carreguen igualment, el bàner té bon aspecte, i el problema només apareix més tard, quan els socis ignoren les baixes o liciten menys pel teu inventari.

La bona notícia és que gairebé tot es pot inspeccionar des de la consola del navegador. Aquest tutorial recorre les comprovacions en l'ordre en què les faríem en una pàgina en producció.

Pas 1: confirma que l'API existeix i està a punt

Un CMP compatible amb GPP exposa una funció global __gpp. Obre DevTools a la teva pàgina i executa una ordre ping:

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

L'objecte retornat t'explica moltes coses d'un cop d'ull:

• gppVersion — hauria de ser 1.1 en les implementacions actuals.
• cmpStatus — si el CMP s'ha carregat o ha trobat un error.
• cmpDisplayStatus — si el bàner és visible, ocult o desactivat per a aquest visitant.
• signalStatus — “ready” quan el CMP s'ha decidit per un estat de consentiment, “not ready” mentre encara ho està decidint.
• supportedAPIs — les seccions que el CMP pot produir.
• applicableSections — els identificadors de secció que s'apliquen ara mateix a aquest visitant.
• gppString — la cadena codificada en si.

Si __gpp és undefined, el stub del CMP no hi és o es carrega massa tard. El stub ha d'estar al seu lloc abans de qualsevol script d'anuncis que l'esperi; si no, aquests scripts no veuran cap CMP i esperaran o continuaran sense senyal.

Pas 2: comprova la secció aplicable

Cada marc de privacitat de GPP té un identificador de secció numèric. Els que els editors troben amb més freqüència són el 2 (EU TCF v2), el 5 (TCF canadenc), el 7 (US National, “usnat”) i el 8 i següents per a les seccions d'estats concrets, com Califòrnia, Virgínia, Colorado, Utah i Connecticut. Un visitant d'un estat dels EUA hauria de veure normalment la secció nacional o la secció estatal corresponent a applicableSections, no la secció de la UE.

Prova des de diverses ubicacions. Un error habitual és un CMP que detecta bé la geografia per al bàner però escriu a la cadena una secció per defecte sigui quin sigui el cas, o al revés. Amb una VPN o amb les eines de vista prèvia del teu CMP, compara el que mostra el bàner amb el que informa applicableSections.

Pas 3: llegeix les dades de la secció

En lloc de descodificar la cadena a mà, demana al CMP la secció analitzada:

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

A la secció US National, els camps de baixa fan servir una convenció senzilla: 0 vol dir no aplicable, 1 vol dir que l'usuari s'ha donat de baixa i 2 vol dir que l'usuari no s'ha donat de baixa. Fixa't primer en aquests camps:

• SaleOptOut i SharingOptOut
• TargetedAdvertisingOptOut
• Els camps d'avís corresponents, que registren si al visitant se li va donar avís de cada pràctica

Ara fes la baixa a la pàgina — fes clic al teu enllaç “Do Not Sell or Share” o canvia l'ajust al centre de preferències — i executa getSection de nou. Els camps de baixa haurien de passar de 2 a 1. Si no ho fan, la interfície i el senyal no estan sincronitzats.

Pas 4: prova el camí de Global Privacy Control

Diverses lleis estatals exigeixen que les empreses tractin un senyal Global Privacy Control com a baixa. Activa el GPC en un navegador o extensió que l'admeti, confirma que navigator.globalPrivacyControl retorna true a la consola i després carrega la pàgina en una sessió nova. Els camps de baixa corresponents haurien de marcar ja 1 sense que el visitant toqui el bàner. Algunes seccions també inclouen un camp que indica que l'elecció prové d'un senyal GPC.

Pas 5: observa els esdeveniments, no només les instantànies

Els scripts d'anuncis no haurien de llegir la cadena una sola vegada en carregar la pàgina i oblidar-la. Registra un listener per veure el que veuen els socis:

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

Hauries d'observar esdeveniments com listenerRegistered, signalStatus i sectionChange. Quan el visitant canvia una elecció, ha de seguir un esdeveniment sectionChange amb una cadena actualitzada. Si el teu wrapper de header bidding o la integració del servidor d'anuncis només llegeix la cadena abans que signalStatus passi a “ready”, pot enviar un valor buit o desactualitzat.

Pas 6: segueix la cadena fins a les sol·licituds d'anuncis

Finalment, obre la pestanya Network i filtra les teves sol·licituds d'anuncis. Molts punts finals d'anuncis accepten els paràmetres gpp i gpp_sid (la cadena i els identificadors de secció aplicables). Comprova que:

1. els dos paràmetres són presents a les sol·licituds dels visitants dels EUA;
2. la cadena coincideix amb la retornada per ping en el moment de la sol·licitud;
3. després d'una baixa, les sol·licituds posteriors porten la cadena nova i no una de la memòria cau.

Si fas servir Prebid.js, confirma que el seu mòdul de gestió del consentiment està configurat per a GPP, i inspecciona les sol·licituds de licitació que surten del wrapper i també la crida final al servidor d'anuncis.

Patrons d'error habituals

• El stub es carrega després de les etiquetes d'anuncis — els socis no veuen cap CMP.
• Secció equivocada per a la regió — s'envia la secció de la UE per a tràfic dels EUA, o cap secció.
• Interfície i senyal sense sincronitzar — l'interruptor canvia, la cadena no.
• GPC ignorat — el senyal del navegador no es converteix mai en una baixa.
• Cadenes desactualitzades a les sol·licituds — el wrapper desa a la memòria cau el primer valor que va veure.

Punts clau

• Comença amb ping: la versió, l'estat, les seccions aplicables i la cadena t'expliquen la major part de la història.
• Fes servir getSection per llegir els camps de baixa; 1 vol dir que s'ha donat de baixa, 2 que no.
• Prova per separat l'enllaç de baixa i el GPC, i confirma que tots dos canvien el senyal.
• Escolta esdeveniments i espera un senyal “ready” abans que les sol·licituds d'anuncis llegeixin la cadena.
• Verifica gpp i gpp_sid en sol·licituds de xarxa reals, abans i després d'una baixa.