Segment

Segment est un outil d’analyse puissant qui aide les équipes produit et marketing à comprendre le comportement des utilisateurs. Cela permet aux entreprises de collecter, transformer, envoyer et stocker leurs données clients de première main plus efficacement. Segment simplifie la gestion des données et facilite la connexion des données clients avec d’autres outils de votre pile, ce qui vous permet de passer moins de temps à la configuration et plus de temps à analyser des données pertinentes.

Intégrer Segment à Document360 vous permet d’envoyer les données des visiteurs de la base de connaissances à Segment et de les acheminer vers n’importe quelle destination analytique ou marketing de votre stack.

Avant que tu commences

• Vous avez besoin d’un compte Segment.
• Vous avez besoin de votre clé d’écriture de segment. Dans Document360, cela est appelé l’ID de segment. Découvrez ci-dessous comment trouver votre clé d’écriture de segment .

Comment trouver votre clé d’écriture de segment

Pour intégrer Segment avec Document360, vous devez créer une source dans Segment et copier sa clé d’écriture.

1. Connectez-vous à votre compte Segment.
2. Naviguez dans Connexions > Sources, puis cliquez sur Ajouter la source.
3. Choisissez Javascript comme type source. Vous pouvez le chercher en utilisant la barre de recherche en haut à droite.
4. Sur la page source Javascript, cliquez sur Ajouter la source.
5. Sur la page de configuration de la source , saisissez un nom pour votre source. Vous pouvez éventuellement ajouter une étiquette (comme dev ou prod) et une URL de site web. Ces champs sont optionnels et utilisés uniquement pour l’identification.

6. Après avoir créé la source, trouvez votre clé d’écriture dans l’un de ces emplacements :

   • Onglet Aperçu : Dans le bloc de code d’intégration, cherchez la ligne analytics.load("YOUR_WRITE_KEY"). La valeur entre guillemets est votre Clé d’Écriture.
   
   • onglet Paramètres : Dans les clés API, copiez la clé d’écriture indiquée là-bas.
   

7. Utilisez cette clé d’écriture dans Document360 lors de la configuration de l’intégration de segments (dans le champ ID de segment ).

Comment intégrer Segment avec Document360

1. Dans le portail Document360, naviguez vers Connexions () > Intégrations () dans la barre de navigation de gauche.

2. Sélectionnez Segment dans la liste des intégrations et cliquez sur Ajouter.

3. Dans le panneau Ajouter une nouvelle intégration , choisissez un type de configuration :

   Configuration de base : utilisez cela pour connecter rapidement Segment à votre base de connaissances.

   • Description (optionnelle) : ajouter une étiquette pour identifier l’intégration.
   • ID de segment : collez ici votre clé d’écriture de segment.

   Configuration personnalisée : utilisez cela pour ajouter du code JavaScript personnalisé pour le suivi avancé.

   • Description (optionnelle) : ajouter une étiquette pour identifier l’intégration.
   • Code : collez l’extrait complet de segment avec votre touche d’écriture. Vous pouvez également inclure des événements personnalisés en utilisant analytics.track() ou analytics.page().

4. En option, développez les conditions d’inclusion/exclusion de Code pour contrôler où l’intégration Segment s’applique en fonction de l’adresse IP, de l’espace de travail ou du langage.

5. Cliquez sur Ajouter pour compléter l’intégration.

Vérifier l’intégration

Une fois l’intégration terminée, suivez ces étapes pour confirmer que Segment reçoit les données de votre base de connaissances Document360.

1. Ouvrez votre site de base de connaissances Document360 dans un nouvel onglet. Cela déclenche un page événement que Segment devrait capturer.
2. Dans un onglet séparé, allez dans votre espace de travail Segment.
3. Naviguez dans Connexions > Sources et sélectionnez la source que vous avez créée pour Document360.
4. Allez dans l’onglet Déboguage .
5. Vous devriez voir un page événement apparaître dans le déboguage. Si vous avez configuré des événements personnalisés comme des clics de boutons, effectuez ces actions dès maintenant et vérifiez que les événements correspondants apparaissent.

Si aucun événement n’apparaît dans le Débogueur, vérifiez ce qui suit :

• La clé d’écriture est incorrecte : vérifiez que vous avez collé la bonne valeur dans le champ ID de segment.
• Erreur JavaScript sur la page : ouvrez la console du navigateur et vérifiez s’il y a des erreurs qui pourraient bloquer l’exécution du script.
• Extension de navigateur bloquant les scripts de suivi : essayez de désactiver des extensions de confidentialité comme uBlock Origin ou Ghostery et rechargez la page.
• Conditions d’inclusion/exclusion de code empêchant le script d’exécuter : examinez toute adresse IP, espace de travail ou filtre de langue appliqué dans les paramètres d’intégration.

Meilleures pratiques

• Utilisez la configuration Basic pour le suivi standard de la page view. Entrer votre clé d’écriture en configuration Basic est le moyen le plus rapide de commencer à envoyer des données à Segment. Utilisez la configuration personnalisée uniquement lorsque vous devez ajouter un suivi d’événements spécifique au-delà des vues de page.
• Nomme clairement la source de ton segment. Utilisez un nom descriptif comme « Document360 Production » afin qu’il soit facile d’identifier dans votre espace de travail Segment lorsque plusieurs sources sont connectées.
• Utilisez le Débogueur de Segments pour vérifier les événements après toute modification. Chaque fois que vous mettez à jour les paramètres d’intégration ou ajoutez de nouveaux événements personnalisés, vérifiez l’onglet Débogueur pour vérifier que les événements circulent correctement.
• Acheminez les données des segments vers vos destinations d’analyse et de marketing. Une fois que Segment reçoit des données de Document360, connectez-les à des outils en aval tels qu’Amplitude, Mixpanel ou votre CRM pour analyser la performance de votre base de connaissances en parallèle avec les autres données produit.
• Utilisez les conditions d’inclusion/exclusion du Code pour exclure le trafic interne. Ajoutez votre adresse IP de bureau comme exclusion pour éviter que les visites d’équipe ne faussent vos données analytiques.

FAQ