Conditions d’inclusion et d’exclusion du code

Les conditions d’inclusion/exclusion de code vous permettent de contrôler exactement où et quand le code d’une intégration s’exécute sur votre site de base de connaissances. Au lieu d’exécuter un script sur l’ensemble de votre site, vous pouvez cibler ou exclure des adresses IP spécifiques, des espaces de travail ou des langues. Cela est utile pour filtrer le trafic interne provenant des analyses, restreindre un widget à un espace de travail spécifique, ou limiter la collecte de données à certains langages.

Vous pouvez configurer ces conditions lors de l’ajout ou de l’édition de toute intégration dans Document360.

Types d’affection

Vous pouvez fixer des conditions selon trois critères :

Adresse IP : autoriser ou restreindre le script pour des adresses IP ou plages IP spécifiques.
Espace de travail : afficher ou masquer le script pour des espaces de travail spécifiques.
Langage : afficher ou masquer le script pour certaines langues.

Lorsque vous ajoutez plus d’une condition, vous pouvez appliquer la logique pour contrôler comment elles se combinent :

ET : toutes les conditions doivent être vraies pour que le script s’exécute.
OU : une seule condition vraie suffit à faire fonctionner le script.

Integration setup panel showing Code inclusion/exclusion conditions with condition type options

Comment configurer les conditions

Condition de l’adresse IP

Utilisez des conditions d’adresse IP pour autoriser ou restreindre le script d’intégration en fonction de l’adresse IP de l’utilisateur. Cela est utile pour exclure le trafic interne de l’équipe des données analytiques.

Dans le panneau d’intégration Édition , dans le champ Sélectionner le type de condition , choisissez Adresse IP.
Dans le menu déroulant Inclure ou Exclure , sélectionnez Afficher ou Masquer selon que vous souhaitez inclure ou exclure les IP correspondantes.
Dans le champ type IP , choisissez Exact pour cibler une seule adresse IP, ou Plage pour cibler un bloc d’adresses.
Dans le champ adresse IP , saisissez l’adresse IP ou la plage.

Exemple : Pour collecter uniquement des données analytiques auprès des utilisateurs internes, choisissez Exact et saisissez l’adresse IP de votre bureau. Pour couvrir une plage d’adresses internes, choisissez Plage et définissez le début et la fin de la plage IP.

État de l’espace de travail

Utilisez les conditions de l’espace de travail pour afficher ou masquer le script d’intégration sur des espaces de travail spécifiques dans votre base de connaissances.

Dans le panneau d’intégration Édition , dans le champ Sélectionner le type de condition , choisissez Espace de travail.
Dans le menu déroulant Inclure ou Exclure , sélectionnez Afficher ou Masquer selon que vous souhaitez que le script s’exécute ou soit exclu des espaces de travail sélectionnés.
Dans le champ Select workspaces , choisissez les espaces de travail à inclure ou exclure. Vous pouvez ajouter plusieurs conditions pour différents espaces de travail selon les besoins.

Condition linguistique

Utilisez des conditions linguistiques pour afficher ou masquer le script d’intégration de langages spécifiques sur votre site de base de connaissances.

Dans le panneau d’intégration Édition , dans le champ Sélectionner le type de condition , choisissez Langage.
Dans le menu déroulant Inclure ou Exclure , sélectionnez Afficher ou Masquer selon que vous souhaitez que le script s’exécute ou soit exclu des langues sélectionnées.
Dans le champ Sélectionner les langues , choisissez les langues à inclure ou exclure. Vous pouvez ajouter plusieurs conditions pour différentes langues selon les besoins.

Code inclusion and exclusion conditions panel showing workspace and language condition configuration

Meilleures pratiques

Excluez les adresses IP internes des intégrations analytiques. Si votre équipe visite régulièrement la base de connaissances, ajoutez une condition d’exclusion IP pour empêcher le trafic interne de fausser vos données analytiques.
Utilisez des conditions d’espace de travail lorsque vous disposez de bases de connaissances spécifiques à un produit. Si différents espaces de travail servent des publics différents, vous pouvez limiter un widget de chat ou un script de suivi uniquement aux espaces de travail où c’est pertinent.
Utilisez les conditions linguistiques pour les outils spécifiques à chaque région. Si vous utilisez un outil qui n’est licencié ou pertinent que pour certaines régions, utilisez une condition linguistique pour limiter son exécution.
Utilisez la logique AND quand vous devez restreindre précisément le champ de contrôle. Par exemple, pour ne suivre que les utilisateurs internes sur un espace de travail spécifique, combinez une condition IP et une condition d’espace de travail avec la logique AND.
Utilisez la logique du bloc opératoire lorsque vous voulez une couverture plus large. Si un script doit s’exécuter pour les utilisateurs depuis l’un des deux espaces de travail, combinez-les avec la logique OR afin qu’il s’exécute lorsque l’une ou l’autre condition est remplie.

FAQ

Puis-je ajouter des conditions d’inclusion/exclusion de code à une intégration ?

Oui. Les conditions d’inclusion/exclusion de code sont disponibles pour toutes les intégrations dans Document360, y compris les intégrations natives et les entrées HTML personnalisées. Vous pouvez les configurer lors de l’ajout d’une nouvelle intégration ou lors de l’édition d’une existante.

Quelle est la différence entre la logique AND et la logique OR ?

La logique AND signifie que toutes les conditions doivent être vraies en même temps pour que le script s’exécute. La logique OR signifie que le script s’exécute si l’une des conditions est vraie. Utilisez AND pour réduire précisément le champ d’application, et OR pour l’élargir.

Puis-je ajouter plusieurs conditions du même type ?

Oui. Vous pouvez ajouter plusieurs conditions d’espace de travail, plusieurs conditions linguistiques ou plusieurs conditions IP à la même intégration. Chaque condition peut être configurée indépendamment.

Désactiver une intégration désactivera-t-il aussi ses conditions ?

Oui. Si vous désactivez une intégration, le script cesse complètement de fonctionner quelles que soient les conditions configurées. Les conditions sont préservées et reprennent effet lorsque l’intégration est réactivée.

Des conditions s’appliquent-elles aussi aux extraits HTML personnalisés ?

Oui. Les conditions d’inclusion/exclusion de code fonctionnent de la même manière pour les extraits HTML personnalisés que pour les intégrations natives. Vous pouvez modifier n’importe quelle entrée HTML personnalisée et agrandir la section des conditions pour ajouter des règles d’IP, d’espace de travail ou de langue.