Custom Script
Un seul script, toutes les fonctionnalités. Ajoutez un snippet léger au code source de votre site et débloquez toute la puissance de Positive User : tracking visiteurs, chat en direct, identification des contacts et automatisation par événements. Aucun plugin, aucune dépendance CMS, aucun développeur nécessaire au-delà de l'accès au HTML.
Un seul snippet pour piloter toute votre plateforme
Fonctionne sur n'importe quel site
Pas de plugin CMS ? Aucun problème. Le script Positive User s'intègre à n'importe quel site : HTML statique, applications développées sur mesure, architectures headless ou plateformes sans plugin dédié. Collez le snippet juste avant la balise </body> et le tracking démarre immédiatement.
Du visiteur anonyme au contact identifié
Dès que le script se charge, Positive User attribue une clé unique à chaque visiteur et commence à suivre les pages vues, l'appareil, le navigateur et la localisation, tout cela de façon anonyme. Quand vous êtes prêt à identifier vos visiteurs, transmettez des attributs comme l'email, le nom ou le numéro de téléphone via le script. Toute l'activité pré-identification est alors rattachée au profil de contact identifié.
Transmettez toutes les données dont vous avez besoin
L'objet window.civchat accepte des attributs standard (nom, email, numéro de téléphone, statut, score) ainsi que des données société (nom d'entreprise, ID, chiffre d'affaires), le tout dans un seul bloc de code. Utilisez des valeurs statiques, des variables GTM ou du JavaScript dynamique pour alimenter l'objet. Tout ce que vous transmettez arrive instantanément sur le profil de contact.
Trois étapes simples pour démarrer
Récupérez votre script
Dans votre application Positive User, rendez-vous dans Settings > Setup & Integrations > Basic Integration. Copiez le script. Il contient déjà votre clé API et votre domaine d'application.
Ajoutez-le à votre site
Collez le script juste avant la balise </body> dans le code source de votre site. Vous pouvez aussi le déployer via Google Tag Manager avec un déclencheur configuré pour s'exécuter sur toutes les pages.
Vérifiez le tracking
Naviguez sur votre site, puis ouvrez l'espace Contacts dans Positive User. De nouveaux enregistrements de visiteurs anonymes apparaissent en quelques secondes. Pour une vérification technique, ouvrez la console de votre navigateur, tapez civchat et confirmez que l'objet est bien défini. Le tracking est en place.
Popular implementation guides
- Intégration via implémentation du script: Guide pas à pas pour la configuration basique et avancée du script, avec la transmission des attributs utilisateur et des données société. Lire le guide →
- Implémenter Positive User avec Google Tag Manager: Déployez le script Positive User via GTM plutôt que de modifier directement votre code source. Idéal pour les équipes qui gèrent leurs tags de façon centralisée. Lire le guide →
- Paramètres du widget de chat: Configurez la visibilité, l'apparence et le comportement du widget. Utile si vous déployez le script uniquement pour le tracking et souhaitez masquer ou personnaliser le widget de chat. Voir le tutoriel →
- Définir des IDs personnalisés pour utilisateurs, entreprises et opportunités: Comprenez le fonctionnement de user_id et company_id pour faire correspondre vos visiteurs aux enregistrements existants dans votre base et éviter les doublons. Voir le tutoriel →
Frequently Asked Questions
Faut-il savoir coder pour intégrer le script ?
Très peu. Vous avez besoin d'accéder au code source HTML de votre site (ou à Google Tag Manager) et vous collez un snippet pré-construit. Le script se copie directement depuis vos paramètres Positive User, sans modification à faire. Si vous savez ouvrir un fichier de site ou coller un tag dans GTM, c'est suffisant.
Quelle est la différence entre le script basique et le script avancé ?
Le script basique contient uniquement votre clé API. Il active le tracking anonyme des visiteurs, l'enregistrement des pages vues et le widget de chat. Le script avancé ajoute un objet window.civchat dans lequel vous transmettez les attributs utilisateur (email, nom, téléphone) et les données société, ce qui permet aux visiteurs d'arriver directement en tant que contacts identifiés dans Positive User.
Le script va-t-il ralentir mon site ?
Non. Le script se charge en asynchrone et reste léger. Il ne bloque pas le rendu des pages et n'altère pas les performances de votre site.
Puis-je utiliser cette intégration avec Google Tag Manager plutôt que de modifier mon code source ?
Oui. Vous pouvez déployer le script Positive User sous forme de tag HTML personnalisé dans GTM. Configurez le déclencheur pour qu'il s'exécute sur toutes les pages. C'est l'approche recommandée si votre équipe gère déjà ses tags via GTM, ou si vous n'avez pas d'accès direct au code source du site.
Comment fonctionne le tracking des visiteurs anonymes ?
Quand le script se charge, il génère une user_key unique et dépose un cookie dans le navigateur du visiteur. Chaque page vue est enregistrée et associée à cette clé. Le visiteur apparaît en tant qu'enregistrement anonyme dans Positive User jusqu'à ce qu'il s'identifie (interaction avec le chat, soumission d'un formulaire ou attributs transmis via le script avancé).
Quels formats de données sont requis pour les attributs ?
Les dates doivent respecter le format ISO 8601 (par exemple 2017-07-25T14:14:08.612Z). Les numéros de téléphone doivent utiliser le format E.164 (par exemple +44754123434). Les autres attributs acceptent des chaînes de caractères, des nombres ou des booléens selon le type de champ défini dans votre application Positive User.
Puis-je transmettre des données société en plus des données utilisateur ?
Oui. L'objet window.civchat accepte un objet company imbriqué avec des attributs comme name, company_id et revenue. Cela crée ou met à jour à la fois le profil de contact et la fiche société associée dans Positive User en un seul appel, en maintenant automatiquement le lien entre les deux.
Que faire si je ne veux pas que le widget de chat apparaisse ?
Vous pouvez toujours utiliser le script uniquement pour le tracking et la collecte de données. Rendez-vous dans Settings > Chat Widget Settings > Widget Visibility et passez l'état du widget sur « Hidden ». Le script continue de tourner silencieusement en arrière-plan.
Comment vérifier que le script fonctionne ?
Deux méthodes. D'abord, vérifiez l'espace Contacts dans votre application Positive User : de nouveaux enregistrements anonymes apparaissent après chaque visite de votre site. Ensuite, ouvrez la console développeur de votre navigateur sur votre site et tapez civchat. Si l'objet est défini, le script est chargé et le tracking est actif.
Puis-je suivre des événements personnalisés avec ce script ?
Le script lui-même gère l'identification des visiteurs et la transmission d'attributs. Pour envoyer des événements personnalisés (achats, soumissions de formulaires, clics sur des boutons), il faut ajouter séparément des appels de tracking d'événements, soit via l'API JavaScript Positive User, soit via des déclencheurs Google Tag Manager. Notre équipe peut vous aider à cadrer la bonne approche selon votre cas d'usage.