Installer sur Shopify

Ce que vous connectez

L'ajout au panier sur les fiches produit peut fonctionner via sans Web Pixel. Installez le pixel et le webhook pour le parcours panier → paiement → achat.

1. Activer Shopify Customer Privacy

Catail lit le consentement via l'API Customer Privacy. Pas de bannière Catail séparée en production Shopify.

1. Admin Shopify → Paramètres → Confidentialité client.
2. Activez la bannière pour vos régions.
3. Assurez des choix accepter/refuser analytics équivalents.
4. Enregistrez.

2. Activer l'app embed dans le thème

Méthode recommandée. Le tracker est géré par Shopify et supprimé automatiquement à la désinstallation — aucun code résiduel dans vos fichiers de thème.

1. Admin Shopify → Boutique en ligne → Thèmes.
2. À côté de votre thème actif, cliquez sur Personnaliser.
3. Dans le panneau gauche, ouvrez App embeds (icône puzzle).
4. Repérez Catail Analytics et activez le bouton.
5. Cliquez sur Enregistrer en haut à droite.

Optionnel : ajouter le bloc page produit

Ajoutez le bloc page produit Catail si vous voulez afficher des variantes de page produit approuvées sur votre modèle produit live. Le bloc conserve une mise en page de secours, donc la page reste utilisable même sans test actif.

1. Admin Shopify → Boutique en ligne → Thèmes → Personnaliser.
2. Ouvrez un modèle produit.
3. Ajoutez le bloc app Catail Product page / PDP Container au modèle.
4. Choisissez la mise en page de secours à afficher lorsqu'aucun test n'est actif.
5. Enregistrez et prévisualisez une page produit avant publication.

Vérifier l'embed

Alternative (storefronts headless) : console marchande Catail → votre projet → Counter → Legacy: manual theme snippet — copiez l'extrait production (avec votre counter_id) et collez-le avant </body> dans layout/theme.liquid.

1. Ouvrez la boutique en navigation privée.
2. Acceptez analytics dans la bannière Shopify.
3. Parcourez une ou deux pages.
4. Dans l'app Catail ou Counter : Tracker live / Receiving events = Yes.

3. Web Pixel et confidentialité

Le Web Pixel s'exécute dans le sandbox Shopify. Configurez Customer privacy sur l'app Catail avant les événements checkout.

Réglages confidentialité (obligatoire)

1. Admin Shopify → Paramètres → Apps et canaux de vente.
2. Ouvrez framework (Catail) → Customer privacy.
3. Permission : Required.
4. Finalités : cochez Analytics uniquement. Pas Marketing ni Preferences.
5. Data sale : Data collected does not qualify as data sale.
6. Enregistrez.

Code du pixel

1. Dans les paramètres app, zone Web Pixel / code personnalisé.
2. Dans Counter Catail, section Commerce funnel.
3. Copiez l'extrait Web Pixel et collez dans Shopify.
4. Enregistrez.

4. Webhook orders/create

Shop Pay peut ne pas déclencher checkout_completed. Le webhook enregistre les achats de façon fiable.

Il lit catail_session_key dans les attributs de commande, écrit par le tracker thème.

1. Dans Counter Catail, terminez d'abord le thème et le Web Pixel.
2. Cliquez sur Connect Shopify app (OAuth) dans Commerce funnel.
3. Vérifiez que le statut indique orders/create webhook active.
4. N'utilisez pas Admin Shopify → Paramètres → Notifications → Webhooks (obsolète en 2026).

Dépannage