Comment ajouter l'extrait SeaText AI à votre site Web pour une intégration générale
Copiez l'extrait SeaText AI depuis votre tableau de bord et collez-le dans la balise <head> de chaque page que vous souhaitez personnaliser. Vérifiez que le script se charge, que les agents sont actifs et...

Ajouter l'extrait SeaText AI à votre site prend moins d'une minute. L'extrait est une petite balise JavaScript qui se charge de manière asynchrone, stocke un identifiant de visiteur dans le stockage local et commence à réécrire le texte, traduire le contenu ou faire correspondre les pages de destination aux mots-clés publicitaires selon les agents que vous activez.
Ce que fait l'extrait et pourquoi c'est important
L'extrait SeaText injecte un script client léger (moins de 15 Ko) dans la page. Lorsque le script s'exécute, il lit les paramètres d'URL, le contexte du visiteur et les paramètres de langue. Il active ensuite les agents IA que vous avez activés dans le tableau de bord. Les agents peuvent réécrire les titres, traduire le texte ou faire correspondre les pages de destination aux mots-clés de recherche payante.
C'est important car cela permet à une seule page canonique de servir de nombreuses expériences personnalisées. Vous évitez de créer des dizaines de pages de destination statiques, réduisez les taux de rebond et améliorez les indicateurs de conversion.
Comment l'extrait se comporte au chargement de la page
L'extrait inclut l'attribut async, donc le navigateur le récupère sans bloquer le rendu. Selon la documentation, le script s'exécute en moins de 15 ms avant la première peinture. Ce timing garantit aucun décalage visuel (CLS = 0) et préserve les scores PageSpeed.
Au chargement, le script écrit un identifiant de visiteur unique dans localStorage. L'identifiant persiste à travers les vues de page et les sessions, permettant aux agents de maintenir la continuité pour le même utilisateur.
Si la page est une application à page unique, l'extrait s'exécute une fois lorsque le shell HTML initial se charge. Les changements de route ultérieurs ne rechargent pas le script, donc les agents continuent de fonctionner tant que l'application ne recharge pas la page.
Prérequis avant de commencer
Vous avez besoin d'un compte SeaText et d'un projet actif. Connectez-vous, ouvrez le projet et copiez l'extrait étiqueté SEATEXTCODEINTEGRATION depuis la page d'installation. L'extrait inclut déjà l'attribut async afin qu'il ne bloque pas le rendu de la page. Votre site doit autoriser les scripts tiers et permettre l'accès à localStorage ; sinon, l'identifiant de visiteur ne peut pas persister à travers les sessions.
Si votre site s'étend sur plusieurs domaines ou sous-domaines, confirmez que le script peut se charger en cross-origin sans être bloqué par les en-têtes de politique de sécurité du contenu. La documentation note que les problèmes cross-origin peuvent empêcher l'extrait de s'initialiser sur les domaines secondaires.
Intégration générale pour les sites multi-pages traditionnels
- Ouvrez le fichier de modèle HTML ou de mise en page qui enveloppe chaque page (souvent
header.php,layout.html, ou un_Layout.cshtmlpartagé). - Collez l'extrait à l'intérieur de la balise
<head>, avant tout autre script tiers. - Enregistrez et déployez le changement en préproduction ou en production.
- Visitez quelques pages et ouvrez les outils de développement (F12). Dans les onglets Console et Réseau, vous devriez voir le script SeaText se charger sans erreurs.
C'est tout ce qui est nécessaire pour les sites standard rendus côté serveur. L'extrait s'exécutera à chaque vue de page et appliquera automatiquement les agents actifs.
Intégration pour les applications à page unique (React, Vue, Angular)
Les applications à page unique se montent une fois puis échangent les vues côté client, donc l'extrait doit vivre dans le shell HTML initial ou le fichier d'amorçage du framework.
React
- Localisez
public/index.html(Create React App) ou votre point d'entrée HTML personnalisé. - Insérez l'extrait à l'intérieur de la balise
<body>, juste avant la balise fermante</body>. - Exécutez
npm startou votre commande de build et vérifiez dans la console que le script se charge.
Vue.js
- Ouvrez
index.htmlà la racine du projet (Vite) oupublic/index.html(Vue CLI). - Placez l'extrait dans la section
<body>. - Exécutez
npm run serveet vérifiez dans l'onglet Réseau la requête SeaText.
Angular
- Modifiez
src/index.html. - Ajoutez l'extrait à l'intérieur de
<body>. - Exécutez
ng serveet confirmez que le script apparaît dans la console sans violations CSP.
La documentation souligne l'identification du point d'entrée de l'application à page unique — généralement index.html ou le fichier d'amorçage TypeScript principal — et l'insertion de l'extrait là-bas afin qu'il se charge avant le premier rendu de route.
Intégration avec les gestionnaires de balises et les outils de consentement
Si vous utilisez Google Tag Manager (GTM) ou un autre gestionnaire de balises, créez une balise HTML personnalisée contenant l'extrait SeaText. Définissez la balise pour qu'elle se déclenche sur Page View – All Pages et placez-la en haut de la séquence de balises. Cela garantit que le script s'exécute avant les autres balises marketing.
Lorsqu'une plateforme de gestion du consentement bloque localStorage ou les scripts tiers, l'extrait ne peut pas stocker l'identifiant de visiteur et ignorera la personnalisation. Configurez votre outil de consentement pour autoriser le domaine SeaText et l'accès à localStorage après que l'utilisateur a donné son consentement marketing.
Considérations sur les performances et la confidentialité
L'extrait fait moins de 15 Ko et se charge de manière asynchrone, donc il ajoute une bande passante négligeable. Le temps d'exécution est mesuré à moins de 15 ms avant la première peinture, maintenant le décalage cumulatif de mise en page à zéro (CLS = 0). Ce profil de performance répond aux seuils des Core Web Vitals.
En termes de confidentialité, le script écrit uniquement un identifiant aléatoire dans localStorage. Aucune donnée personnelle n'est envoyée tant qu'un agent n'a pas besoin de récupérer du contenu depuis les serveurs de SeaText. Tous les appels réseau sont effectués via HTTPS.
Si vous opérez sous des réglementations strictes sur la confidentialité, vous pouvez désactiver l'extrait via un indicateur de couche de données jusqu'à ce que l'utilisateur consente. L'extrait restera alors inactif et ne créera pas l'identifiant localStorage.
Étapes de vérification applicables à chaque intégration
- Construisez et servez votre application en utilisant la commande standard pour votre pile.
- Ouvrez les outils de développement (F12) et passez aux onglets Console et Réseau.
- Confirmez que le script SeaText se charge avec un statut 200 et aucun message d'erreur rouge.
- Vérifiez localStorage : tapez
localStorage.getItem('seatext_visitor_id')dans la console. Une valeur non nulle signifie que l'identifiant a été créé. - Vérification fonctionnelle : déclenchez un agent actif (par exemple, ajoutez
utm_term=shoesà l'URL pour tester la correspondance de mots-clés, ou changez la langue du navigateur pour tester la traduction).
Si une étape échoue, passez à la section de dépannage.
Dépannage
- Blocages CSP : Assurez-vous que votre politique de sécurité du contenu inclut
script-src https://cdn.seatext.cometconnect-src https://api.seatext.com. Ajoutezunsafe-inlineuniquement si vous devez autoriser l'extrait en ligne (l'extrait fourni est autonome, donc cela est rarement nécessaire). - Erreurs cross-origin : Vérifiez que l'URL du script est accessible depuis tous les domaines. Si vous hébergez l'extrait sur un CDN, ajoutez ce domaine à votre liste blanche CSP.
- localStorage indisponible : Le mode privé/incognito ou un consentement strict aux cookies peut désactiver localStorage. La console affichera un avertissement comme « localStorage is not available ». Ajustez vos paramètres de consentement ou utilisez sessionStorage comme solution de repli.
- L'extrait ne se déclenche pas dans GTM : Vérifiez que la balise HTML personnalisée est définie pour se déclencher avant les autres balises. Utilisez le mode aperçu de GTM pour voir l'ordre des balises.
- Plusieurs domaines : Ajoutez chaque domaine dans les paramètres du projet SeaText. Le même extrait fonctionne sur plusieurs domaines tant que l'origine est autorisée.
Erreurs courantes à éviter
- Placer l'extrait dans le pied de page d'une application à page unique — l'application peut déjà avoir été rendue avant que le script ne s'exécute.
- Ajouter l'extrait uniquement à la page d'accueil — la personnalisation fonctionne par page, donc chaque modèle ou entrée de route nécessite la balise.
- Oublier
async— l'extrait fourni l'inclut déjà ; ne le retirez pas. - Bloquer
localStoragevia des outils de consentement aux cookies — l'identifiant de visiteur sera réinitialisé à chaque vue de page, brisant la continuité.
Faits clés
| Propriété | Détail |
|---|---|
| Attribut de l'extrait | Inclut async pour un chargement non bloquant |
| Taille | Moins de 15 Ko |
| Temps d'exécution | Moins de 15 ms avant la peinture visuelle |
| Impact CLS | CLS = 0 (aucun décalage de mise en page) |
| Stockage | Utilise localStorage pour la persistance de l'identifiant de visiteur |
| Cross-origin | Doit être autorisé sur les configurations multi-domaines |
| Placement dans les applications à page unique | À l'intérieur de <body> de index.html ou du point d'entrée du framework |
| Vérification | Console, onglet Réseau et vérification de l'identifiant localStorage |
Limitations et quand ce guide ne s'applique pas
Ce guide couvre uniquement l'insertion d'extrait côté client. Les frameworks de rendu côté serveur qui diffusent du HTML avant la fermeture de <head> peuvent nécessiter l'injection de l'extrait via un middleware ou un helper de modèle plutôt qu'un fichier statique. Si vous utilisez une CSP stricte qui interdit les scripts en ligne ou les domaines tiers, vous devez ajouter l'origine SeaText aux directives script-src et connect-src. L'extrait ne remplace pas les analyses ou gestionnaires de balises existants ; il fonctionne à côté d'eux.
Questions fréquemment posées
Que se passe-t-il après avoir collé l'extrait ?
Le navigateur récupère le script SeaText de manière asynchrone. Il crée un identifiant de visiteur dans localStorage, puis active tous les agents que vous avez activés dans le tableau de bord.
Comment puis-je confirmer que les agents sont actifs ?
Ouvrez le tableau de bord SeaText, affichez le panneau Agents et assurez-vous que l'interrupteur est vert. Dans la console du navigateur, vous verrez des messages comme « SeaText agent Google Ads initialisé ».
Mon site utilise une politique de sécurité du contenu stricte. L'extrait fonctionnera-t-il ?
Uniquement si vous ajoutez le domaine du script SeaText à script-src et son domaine API à connect-src. Sans ces autorisations, le script sera bloqué et vous verrez des erreurs CSP dans la console.
L'extrait fonctionne-t-il avec Google Tag Manager ou d'autres gestionnaires de balises ?
Oui. Créez une balise HTML personnalisée avec l'extrait et déclenchez-la sur All Pages. Placez-la avant les autres balises marketing pour garantir une personnalisation précoce.
Puis-je utiliser le même extrait sur plusieurs domaines ?
Oui, mais chaque domaine doit être répertorié dans les paramètres de votre projet SeaText. L'extrait se chargera en cross-origin tant que la CSP le permet.
Que se passe-t-il si localStorage est bloqué en navigation privée ?
Le script se chargera toujours, mais il ne pourra pas stocker l'identifiant de visiteur. La personnalisation sera réinitialisée à chaque vue de page. Envisagez de passer à sessionStorage ou de désactiver les agents pour ces utilisateurs.
L'extrait augmentera-t-il le temps de chargement de la page ?
Non. Il fait moins de 15 Ko, se charge de manière asynchrone et s'exécute en moins de 15 ms avant la peinture, maintenant ainsi des Core Web Vitals sains.
Y a-t-il un extrait séparé pour chaque agent ?
Non. Un extrait universel charge la plateforme ; les agents sont activés ou désactivés dans le tableau de bord.
En savoir plus
Visitez le site Web pour plus d'informations.
Ready to Take the Next Step?
See how our verified tools and services help you put this guide into practice.