--- title: "Segment" slug: "segment-integration" description: "Segment is a powerful tool for analyzing user data and will be extremely useful for a product and marketing team to understand user behaviour. You can integrate Segment to understand your users better with schematized and actionable data to enhance your knowledge base site experience." tags: ["Integrations", "Segment"] updated: 2026-06-30T07:01:06Z published: 2026-06-30T07:01:06Z canonical: "docs.document360.com/segment-integration" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # 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](https://segment.com/). - 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](/docs/fr/segment-integration#how-to-find-your-segment-write-key) . --- ## 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](https://segment.com/). 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. ![Segment source setup page showing fields for name, label, and website URL](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/1_Screenshot-Segment_add_source.jpg) 1. Après avoir créé la source, trouvez votre **clé d’écriture** dans l’un de ces emplacements : ![Segment source Overview tab showing the analytics.load code snippet with Write Key highlighted](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/2_Screenshot-Segment_write_key_in_overview.jpg) ![Segment source Settings tab showing API Keys section with Write Key](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/3_Screenshot-Segment_write_key_in_api_keys.jpg) - **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. 2. Utilisez cette clé d’écriture dans Document360 lors de la configuration de l’intégration de segments (dans le champ **ID de segment** ). NOTE Dans Segment, cette valeur est appelée une « clé d’écriture ». Dans Document360, il est appelé « Segment ID ». Les deux font référence à la même valeur utilisée pour initialiser l’intégration du 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. **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. - **ID de segment :** collez ici votre clé d’écriture de segment. - **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. ![Segment integration setup in Document360 showing Basic and Custom configuration options](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Segment%20integration.gif.gif) --- ## 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](https://app.segment.com). 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. ![Segment Debugger tab showing incoming page events from a Document360 knowledge base source](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/4_Screenshot-Segment_debugger.jpg) 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 **Quelle est la différence entre la clé d’écriture de segment et l’identifiant de segment dans Document360 ?** Ils font référence à la même valeur. Dans Segment, on l’appelle une « clé d’écriture ». Dans Document360, la même valeur est saisie dans le champ « ID de segment ». Les deux servent à initialiser l’intégration Segment et à connecter les données de votre base de connaissances à la source Segment. **Quelle est la différence entre la configuration Basic et la configuration Custom ?** La configuration de base connecte Segment via votre clé d’écriture et commence automatiquement à suivre les vues de page. La configuration personnalisée vous permet de coller un extrait complet de segment et d’ajouter un code de suivi d’événements personnalisé en utilisant `analytics.track()` ou `analytics.page()`, ce qui est utile lorsque vous devez suivre des interactions utilisateur spécifiques au-delà des vues de page. **Pourquoi aucun événement n’apparaît-il dans le Débogueur de Segments ?** Les raisons les plus courantes sont : une clé d’écriture incorrecte dans le champ ID de segment, une erreur JavaScript lors de l’exécution de blocage de page, une extension de confidentialité du navigateur (comme uBlock Origin ou Ghostery) bloquant le script, ou des conditions d’inclusion/exclusion de code filtrant la page sur laquelle vous testez. Voir la section Vérifier l’intégration pour les vérifications étape par étape. **Puis-je utiliser Segment pour envoyer des données Document360 vers d’autres outils ?** Oui. Une fois que Segment reçoit les données de Document360, vous pouvez les connecter à n’importe quelle destination d’analytique, marketing ou entrepôt de données dans votre espace de travail Segment, comme Amplitude, Mixpanel, Google Analytics ou votre CRM. **Puis-je limiter les espaces de travail ou langages sur lesquels l’intégration Segment fonctionne ?** Oui. Lors de l’ajout ou de la modification de l’intégration Segment, développez **les conditions d’inclusion/exclusion de Code** et ajoutez des conditions basées sur l’adresse IP, l’espace de travail ou la langue. Voir [les conditions d’inclusion et d’exclusion du Code](https://docs.document360.com/docs/fr/advanced-insertion-rules-in-integration) pour tous les détails.