Come funziona il Pixel

Converlay utilizza la Web Pixels API di Shopify per catturare gli eventi della storefront. Il pixel viene eseguito all'interno di un iframe sandboxed gestito interamente da Shopify, garantendo zero impatto sulle prestazioni del tuo negozio.

Esecuzione sandboxed

Shopify carica i pixel personalizzati in una sandbox isolata. Questo significa che il pixel non può accedere al DOM della pagina principale, ai cookie o interferire con la tua storefront. Riceve gli eventi tramite l'event bus di Shopify.

API del browser disponibili

Dati catturati

Ogni payload dell'evento include:

• Client ID — identificativo persistente salvato in browser.localStorage
• Session ID — finestra mobile di 30 minuti, anch'essa salvata in localStorage
• Click ID — gclid, fbclid, ttclid estratti dall'URL della pagina
• Parametri UTM — utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Facebook Browser ID — _fbp generato dal client ID, _fbc dal fbclid
• PII dal checkout — email, telefono, nome, indirizzo (sottoposti a hashing server-side con SHA-256 prima dell'inoltro)
• Stato del consenso — mappato dalla Customer Privacy API di Shopify ai segnali Google Consent Mode v2

Trasporto

Gli eventi vengono inviati all'endpoint di raccolta di Converlay tramite navigator.sendBeacon per garantire l'affidabilità durante lo scaricamento della pagina. Se sendBeacon non è disponibile, il pixel utilizza una richiesta POST fetch standard come fallback.

Versionamento del pixel

Ogni distribuzione del pixel include un numero di versione e un hash del commit. Puoi verificare la versione in esecuzione nella dashboard di Converlay o nella console del browser cercando le voci di log [Converlay].