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
| API | Disponible |
|---|---|
browser.localStorage | Oui |
browser.cookie | Non |
document.cookie | Non |
window.localStorage | Non (utiliser browser.localStorage) |
fetch / sendBeacon | Oui |
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 ID —
gclid,fbclid,ttclidextraits de l'URL de la page - Paramètres UTM —
utm_source,utm_medium,utm_campaign,utm_term,utm_content - Facebook Browser ID —
_fbpgé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.