Intégration Shopify

Suivez les performances de votre boutique Shopify avec des analyses axées sur la confidentialité. Obtenez une visibilité complète sur les parcours clients, les performances des produits et l'attribution des revenus.

---

Démarrage rapide

Choisissez votre méthode d'installation préférée :

---

Méthode 1 : Application Shopify (recommandée)

Installation

1. Visitez l'application Zenovay dans la Shopify App Store
2. Cliquez sur Ajouter l'application
3. Vérifiez les autorisations et cliquez sur Installer
4. Connectez votre compte Zenovay ou créez-en un nouveau
5. Terminez l'assistant de configuration

Ce qui est installé

L'application installe automatiquement :

• Le script de suivi dans votre thème
• La configuration du suivi des événements eCommerce
• Le suivi du tunnel de paiement et de la page de remerciement
• L'attribution du parcours client

Mises à jour

L'application Shopify se met à jour automatiquement lorsque de nouvelles fonctionnalités sont publiées. Aucune action requise.

---

Méthode 2 : Installation manuelle dans le thème

Étape 1 : Ajouter le script de suivi

1. Allez dans Boutique en ligne → Thèmes
2. Cliquez sur Actions → Modifier le code
3. Ouvrez theme.liquid (sous Layout)
4. Ajoutez avant </head> :

<!-- Zenovay Analytics -->
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>

Étape 2 : Ajouter le suivi eCommerce

Créez un nouveau fichier de snippet snippets/zenovay-ecommerce.liquid :

{% comment %}
  Zenovay eCommerce Tracking
  Include this in theme.liquid before </body>
{% endcomment %}

<script>
  window.zenovayEcommerce = window.zenovayEcommerce || {};

  {% if template contains 'product' %}
    // Track product views
    window.zenovayEcommerce.product = {
      id: '{{ product.id }}',
      name: '{{ product.title | escape }}',
      price: {{ product.price | money_without_currency | remove: ',' }},
      currency: '{{ shop.currency }}',
      category: '{{ product.type | escape }}',
      vendor: '{{ product.vendor | escape }}'
    };

    document.addEventListener('DOMContentLoaded', function() {
      if (window.zenovay) {
        window.zenovay('track', 'product_viewed', window.zenovayEcommerce.product);
      }
    });
  {% endif %}

  {% if template contains 'collection' %}
    // Track collection views
    window.zenovayEcommerce.collection = {
      id: '{{ collection.id }}',
      name: '{{ collection.title | escape }}',
      products_count: {{ collection.products_count }}
    };

    document.addEventListener('DOMContentLoaded', function() {
      if (window.zenovay) {
        window.zenovay('track', 'collection_viewed', window.zenovayEcommerce.collection);
      }
    });
  {% endif %}
</script>

Incluez le snippet dans theme.liquid avant </body> :

{% render 'zenovay-ecommerce' %}

Étape 3 : Suivi du panier

Ajoutez à votre gestionnaire de bouton « Ajouter au panier » ou créez snippets/zenovay-cart.liquid :

<script>
document.addEventListener('DOMContentLoaded', function() {
  // Listen for add to cart events
  document.querySelectorAll('[data-add-to-cart], .add-to-cart, form[action*="/cart/add"]').forEach(function(form) {
    form.addEventListener('submit', function(e) {
      var product = window.zenovayEcommerce?.product;
      if (product && window.zenovay) {
        window.zenovay('track', 'add_to_cart', {
          product_id: product.id,
          product_name: product.name,
          price: product.price,
          currency: '{{ shop.currency }}',
          quantity: 1
        });
      }
    });
  });
});
</script>

---

Méthode 3 : Shopify Plus (extensibilité du tunnel de paiement)

Les marchands Shopify Plus peuvent suivre les événements du tunnel de paiement grâce à l'extensibilité du paiement.

Suivi de la page de remerciement

Ajoutez à Paramètres → Paiement → Page de statut de la commande → Scripts supplémentaires :

{% if first_time_accessed %}
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
<script>
  document.addEventListener('DOMContentLoaded', function() {
    if (window.zenovay) {
      window.zenovay('track', 'purchase', {
        transaction_id: '{{ order.name }}',
        order_id: '{{ order.id }}',
        revenue: {{ checkout.total_price | money_without_currency | remove: ',' }},
        currency: '{{ checkout.currency }}',
        tax: {{ checkout.tax_price | money_without_currency | remove: ',' }},
        shipping: {{ checkout.shipping_price | money_without_currency | remove: ',' }},
        items: [
          {% for line_item in checkout.line_items %}
          {
            product_id: '{{ line_item.product_id }}',
            name: '{{ line_item.title | escape }}',
            price: {{ line_item.final_price | money_without_currency | remove: ',' }},
            quantity: {{ line_item.quantity }}
          }{% unless forloop.last %},{% endunless %}
          {% endfor %}
        ]
      });

      // Identify customer (optional)
      {% if checkout.email %}
      window.zenovay('identify', {
        email: '{{ checkout.email }}'
      });
      {% endif %}
    }
  });
</script>
{% endif %}

Extensibilité du paiement (App Block)

Pour un suivi complet du tunnel de paiement sur Shopify Plus :

1. Installez l'application Zenovay Shopify
2. Allez dans Paramètres → Paiement → Personnaliser
3. Ajoutez le bloc d'application Suivi Zenovay
4. Positionnez-le dans le tunnel de paiement

---

Événements automatiques

Zenovay suit automatiquement ces événements Shopify :

---

Suivi des événements personnalisés

Suivez des événements supplémentaires spécifiques à votre boutique :

Actions de liste de souhaits

// When user adds to wishlist
window.zenovay('track', 'wishlist_add', {
  product_id: '12345',
  product_name: 'Product Name',
  price: 29.99
});

// When user removes from wishlist
window.zenovay('track', 'wishlist_remove', {
  product_id: '12345'
});

Interactions avec les produits

// Image gallery navigation
window.zenovay('track', 'product_image_viewed', {
  product_id: '12345',
  image_index: 2
});

// Size guide opened
window.zenovay('track', 'size_guide_opened', {
  product_id: '12345'
});

// Reviews section viewed
window.zenovay('track', 'reviews_viewed', {
  product_id: '12345',
  reviews_count: 47
});

Événements promotionnels

// Coupon applied
window.zenovay('track', 'coupon_applied', {
  coupon_code: 'SAVE20',
  discount_value: 20.00
});

// Newsletter signup
window.zenovay('track', 'newsletter_signup', {
  source: 'popup'
});

---

Attribution des revenus

Reliez les achats à leurs sources :

Suivi UTM

Zenovay capture automatiquement les paramètres UTM :

https://yourstore.com/products/item?utm_source=instagram&utm_medium=paid&utm_campaign=summer_sale

Consultez les revenus par :

• Source : Google, Instagram, Email, etc.
• Medium : organique, payant, référence, email
• Campagne : Campagnes marketing spécifiques
• Contenu : Variations de tests A/B

Suivi first-party

Pour les boutiques utilisant le contournement des bloqueurs de publicité, utilisez le suivi first-party :

// In theme.liquid
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  data-api-url="/api/_z/"
  src="/api/_z/script.js">
</script>

---

Analyse du parcours client

Suivez le chemin complet de la première visite à l'achat :

Liaison de sessions

Zenovay lie automatiquement les sessions lorsque les clients :

• Créent un compte
• Finalisent un paiement
• S'abonnent à la newsletter

Identification des clients

Identifiez explicitement les clients pour le suivi multi-appareils :

{% if customer %}
<script>
  document.addEventListener('DOMContentLoaded', function() {
    if (window.zenovay) {
      window.zenovay('identify', {
        email: '{{ customer.email }}',
        userId: '{{ customer.id }}',
        name: '{{ customer.name | escape }}'
      });
    }
  });
</script>
{% endif %}

---

Métriques du tableau de bord

Métriques clés disponibles dans votre tableau de bord Zenovay :

Métriques eCommerce

Analyse du tunnel

Visualisez votre tunnel de conversion :

1. Visite de la boutique → Vue produit
2. Vue produit → Ajout au panier
3. Ajout au panier → Début du paiement
4. Début du paiement → Achat

Identifiez où les clients abandonnent et optimisez ces pages.

---

Dépannage

Le script ne se charge pas

Symptômes : Aucune donnée dans le tableau de bord Zenovay

Solutions :

1. Vérifiez les erreurs dans la console du navigateur
2. Vérifiez que le code de suivi est correct
3. Assurez-vous que le script est dans theme.liquid, pas dans un template
4. Vérifiez si des bloqueurs de publicité bloquent (utilisez le suivi first-party)

Pages vues en double

Symptômes : Le nombre de pages vues est 2× la valeur attendue

Solutions :

1. Assurez-vous que le script de suivi n'est ajouté qu'une seule fois
2. Vérifiez qu'il n'y a pas d'installation via l'application ET manuelle
3. Supprimez le suivi des templates individuels s'il est déjà dans theme.liquid

Événements d'achat manquants

Symptômes : Les transactions ne sont pas suivies

Solutions :

1. Pour Shopify Plus : ajoutez le script aux scripts supplémentaires du tunnel de paiement
2. Vérifiez que la condition first_time_accessed est utilisée
3. Vérifiez que le script de la page de statut de commande s'exécute

Les événements ne correspondent pas aux revenus

Symptômes : Les revenus suivis ne correspondent pas à Shopify

Solutions :

1. Assurez-vous que la conversion de devise est correcte
2. Vérifiez les transactions manquantes (timing du script)
3. Vérifiez que l'extraction du prix supprime les symboles de devise

---

Configuration de la confidentialité

Intégration du consentement aux cookies

Si vous utilisez une plateforme de gestion du consentement :

// Load tracking script after consent
document.addEventListener('cookieconsent:accepted', function() {
  var s = document.createElement('script');
  s.defer = true;
  s.src = 'https://api.zenovay.com/z.js';
  s.dataset.trackingCode = 'YOUR_TRACKING_CODE';
  document.head.appendChild(s);
});

Conformité RGPD

Zenovay est axé sur la confidentialité :

• Aucune donnée personnelle collectée sans consentement
• Aucun suivi cross-site
• Données stockées dans l'UE (configurable)
• Respect des en-têtes Do Not Track

Consultez le Guide de conformité RGPD pour une configuration détaillée.

---

Performance

Chargement du script

Le script Zenovay est :

• Différé : Ne bloque pas le rendu de la page
• Léger : < 5 Ko compressé
• En cache : Livré via CDN mondial

Impact sur les Core Web Vitals

---

Bonnes pratiques

1. Utilisez l'application Shopify lorsque c'est possible pour les mises à jour automatiques
2. Activez le suivi first-party pour une meilleure précision des données
3. Suivez les événements personnalisés pour les interactions importantes
4. Configurez des objectifs de conversion pour les actions clés
5. Examinez les tunnels chaque semaine pour identifier les opportunités d'optimisation

---

Ressources associées

• Guide de suivi eCommerce
• Tunnels de conversion
• Attribution des revenus
• Suivi first-party
• Dépannage

---

Besoin d'aide ? Contactez [email protected] ou visitez notre Centre d'aide.