Comment ajouter le snippet SeaText à Shopify avec Google Tag Manager
Ajoutez le snippet SeaText à Shopify via GTM en installant le snippet du conteneur GTM dans theme.liquid, puis en créant une balise HTML personnalisée dans GTM contenant le JavaScript de SeaText et déclenchée sur...

Ajoutez le snippet SeaText à Shopify avec Google Tag Manager en installant d'abord le snippet du conteneur GTM dans votre thème, puis en créant une balise HTML personnalisée dans GTM qui contient le JavaScript de SeaText. Déclenchez cette balise sur toutes les pages. Avant de commencer, vous devez disposer d'un compte SeaText et d'une copie du snippet JavaScript provenant de la section d'intégration SEATEXT AI.
Ce guide détaille la configuration étape par étape, y compris la balise de description de produit et la manière de vérifier que tout fonctionne correctement.
Ce dont vous avez besoin avant de commencer
Vous avez besoin de cinq éléments avant de commencer :
- Un compte SeaText. La page d'intégration de SeaText indique que vous en avez besoin avant de pouvoir installer le script.
- Le snippet JavaScript SeaText. Vous le copiez depuis la section d'intégration SEATEXT AI.
- Un accès administrateur à votre boutique Shopify afin de pouvoir modifier le code du thème.
- Un compte Google Tag Manager avec un conteneur créé. Vous aurez besoin de l'identifiant du conteneur, généralement GTM-XXXXXXX.
- Un domaine valide et réel. Les URL de développement telles que localhost sont restreintes.
Étape 1 : Obtenez votre snippet et votre compte SeaText
Si vous n'avez pas encore de compte SeaText, créez-en un d'abord. Les instructions d'intégration précisent qu'un compte est nécessaire avant de pouvoir installer le script.
Une fois connecté, accédez à la section d'intégration SEATEXT AI et copiez le code JavaScript qui s'y affiche. Conservez-le dans un endroit sûr. C'est le snippet que vous fournirez à Google Tag Manager.
Gardez à l'esprit la règle concernant le domaine : chaque compte SeaText est lié à une seule URL principale. Si vous souhaitez tester sur un domaine de développement et passer en production sur un autre, créez un compte distinct pour chacun. Localhost est bloqué, et les domaines de développement dynamiques peuvent ne pas fonctionner de manière fiable car SeaText pourrait ne pas être en mesure d'associer le trafic à votre compte.
Étape 2 : Ajouter le conteneur GTM à Shopify
Google Tag Manager ne peut rien charger tant que son propre snippet de conteneur n'est pas dans votre thème. Il s'agit d'une modification de code unique.
- Connectez-vous à votre interface administrateur Shopify.
- Allez dans Boutique en ligne et ouvrez Thèmes.
- À côté de votre thème actif, cliquez sur Actions et choisissez Modifier le code.
- Ouvrez le dossier Layout et cliquez sur theme.liquid.
- Collez le premier snippet GTM juste après la balise d'ouverture head.
- Collez le second snippet GTM, la version noscript, juste après la balise d'ouverture body.
- Cliquez sur Enregistrer.
Ne collez pas SeaText dans theme.liquid à ce stade. L'étape suivante consiste à attacher SeaText à GTM à la place. De cette façon, vous pourrez mettre à jour le snippet sans avoir à modifier à nouveau le code du thème.
Étape 3 : Créer la balise HTML personnalisée SeaText dans GTM
Ouvrez maintenant Google Tag Manager et ajoutez le snippet SeaText en tant que balise.
- Ouvrez votre espace de travail GTM.
- Cliquez sur Balises, puis sur Nouveau.
- Cliquez sur Configuration de la balise et choisissez HTML personnalisé.
- Collez le snippet JavaScript SeaText que vous avez copié à l'étape 1.
- Cliquez sur Déclenchement et choisissez Toutes les pages. Pour une configuration limitée aux produits, utilisez un déclencheur de chemin de page pour les pages produits.
- Cliquez sur Enregistrer et donnez à la balise un nom clair, tel que SeaText - Toutes les pages.
Une balise dans GTM ne s'exécute pas tant que vous n'avez pas soumis et publié le conteneur. Utilisez le mode Aperçu avant de publier.
Étape 4 : Ajouter la balise de description de produit de SeaText (si nécessaire)
L'intégration Shopify de SeaText inclut également une balise pour les descriptions de produits. Ne placez pas celle-ci dans GTM. Elle doit être placée dans le modèle de thème qui affiche la description du produit.
- Dans l'interface administrateur Shopify, allez dans Boutique en ligne et ouvrez Thèmes.
- Cliquez sur Actions et choisissez Modifier le code.
- Trouvez le modèle de produit. La source SeaText indique product.liquid ou product-template.liquid comme emplacements typiques.
- Localisez le code de sortie de la description du produit.
- Enveloppez cette sortie avec l'attribut de données ou le wrapper fourni par SeaText dans sa documentation.
- Cliquez sur Enregistrer.
Après l'enregistrement, prévisualisez une page produit et inspectez le code source HTML avec les outils de développement de votre navigateur. Vérifiez que l'attribut data- apparaît dans la sortie.
Étape 5 : Vérifier que le snippet SeaText se charge
La vérification est l'étape qui permet d'éviter le plus d'erreurs. Ne la sautez pas.
- Dans GTM, cliquez sur Aperçu pour ouvrir Tag Assistant.
- Ouvrez votre boutique Shopify dans un autre onglet et rechargez la page.
- Vérifiez si la balise SeaText - Toutes les pages se déclenche.
- Ouvrez les outils de développement du navigateur et passez à l'onglet Réseau. Recherchez une requête provenant du script SeaText.
- Si vous avez ajouté la balise de description de produit, ouvrez une page produit et inspectez le code source HTML pour vérifier l'attribut data-.
Si la balise GTM se déclenche mais qu'aucun script n'apparaît dans l'onglet Réseau, vérifiez le déclencheur et confirmez que la version du conteneur a été publiée. Si le script apparaît mais que l'attribut de produit est manquant, le problème se situe dans le modèle de produit, pas dans GTM.
Erreurs courantes et comment les éviter
- Installer sans compte. SeaText indique que vous avez besoin d'un compte SEATEXT AI avant d'installer le script.
- Utiliser le même compte pour plusieurs domaines. Chaque compte est lié à une seule URL principale. Utilisez des comptes séparés pour des domaines séparés.
- Tester sur localhost. Les URL de développement sont restreintes, utilisez donc un domaine réel valide.
- Publier GTM sans prévisualiser. Prévisualisez toujours d'abord, puis publiez.
- Coller SeaText à la fois dans theme.liquid et dans GTM. Cela peut charger le snippet deux fois. Choisissez une seule méthode.
- Modifier le mauvais thème. Assurez-vous de modifier le thème en direct, pas un duplicata.
- Essayer d'envelopper les descriptions de produits dans GTM. Ce wrapper va dans product.liquid ou product-template.liquid.
Faits clés : Installation de SeaText et règles de domaine
Le tableau ci-dessous liste les faits issus de la page d'intégration Shopify de SeaText.
| Fait | Détail |
|---|---|
| Exigence de compte | Vous avez besoin d'un compte SEATEXT AI avant d'installer le script. |
| Source du snippet | Copiez le code JavaScript depuis la section d'intégration SEATEXT AI. |
| Liaison de domaine | Chaque compte SEATEXT AI est lié à une seule URL principale. |
| Domaines multiples | Créez des comptes séparés pour chaque domaine. |
| URL de développement | Localhost est restreint ; utilisez un domaine réel valide. |
| Sécurité | Le processus d'installation est sécurisé et l'IA reste inerte jusqu'à son activation. |
| Balise de description de produit | Enveloppez la sortie de la description du produit et vérifiez l'attribut data- dans le code source HTML. |
Limitations et cas où ce guide ne s'applique pas
Ce guide suppose l'utilisation d'un thème Shopify Online Store 2.0 standard avec un fichier theme.liquid. La plupart des thèmes fonctionnent ainsi, mais les configurations headless ou les thèmes fortement personnalisés peuvent placer les scripts différemment.
GTM déclenche les balises de manière asynchrone. Si la documentation SeaText demande un déclencheur spécifique, tel que DOM Ready ou Window Loaded, utilisez ce déclencheur au lieu de Toutes les pages. Le bon déclencheur dépend de ce à quoi le script doit accéder sur la page.
La règle du domaine s'applique toujours lorsque vous utilisez GTM. Un compte SeaText est lié à une URL principale, et les URL de développement telles que localhost sont restreintes. Si vous passez d'un sous-domaine de staging à votre domaine de production, prévoyez de créer un compte séparé plutôt que de supposer que le même snippet fonctionnera.
Si vous ne souhaitez pas utiliser GTM du tout, vous pouvez coller le snippet SeaText directement dans theme.liquid en suivant les étapes d'intégration Shopify de SeaText. GTM est une couche de gestion, pas une exigence pour SeaText.
SeaText et GTM : terminologie en français simple
- Snippet : un petit morceau de code JavaScript que vous ajoutez à une page.
- Conteneur : votre espace de travail Google Tag Manager et ses paramètres.
- Balise (Tag) : un bloc de code dans GTM qui se déclenche lorsque des conditions sont remplies.
- Déclencheur (Trigger) : la condition, telle que Toutes les pages, qui indique à une balise quand s'exécuter.
- theme.liquid : le fichier de mise en page principal de votre thème Shopify qui enveloppe chaque page.
Questions fréquemment posées
Ai-je besoin d'un compte SeaText séparé pour ma boutique de développement ?
Oui. Chaque compte SeaText est lié à une seule URL principale, et localhost est restreint. Utilisez un domaine réel pour chaque environnement.
Puis-je installer SeaText sans GTM ?
Oui. Collez le snippet directement dans theme.liquid ou suivez les étapes d'intégration Shopify de SeaText. GTM facilite simplement la gestion du snippet.
Pourquoi utiliser GTM si je peux coller le snippet dans theme.liquid ?
GTM vous permet de mettre à jour le snippet, d'ajouter des déclencheurs et de gérer d'autres scripts tiers au même endroit sans modifier le code du thème à chaque fois.
Où dois-je coller le conteneur GTM dans Shopify ?
Dans theme.liquid. Ajoutez la première partie après la balise d'ouverture head et la partie noscript après la balise d'ouverture body.
Comment savoir si le snippet SeaText fonctionne ?
Utilisez le mode Aperçu de GTM pour confirmer que la balise se déclenche, puis vérifiez l'onglet Réseau pour le script. Pour la balise de description de produit, inspectez le code source HTML de la page pour l'attribut data-.
La balise de description de produit nécessite-t-elle GTM ?
Non. Elle appartient au modèle de produit, généralement product.liquid ou product-template.liquid.
Lectures complémentaires et sources de comparaison
Ces sources externes fournissent un contexte supplémentaire pour évaluer le sujet. Leur inclusion ne constitue pas une approbation.
Comment SeaText peut vous aider
Comment SeaText peut vous aider
SeaText vous fournit un snippet JavaScript conçu pour votre boutique Shopify. Le processus d'installation est sécurisé et l'IA reste inerte jusqu'à ce que vous l'activiez. Avant d'installer, créez un compte SeaText et utilisez un domaine réel valide, car chaque compte est lié à une URL principale. Pour les descriptions de produits, SeaText fournit également une balise d'attribut de données séparée que vous enveloppez autour de la sortie de la description du produit dans votre modèle de thème.
Utilisez le guide d'intégration officiel pour voir le code exact que votre compte génère et pour éviter de placer le snippet dans le mauvais fichier.
Ready to Take the Next Step?
See how our verified tools and services help you put this guide into practice.