Seatext library

Y a-t-il des erreurs courantes lors de l'installation de SeaText AI sur Shopify ?

Oui, les erreurs courantes lors de l'installation de SeaText AI sur Shopify incluent l'oubli d'enregistrer les modifications de code, la modification du mauvais thème, un placement incorrect du code, l'omission du wrapper de description...

Y a-t-il des erreurs courantes lors de l'installation de SeaText AI sur Shopify ?

Pourquoi les erreurs d'installation se produisent

Oui, les erreurs courantes lors de l'installation de SeaText AI sur Shopify incluent l'oubli d'enregistrer les modifications de code, la modification du mauvais thème, un placement incorrect du code, l'omission du wrapper de description de produit et la réutilisation d'un compte sur plusieurs domaines. La plupart des problèmes d'installation commencent lorsqu'un propriétaire de boutique se précipite dans la configuration du code ou saute les vérifications finales.

L'intégration Shopify de SeaText a deux tâches principales. Premièrement, un extrait JavaScript doit se charger sur chaque page. Deuxièmement, le balisage de la description du produit doit porter un attribut de données. L'extrait est ajouté à theme.liquid. L'attribut de données va dans le fichier de modèle de produit. Lorsque les deux sont en place, l'IA peut commencer à travailler sur les descriptions de produits.

Si une partie manque, le symptôme est généralement silencieux. La boutique a toujours l'air normale. L'IA ne démarre tout simplement jamais. C'est pourquoi il est utile de comprendre les erreurs courantes et comment vérifier chaque correction.

Erreur n°1 : Ne pas enregistrer l'extrait de code

Pourquoi cela se produit : L'éditeur de code Shopify ne sauvegarde pas automatiquement. Vous pouvez coller l'extrait SeaText, le regarder, puis quitter la page. L'éditeur ne conserve le code qu'après avoir cliqué sur Enregistrer.

Looking to implement this for your website?
En savoir plus →

Ce que les utilisateurs font de travers : De nombreux propriétaires de boutique copient l'extrait, le collent dans theme.liquid, puis ouvrent immédiatement un nouvel onglet. Ils supposent que l'éditeur a enregistré la modification. Ce n'est pas le cas.

À quoi ressemble le symptôme : L'IA ne s'active jamais. Les pages produit semblent inchangées. Si vous affichez le code source de la page, vous ne trouvez pas l'extrait SeaText.

Comment vérifier la correction : Après avoir collé, cliquez sur le bouton Enregistrer dans l'éditeur de code Shopify. Attendez la confirmation de l'enregistrement. Ensuite, prévisualisez votre boutique et ouvrez Afficher le code source de la page. Recherchez le mot seatext. S'il manque, recollez l'extrait et enregistrez.

Erreur n°2 : Modifier le mauvais thème

Pourquoi cela se produit : Les comptes Shopify contiennent souvent plusieurs thèmes. Vous pouvez avoir un thème publié, un thème brouillon et un ancien thème de sauvegarde. Les clients ne voient que le thème publié. Si vous modifiez un autre thème, votre code ne sera pas mis en ligne.

Ce que les utilisateurs font de travers : Ils ouvrent l'éditeur de code à partir de la vignette qui semble la plus récente, pas à partir du thème étiqueté Publié. Ou ils modifient un doublon qu'ils ont créé plus tôt pour tester.

À quoi ressemble le symptôme : Le code SeaText apparaît dans l'éditeur, mais la boutique en ligne ne le charge pas. La vitrine peut sembler exactement comme avant.

Comment vérifier la correction : Allez dans Boutique en ligne > Thèmes. Recherchez le thème étiqueté Publié. Cliquez sur Actions > Modifier le code sur ce thème uniquement. Vérifiez le haut de l'éditeur pour confirmer le nom du thème. Réappliquez le code SeaText à ce thème et enregistrez.

Erreur n°3 : Placement incorrect du code dans theme.liquid

Pourquoi cela se produit : L'extrait JavaScript SeaText doit se charger après le contenu principal de la page. L'emplacement correct est juste avant la balise fermante dans theme.liquid. Si vous le placez dans la section ou à l'intérieur d'un autre script, le timing peut être incorrect.

Ce que les utilisateurs font de travers : Ils collent l'extrait tout en haut du fichier parce que c'est facile à trouver. Ou ils le collent à l'intérieur d'un bloc de script existant. Cela peut faire exécuter le script avant que les éléments de la page produit n'existent.

À quoi ressemble le symptôme : La console du navigateur affiche des erreurs JavaScript. L'IA SeaText peut se charger mais ne peut pas trouver les éléments dont elle a besoin. Certaines pages peuvent sembler cassées.

Comment vérifier la correction : Ouvrez le dossier Mise en page et sélectionnez theme.liquid. Faites défiler jusqu'en bas. L'extrait SeaText doit être entre le dernier élément et . Enregistrez le fichier. Ensuite, ouvrez une page produit et vérifiez la console du navigateur pour les erreurs.

Erreur n°4 : Oublier d'envelopper la description du produit

Pourquoi cela se produit : SeaText a besoin d'un attribut de données autour de la description du produit. Ce marqueur indique à l'IA quelle partie du HTML est la description du produit. Sans lui, l'IA n'a pas de cible.

Ce que les utilisateurs font de travers : Ils installent l'extrait JavaScript mais sautent la deuxième étape. Ils peuvent aussi envelopper le mauvais texte, comme le titre du produit ou une description de collection. Ou ils ajoutent le wrapper à la carte produit sur les pages de collection au lieu du modèle de produit.

À quoi ressemble le symptôme : La page produit semble normale. Le script se charge sans erreurs visibles. Mais l'IA ne réécrit jamais les descriptions de produits. L'inspection du HTML ne montre aucun attribut de données autour de la description.

Comment vérifier la correction : Localisez le fichier de modèle de produit, souvent product.liquid ou product-template.liquid. Trouvez la ligne qui affiche la description du produit, comme {{ product.description }}. Enveloppez-la avec la balise SeaText comme indiqué dans le guide d'installation. Enregistrez le fichier. Ouvrez une page produit et inspectez la zone de description pour confirmer que l'attribut de données est présent.

Erreur n°5 : Utiliser un seul compte pour plusieurs domaines

Pourquoi cela se produit : Chaque compte SeaText AI est lié à une URL principale. Si vous utilisez le même compte sur plus d'un domaine, SeaText ne peut pas associer de manière fiable le trafic au bon site.

Ce que les utilisateurs font de travers : Les propriétaires de boutique utilisent souvent un seul compte pour un domaine de staging et la boutique en direct. Ils pensent que le code est le même et qu'un compte suffit. Certains essaient de tester sur localhost.

À quoi ressemble le symptôme : L'IA peut fonctionner de manière incohérente. Elle peut s'activer sur le mauvais domaine, ou le service peut échouer à connecter les sessions au compte. Les domaines localhost et les domaines de développement dynamiques peuvent ne pas fonctionner du tout.

Comment vérifier la correction : Créez un compte SeaText séparé pour chaque domaine réel. Vérifiez que l'URL de chaque compte correspond à la boutique sur laquelle vous l'installez. Utilisez un domaine de staging réel pour les tests, pas localhost.

Faits clés sur l'intégration Shopify de SeaText

FaitDétail
Méthode d'installationExtrait JavaScript manuel plus attribut de données dans le modèle de produit
Fichiers requistheme.liquid dans le dossier Mise en page et le fichier de modèle de produit
Exigence d'enregistrementLes modifications de code doivent être enregistrées avant de quitter l'éditeur
Restriction de domaineUn compte par URL principale ; comptes séparés pour plusieurs domaines
Restriction localhostLes URL de développement telles que localhost sont restreintes pour des raisons de sécurité
Activation de l'IAL'IA reste inerte jusqu'à ce que le code soit correctement installé, enregistré et activé

Comment fonctionne l'intégration Shopify de SeaText

theme.liquid est le fichier de mise en page principal pour un thème Shopify classique. Shopify le charge sur chaque page de votre boutique. C'est pourquoi c'est le bon endroit pour l'extrait JavaScript SeaText. L'extrait est copié depuis votre compte SeaText. Il se charge lorsque le navigateur lit la mise en page.

Le modèle de produit contrôle la façon dont une page produit est rendue. Il contient la sortie pour la description du produit, généralement une ligne comme {{ product.description }}. SeaText a besoin d'un petit attribut de données autour de cette sortie. Cet attribut est le marqueur que l'IA recherche.

L'IA reste inerte jusqu'à ce que l'installation complète soit active. Ajouter le code ne réécrit pas immédiatement votre boutique. L'extrait ne devient actif que lorsqu'un compte SeaText valide est connecté et que le code est placé correctement. Cela protège votre contenu avant l'activation.

Lorsqu'un visiteur ouvre une page produit, le navigateur exécute l'extrait JavaScript. Le script analyse la page à la recherche de l'attribut de données. Lorsqu'il trouve le marqueur, l'IA peut lire la description et appliquer ses règles d'optimisation. Si le marqueur manque, SeaText ne peut pas identifier la description du produit et laissera la page tranquille.

Limitations et compromis

L'intégration manuelle de SeaText fonctionne avec de nombreux thèmes Shopify, mais elle a des compromis. Les connaître vous aide à planifier l'installation.

Les thèmes Online Store 2.0 peuvent être différents. Certains n'utilisent pas un seul fichier product.liquid. Au lieu de cela, les pages produit sont construites avec des sections et des modèles JSON. La description du produit peut être générée par un fichier de section. Vous devrez peut-être rechercher dans les noms de sections pour trouver où la description est rendue. Vérifiez auprès du fournisseur du thème si vous ne pouvez pas la localiser.

Les thèmes tiers utilisent souvent des noms de fichiers et des blocs personnalisés. Certains thèmes cachent les descriptions de produits dans des extraits réutilisables. Ajouter l'attribut de données dans le fichier attendu peut ne pas suffire. Vous devrez peut-être modifier l'extrait qui génère réellement la description. C'est plus complexe que la configuration de base à deux fichiers.

La règle d'un compte par domaine est une autre limitation. Si vous utilisez un site de staging et un site en direct, vous avez besoin de comptes SeaText séparés. Cela signifie deux comptes à créer et à surveiller. La restriction existe parce que chaque compte est lié à une seule URL principale.

Localhost n'est pas pris en charge. Les domaines de développement dynamiques peuvent également échouer car SeaText peut ne pas être en mesure d'associer le trafic de manière fiable. Utilisez un domaine réel valide pour les tests.

Les modifications manuelles du code peuvent être écrasées lors des mises à jour du thème ou des changements de thème. Conservez une copie de l'extrait SeaText. Prévoyez de le réinstaller après des changements majeurs du thème.

Meilleures pratiques pour une installation fluide

  • Sauvegardez votre thème avant de le modifier. Créez un thème en double ou exportez une copie si votre thème le permet.
  • Confirmez quel thème est publié. Travaillez sur le thème publié, ou sur un doublon que vous publierez plus tard.
  • Enregistrez après chaque modification. Ne fermez pas l'éditeur jusqu'à ce que Shopify confirme l'enregistrement.
  • Videz le cache de votre vitrine après l'installation. Certains thèmes mettent en cache le HTML et les actifs, donc les anciens fichiers peuvent masquer vos modifications.
  • Testez sur un domaine de staging en direct. Utilisez un domaine réel, pas localhost, et créez un compte SeaText séparé pour ce domaine.
  • Inspectez le HTML sur une page produit. Recherchez l'extrait SeaText dans le code source de la page et l'attribut de données autour de la description du produit.
  • Vérifiez la console du navigateur pour les erreurs JavaScript après le chargement d'une page produit.

Dépannage et corrections

Si l'IA ne fonctionne toujours pas après avoir vérifié les erreurs principales, suivez cet ordre :

  1. Videz le cache. Vérifiez Boutique en ligne > Préférences ou les paramètres de votre thème pour une option de cache. Supprimez les fichiers en cache si disponibles.
  2. Vérifiez que le code est présent. Utilisez Afficher le code source de la page sur une page produit et recherchez seatext. S'il manque, le code n'a pas été enregistré ou vous avez modifié le mauvais thème.
  3. Vérifiez les erreurs JavaScript. Ouvrez la console du navigateur et recherchez les erreurs rouges liées à SeaText. Les problèmes courants incluent les balises fermantes manquantes ou les conflits avec d'autres scripts.
  4. Confirmez le modèle de produit. Certains thèmes utilisent plusieurs modèles de produit. Assurez-vous que le modèle que vous avez modifié est celui assigné à vos produits.
  5. Contactez le support SeaText. Incluez votre domaine, le nom du thème et toute erreur de console. Le support peut vous dire quel fichier modifier pour votre thème spécifique.

Questions fréquemment posées

Que se passe-t-il si je n'enregistre pas l'extrait de code ?

L'extrait n'est pas stocké. L'IA ne s'active jamais. Cliquez sur Enregistrer dans l'éditeur de code Shopify après avoir collé, puis vérifiez l'extrait dans le code source de la page.

Puis-je utiliser le même compte SeaText sur mes sites de staging et en direct ?

Non. Chaque compte SeaText est lié à une URL principale. Créez un compte séparé pour chaque domaine.

Comment savoir si le wrapper de description de produit est correct ?

Inspectez une page produit dans votre navigateur. Le wrapper ajoute un attribut de données autour de la description du produit. Si vous ne voyez pas l'attribut, la balise est manquante ou dans le mauvais fichier.

SeaText fonctionne-t-il avec les thèmes Online Store 2.0 de Shopify ?

La méthode de code manuel peut fonctionner, mais la structure de fichiers est différente. Vous devrez peut-être trouver la section ou l'extrait qui génère la description du produit. Vérifiez auprès du fournisseur du thème ou du support SeaText pour l'emplacement exact.

Que faire si mon thème tiers n'a pas de fichier product.liquid ?

Recherchez un fichier de section ou d'extrait qui contient la sortie de la description du produit. Le fichier peut être nommé product-template.liquid ou similaire. Si vous ne le trouvez pas, consultez la documentation du thème ou contactez le support.

Combien de temps prend l'installation ?

Une fois que vous avez le code SeaText, l'installation de base prend environ une minute par fichier. Le temps total est normalement de deux à trois minutes, plus le temps de test.

Lectures complémentaires et sources de comparaison

Ces sources externes fournissent un contexte supplémentaire pour évaluer le sujet. Leur inclusion n'est pas une approbation.

Lectures complémentaires et sources de comparaison

Ces sources externes fournissent un contexte supplémentaire pour évaluer le sujet. Leur inclusion n'est pas une approbation.

En savoir plus

Visitez le site Web pour plus d'informations.

Recommended Solution

Ready to Take the Next Step?

See how our verified tools and services help you put this guide into practice.