Référence des événements

Converlay suit automatiquement 10 événements de la vitrine via l'API Web Pixels de Shopify. Aucune configuration manuelle n'est requise — tous les événements se déclenchent automatiquement lorsqu'un visiteur interagit avec votre boutique.

Événements auto-suivis

Événement	Déclencheur	Données clés
`page_view`	Chaque chargement de page	URL, referrer, UTMs
`view_item`	Page produit consultée	ID produit, nom, prix, variante
`view_item_list`	Collection / résultats de recherche consultés	ID de la liste d'articles, articles
`add_to_cart`	Article ajouté au panier	ID produit, quantité, prix
`remove_from_cart`	Article retiré du panier	ID produit, quantité
`search`	Recherche effectuée	Terme de recherche
`begin_checkout`	Checkout démarré	Valeur du panier, articles
`add_payment_info`	Informations de paiement saisies	Méthode de paiement
`add_shipping_info`	Informations de livraison saisies	Méthode de livraison
`purchase`	Commande finalisée	ID de transaction, valeur, articles, données utilisateur

Structure du payload d'événement

Chaque événement envoyé au point de collecte Converlay suit cette structure. Voici un exemple d'événement purchase :

purchase event payload

{
  "event_id": "evt_abc123",
  "event_name": "purchase",
  "shop_domain": "my-store.myshopify.com",
  "page_url": "https://my-store.com/thank-you",
  "client_id": "clid_...",
  "session_id": "sid_...",
  "fbp": "fb.1.1700000000000.1234567890",
  "gclid": "CjwKCAiA...",
  "consent_data": {
    "analytics": true,
    "marketing": true,
    "ad_user_data": true,
    "ad_personalization": true
  },
  "ecommerce": {
    "transaction_id": "5678",
    "value": 129.99,
    "currency": "USD",
    "items": [
      {
        "item_id": "gid://shopify/ProductVariant/123",
        "item_name": "Classic Tee",
        "price": 29.99,
        "quantity": 2
      }
    ]
  },
  "user_data": {
    "email": "sha256:abc...",
    "phone": "sha256:def..."
  }
}

Traitement des PII

Les données utilisateur (e-mail, téléphone, adresse) sont hachées avec SHA-256 côté serveur avant le transfert vers les plateformes publicitaires. Les PII brutes ne sont jamais stockées ni partagées. Une normalisation spécifique au pays est appliquée avant le hachage.

Enrichissement des événements

Avant le transfert, chaque événement est enrichi avec :

Rattachement des Click ID — gclid, fbclid, ttclid sont conservés entre les sessions
Paramètres Facebook — _fbp et _fbc sont générés pour le matching Meta CAPI
Contexte de session — session glissante de 30 minutes avec un client ID persistant
Signaux de consentement — signaux Google Consent Mode v2 mappés depuis l'API Customer Privacy de Shopify
Déduplication des événements — un event_id unique empêche le double comptage entre les sources pixel et webhook

Précédent← Connecter les destinations SuivantConsentement et confidentialité →