ConverlayConverlay

Fonctionnement du Pixel

Converlay utilise l'API Web Pixels de Shopify pour capturer les événements de la vitrine. Le pixel s'exécute dans une iframe sandboxée entièrement gérée par Shopify, garantissant un impact nul sur les performances de votre boutique.

Exécution sandboxée

Shopify charge les pixels personnalisés dans un sandbox isolé. Cela signifie que le pixel ne peut pas accéder au DOM de la page principale, aux cookies ni interférer avec votre vitrine. Il reçoit les événements via le bus d'événements de Shopify.

API navigateur disponibles

APIDisponible
browser.localStorageOui
browser.cookieNon
document.cookieNon
window.localStorageNon (utiliser browser.localStorage)
fetch / sendBeaconOui

Données capturées

Chaque payload d'événement comprend :

  • Client ID — identifiant persistant stocké dans browser.localStorage
  • Session ID — fenêtre glissante de 30 minutes, également persistée dans localStorage
  • Click IDgclid, fbclid, ttclid extraits de l'URL de la page
  • Paramètres UTMutm_source, utm_medium, utm_campaign, utm_term, utm_content
  • Facebook Browser ID_fbp généré à partir du client ID, _fbc à partir du fbclid
  • PII du checkout — e-mail, téléphone, nom, adresse (hachés côté serveur avec SHA-256 avant transfert)
  • État du consentement — mappé depuis l'API Customer Privacy de Shopify vers les signaux Google Consent Mode v2

Transport

Les événements sont envoyés au point de collecte Converlay via navigator.sendBeacon pour garantir la fiabilité lors des changements de page. Si sendBeacon n'est pas disponible, le pixel utilise une requête fetch POST standard en remplacement.

Persistance

Le Client ID et le Session ID sont stockés dans browser.localStorage. Si localStorage n'est pas disponible (par ex., dans certains navigateurs axés sur la confidentialité), le pixel utilise un stockage en mémoire. Les identifiants seront régénérés à chaque chargement de page dans ce cas.

Versionnage du pixel

Chaque déploiement du pixel comprend un numéro de version et un hash de commit. Vous pouvez vérifier la version en cours dans votre tableau de bord Converlay ou dans la console du navigateur en recherchant les entrées de log [Converlay].

Mise en cache

Shopify met agressivement en cache le code des web pixels. Après le déploiement d'une nouvelle version du pixel, les boutiques doivent déconnecter puis reconnecter le pixel dans Paramètres → Événements clients pour que les modifications de code prennent effet. Les modifications de paramètres peuvent être poussées à distance via le système de mise à jour groupée.