Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.taap.it/llms.txt

Use this file to discover all available pages before exploring further.

L’intégration Shopify de Taapit fournit un suivi de conversion entièrement automatique sans app à installer. Ajoutez un script dans votre thème, configurez trois webhooks, et chaque checkout et commande est automatiquement attribué à vos liens Taapit.

​
Comment ça marche

Taapit Shopify integration

​
Fonctionnalités

  • ✅ Aucune app requise – Juste un script et des webhooks
  • ✅ Suivi automatique – Chaque checkout et commande est suivi
  • ✅ Attribution complète – Fonctionne entre les sessions (cookie 90 jours)
  • ✅ Synchronisation en temps réel – Les événements apparaissent instantanément
  • ✅ Multi-devise – Supporte toutes les devises Shopify

​
Prérequis

Important : Pour que le suivi des conversions fonctionne, les utilisateurs doivent arriver sur votre boutique via un deeplink Taapit. C’est ainsi que l’ID de suivi (ta_tid) est généré et transmis à votre boutique.
Masquez le bouton “Acheter maintenant” : Le bouton Acheter maintenant (checkout accéléré) contourne le panier et va directement au paiement — ce flux ne peut pas être tracké. Vous devez le désactiver dans votre thème afin que tous les clients passent par le flux standard Ajouter au panier → Commander.Pour le masquer : ouvrez l’éditeur de thème → sélectionnez une section de page produit → trouvez Boutons de paiement dynamiques et décochez-le, puis enregistrez.
Avant de commencer :
  1. Créez un deeplink Taapit pointant vers votre boutique Shopify ou une page produit
  2. Activez le suivi des conversions sur votre lien dans le dashboard Taapit

​
Installation

1

Ajoutez le script dans theme.liquid

Copiez ce script :
<script
  defer
  src="https://taap.it/api/shopify/script"
></script>
Puis ajoutez-le dans votre thème :
  1. Dans l’admin Shopify, allez dans Boutique en ligne → Thèmes
  2. Cliquez sur Personnaliser → Modifier le code sur votre thème actif
  3. Ouvrez le fichier theme.liquid
  4. Collez le script juste avant la balise fermante </head>, puis enregistrez
Le script capture l’ID de suivi ta_tid depuis les liens Taapit et le stocke dans un cookie et le localStorage pendant 90 jours. Il attache également l’ID de suivi aux attributs du panier pour qu’il survive jusqu’à la commande.
2

Configurez les Webhooks

Vous devez créer 3 webhooks dans Shopify pointant vers votre URL webhook Taapit.Votre URL webhook (disponible dans votre dashboard Taapit sous Paramètres → Analytics → Shopify) :
https://track.taap.it/api/shopify/webhook?workspaceId=VOTRE_WORKSPACE_ID
Étapes de configuration dans Shopify :
  1. Dans l’admin Shopify, allez dans Paramètres → Notifications
  2. Faites défiler jusqu’à la section Webhooks et cliquez sur Créer un webhook
  3. Choisissez l’événement : Paiement de commande → collez l’URL webhook → enregistrez
  4. Répétez pour Création de checkout
  5. Répétez pour Mise à jour de checkout
Vous devez créer 3 webhooks distincts avec la même URL :
  • orders/paid → enregistre un événement Vente
  • checkouts/create → enregistre un événement Lead
  • checkouts/update → met à jour le Lead si le panier change
Votre workspace ID est déjà inclus dans l’URL affichée dans votre dashboard.
3

Vérifiez la configuration

  1. Visitez votre boutique depuis un lien Taapit (vous devriez voir ?ta_tid=xxx dans l’URL)
  2. Vérifiez DevTools → Application → Cookies pour le cookie ta_tid
  3. Ajoutez un produit au panier et passez au checkout
  4. Consultez l’onglet Analytics dans Taapit — un événement Lead devrait apparaître
  5. Finalisez une commande test — un événement Vente devrait apparaître

​
Comment le suivi fonctionne

  1. Le visiteur arrive via un lien Taapit avec ?ta_tid=xxx
  2. Le script capture le ta_tid et le stocke dans un cookie et le localStorage
  3. Le script ajoute l’ID de suivi aux attributs du panier (persiste jusqu’au paiement)
  4. Le client clique sur Commander — l’ID de suivi est transmis via les attributs du panier
  5. Le webhook de commande envoie les détails + ID de suivi à Taapit
  6. La conversion est enregistrée et attribuée au lien original
Ce flux ne fonctionne que si le client passe par le checkout standard via le panier. Le bouton Acheter maintenant (checkout accéléré) contourne le panier, donc l’ID de suivi n’est jamais rattaché. Assurez-vous de le désactiver dans votre thème.

​
Événements suivis

Événement ShopifyÉvénement TaapitQuand
checkouts/createLeadLe client démarre le checkout
checkouts/updateLead mis à jourLe panier est modifié
orders/paidVenteLa commande est payée

​
Dépannage

  1. Vérifiez que le script est présent dans votre theme.liquid (avant </head>)
  2. Vérifiez que les 3 webhooks sont correctement configurés avec votre workspace ID
  3. Vérifiez que le bouton Acheter maintenant est masqué — les commandes passées par ce bouton ne peuvent pas être trackées
  4. Vérifiez la présence du cookie ta_tid dans les DevTools de votre navigateur
Fonctionne avec tous les thèmes Shopify permettant la modification du theme.liquid. Pour les configurations headless (Hydrogen, storefronts personnalisés), utilisez l’intégration manuelle côté client.

​
Prochaines étapes

Intégration Stripe

Vous utilisez aussi Stripe ? Ajoutez l’intégration Stripe.

Créer votre premier lien

Créez un lien Taapit pour commencer le suivi.