Comment vérifier la connexion de SeaText AI à votre boutique Shopify

Vous pouvez vérifier que SeaText AI est correctement connecté à votre boutique Shopify en ouvrant une page produit dans un navigateur et en inspectant le code HTML à la recherche de l'attribut data-seatext. Vous devez également confirmer que l'extrait JavaScript de SeaText est toujours présent dans le fichier theme.liquid de votre thème Shopify actif. Lorsque ces deux vérifications sont validées, la connexion est active.

Pourquoi la vérification est importante

SeaText utilise JavaScript sur votre boutique pour exécuter des agents IA autonomes. Ces agents peuvent réécrire les titres, les offres, les blocs de produits et les CTA en fonction du mot-clé ou de la campagne derrière chaque visite. Si le script n'est pas connecté, les agents n'ont aucun moyen de lire les données de la boutique ou de publier des modifications. Vous pourriez penser qu'une campagne est optimisée alors que la boutique affiche en réalité la page par défaut.

La vérification vous donne l'assurance que la couche de diffusion fonctionne avant de vous fier à une quelconque sortie de l'IA. Elle vous aide également à détecter les petits problèmes, comme un extrait manquant après une mise à jour du thème, avant qu'ils n'affectent les conversions.

Ce qu'une connexion SeaText correcte signifie

Une connexion correcte est plus qu'un simple script enregistré. Cela signifie que le script SeaText peut se charger avec votre thème Shopify, trouver la description du produit et marquer le contenu qu'il a traité.

SeaText s'installe sous forme de JavaScript que vous collez dans votre thème. Avant l'activation, l'IA reste inerte. Elle ne modifie pas votre boutique tant qu'elle n'est pas activée. Cela protège votre contenu pendant l'installation.

La vérification doit répondre à trois questions. L'extrait est-il dans le thème actif ? La page produit le charge-t-elle ? Le script peut-il attacher son attribut data- à un élément traité ?

Si les trois réponses sont oui, SeaText peut communiquer avec les données de votre boutique.

Comment le script SeaText se charge dans theme.liquid

Le guide d'intégration Shopify de SeaText vous indique de placer un extrait JavaScript dans theme.liquid. Ce fichier contrôle la mise en page globale de votre thème de boutique.

Commencez dans votre interface administrateur Shopify. Allez dans Boutique en ligne, puis Thèmes. Ouvrez le menu Actions de votre thème actif et choisissez Modifier le code. Dans le dossier Layout, ouvrez theme.liquid. Collez l'extrait de code SeaText et cliquez sur Enregistrer.

theme.liquid est l'emplacement idéal pour le script car Shopify le charge sur chaque page utilisant votre thème. Cela signifie que les pages produits, les pages de collection et les pages d'accueil ont toutes une chance d'exécuter le code SeaText.

Si vous collez l'extrait dans un thème différent, il ne s'exécutera pas sur la boutique en ligne. Le thème actif est celui que voient vos visiteurs. Un thème dupliqué ou archivé ne suffit pas.

Le modèle de produit compte également. Le guide d'intégration de SeaText indique d'implémenter la balise dans les descriptions de produits. Localisez le fichier qui affiche la description du produit, généralement product.liquid ou product-template.liquid. Enveloppez la sortie de la description du produit afin que le script sache quel contenu optimiser.

Lorsque l'extrait est présent et que la description est enveloppée, le script peut se charger sur la page produit et préparer le contenu pour que SeaText le modifie.

À quoi ressemble une communication réussie du script dans le navigateur

Une communication réussie est visible dans le code HTML rendu. SeaText insère un attribut data- sur les éléments qu'il a traités. Les outils de développement de votre navigateur afficheront cet attribut sur la description du produit ou sur d'autres éléments de page modifiés.

Vous n'avez pas besoin de voir des journaux complexes. La présence de l'attribut data- est le signal pratique que le script s'est chargé et a fait son travail.

Une communication réussie signifie également que la boutique continue de fonctionner normalement. La description du produit doit s'afficher correctement après que SeaText l'ait modifiée. Si la page s'affiche sans erreur et que l'attribut data- est présent, le script peut communiquer avec les données de votre boutique.

Gardez à l'esprit que SeaText peut ne pas réécrire chaque élément immédiatement. L'IA ne devient active qu'après que vous ayez activé les agents dont vous avez besoin. Un script inerte peut toujours être connecté ; il n'a tout simplement pas reçu l'ordre de modifier le contenu.

Comment vérifier l'attribut data-seatext

Ouvrez votre boutique Shopify dans un navigateur. Allez sur une page produit qui contient la description de produit enveloppée.

Faites un clic droit sur la page et choisissez Inspecter. Cela ouvre les outils de développement. Dans l'onglet Éléments, recherchez data-seatext ou l'attribut data- décrit dans la documentation SeaText.

Utilisez la zone de recherche dans le panneau Éléments pour trouver l'attribut. Le navigateur mettra en surbrillance l'élément HTML correspondant.

Si l'attribut apparaît, le script est actif sur cette page. S'il n'apparaît pas, poursuivez avec les étapes de dépannage ci-dessous.

Vous pouvez également vérifier en consultant la source HTML. Le guide d'intégration indique de prévisualiser une page produit et de confirmer que l'attribut data- est présent dans la source HTML. Les outils de développement vous donnent la même vue avec plus de contexte.

Pourquoi chaque compte a besoin d'une URL principale

Chaque compte SeaText AI est lié à une seule URL principale. Cette URL est le domaine de la boutique connecté au compte.

Si vous essayez d'utiliser le même compte sur plusieurs domaines, la connexion ne fonctionnera pas correctement. Par exemple, un domaine de développement et un domaine de production doivent avoir des comptes distincts.

Cette règle protège la mesure du trafic. SeaText doit savoir quelles visites appartiennent à votre boutique. Si une page se charge à partir d'un domaine différent de l'URL principale, le script peut toujours s'exécuter, mais SeaText peut ne pas associer ce trafic à votre compte.

Les URL de développement telles que localhost sont restreintes pour des raisons de sécurité. Ce ne sont pas des boutiques de production valides, donc SeaText les bloque. Les domaines de développement dynamiques peuvent également échouer car SeaText ne peut pas associer de manière fiable le trafic à votre compte.

Pendant la vérification, comparez le domaine de la boutique à l'URL principale de votre compte SeaText. S'ils ne correspondent pas, la connexion n'est pas complète. Vérifiez auprès du fournisseur si vous devez modifier l'URL principale.

Comment résoudre les causes courantes de déconnexion

Utilisez cette liste de contrôle dans l'ordre. Elle isolera la plupart des problèmes de connexion.

1. Ouvrez Boutique en ligne, Thèmes, Actions, Modifier le code pour le thème actif. Ouvrez Layout/theme.liquid. Recherchez l'extrait SeaText. S'il est manquant, collez-le à nouveau et enregistrez.
2. Confirmez que l'URL principale du compte correspond au domaine de la boutique. Une inadéquation est une cause fréquente de connexion rompue.
3. Vérifiez que vous ne testez pas sur localhost ou sur un domaine de développement dynamique. Utilisez un domaine réel et valide.
4. Ouvrez une page produit, inspectez-la et recherchez data-seatext. Si l'attribut est manquant, le script n'a pas traité cet élément.
5. Confirmez que la description du produit est enveloppée avec la balise SeaText dans le modèle de produit. Sans la balise, le script peut se charger mais n'avoir rien à marquer.

Cette liste de contrôle fonctionne comme un arbre de décision. Si l'extrait est manquant, rajoutez-le. Si l'URL est incorrecte, corrigez le compte ou vérifiez auprès du fournisseur. Si le domaine est restreint, passez à un domaine réel. Si l'attribut est toujours manquant, vérifiez la balise du modèle de produit.

Limites de la méthode de vérification

L'attribut data- n'apparaît que sur les éléments que SeaText a traités. Si votre description de produit n'est pas enveloppée avec la balise SeaText, une page produit peut charger le script sans afficher d'attribut.

Les URL de développement telles que localhost ne fonctionneront pas. Les domaines de développement dynamiques peuvent ne pas fonctionner non plus. Utilisez un domaine réel et valide pour les tests de connexion.

Un compte SeaText ne peut pas couvrir plusieurs domaines. Chaque compte est lié à une seule URL principale. Si vous avez besoin du script sur une deuxième boutique, créez un compte distinct pour ce domaine.

Exemple concret : Vérification après une mise à jour de thème

Un propriétaire de boutique met à jour son thème Shopify. Après la mise à jour, les descriptions de produits n'affichent plus les modifications de SeaText.

Tout d'abord, le propriétaire ouvre Boutique en ligne et sélectionne Thèmes. Il choisit Modifier le code pour le thème actif. Dans Layout/theme.liquid, il recherche l'extrait SeaText. Il a disparu car le nouveau thème a remplacé le fichier.

Il colle à nouveau l'extrait et enregistre le fichier. Ensuite, il rouvre une page produit dans un nouvel onglet du navigateur. Il inspecte la page et recherche data-seatext. L'attribut apparaît maintenant sur la description du produit.

Le propriétaire vérifie également que le domaine de la boutique correspond à l'URL principale du compte. C'est le cas. La connexion est vérifiée.

Si l'attribut avait toujours été manquant, le propriétaire aurait vérifié le modèle de produit et confirmé que la description est enveloppée avec la balise SeaText. Il aurait également évité d'utiliser localhost pendant le test.

Terminologie

URL principale

Le domaine réel lié à un compte SeaText.

data-seatext

Un attribut HTML que SeaText ajoute aux éléments traités.

theme.liquid

Le fichier de mise en page global dans un thème Shopify où l'extrait SeaText doit être placé.

Faits clés

FAQ

Que prouve l'attribut data-seatext ?

Il prouve que le script SeaText s'est chargé sur la page et a traité l'élément. C'est le signal principal d'une connexion fonctionnelle.

Pourquoi localhost est-il bloqué ?

SeaText restreint les URL de développement telles que localhost pour des raisons de sécurité. Utilisez un domaine réel valide lors de la vérification de la connexion.

Puis-je utiliser un compte SeaText sur un domaine de développement et un domaine de production ?

Non. Chaque compte est lié à une seule URL principale. Créez un compte distinct pour chaque domaine.

Que dois-je faire après avoir changé de thème ?

Ouvrez le nouveau thème actif, modifiez theme.liquid et collez à nouveau l'extrait SeaText. Vérifiez ensuite une page produit pour l'attribut data-.

Que faire si l'attribut data- n'apparaît pas ?

Vérifiez l'extrait dans theme.liquid, confirmez que l'URL principale du compte correspond à la boutique, vérifiez que le domaine n'est pas localhost et confirmez que la description du produit est enveloppée avec la balise SeaText.

Un extrait enregistré garantit-il que la connexion fonctionne ?

Non. L'extrait doit être dans le thème actif, la description du produit doit être enveloppée et le domaine doit correspondre à l'URL principale.