Cartographie d’URL

La correspondance d’URL vous permet de configurer ce que le widget de la base de connaissances affiche page par page. Pour chaque URL de votre site web ou application, vous pouvez afficher un article spécifique, une liste de catégories, une barre de recherche avec un espace réservé personnalisé, ou masquer complètement le widget. Cela rend le widget contextuel — les utilisateurs voient le contenu d’aide le plus pertinent en fonction de leur position dans votre produit.

Quand utiliser le mappage d’URL

• Affichez un article spécifique directement dans le widget sur une page où les utilisateurs en ont fréquemment besoin.
• Affichez une liste soigneusement sélectionnée d’articles d’une catégorie lorsqu’un utilisateur est dans un module produit spécifique.
• Masquez le widget sur les pages où il ne devrait pas apparaître (par exemple, pages de connexion, flux de paiement).
• Affichez un espace réservé de recherche personnalisé pour guider les utilisateurs sur ce qu’il faut rechercher dans un contexte donné.
• Utilisez une assistance contextuelle alimentée par l’IA (invite au niveau de la page) pour des URL spécifiques.

Avant que tu commences

Le contenu que vous souhaitez mapper (articles ou catégories) doit rejoindre le champ d’accès au contenu configuré par le widget.

Actions

Il y a cinq actions que vous pouvez exécuter avec le mappage d’URL :

Paramètres URL

Lors de la configuration de l’URL du widget, vous pouvez inclure trois types de paramètres :

• Inclure le chemin : /thisis/a/path
• Inclure la requête : ?animal=bear
• Inclure le hachage : #inbox

Vous pouvez aussi activer le bouton Is Regex pour intégrer des expressions régulières dans vos configurations d’URL.

Comment ajouter un mappage d’URL

1. Dans la barre de navigation de gauche, naviguez vers Connexions () > widget de la base de connaissances.

2. Survolez le widget souhaité et cliquez sur Modifier ().

3. Cliquez sur l’onglet de correspondance d’URL .

4. Cliquez sur nouvelle correspondance d’URL et spécifiez ce qui suit :

   • Nom — Le nom de correspondance URL n’est affiché que sur l’enregistrement de correspondance URL dans Document360.

   • Structure de l’URL — Sélectionnez le type de paramètre URL souhaité (Inclure chemin / Inclure requête / Inclure le hachage). Vous devez activer au moins un paramètre d’URL. Saisissez l’URL sur laquelle vous souhaitez que l’article ou l’action apparaisse.

     NOTE

     Votre nom de domaine n’est pas inclus dans le chemin de l’URL. Par exemple, pour https://document360.com/ebook/rapid-guide/, le chemin de l’URL serait /ebook/rapid-guide/.

   • Action — Sélectionnez l’action souhaitée.

   • Sélectionnez l’espace de travail — Sélectionnez la version souhaitée (si vous en avez plusieurs).

   • Langue à — Sélectionnez la langue souhaitée (si vous en avez plusieurs).

   • Article à afficher — Dans la barre de recherche, sélectionnez les articles ou catégories que vous souhaitez afficher.

     NOTE

     Les catégories de dossiers ne sont pas disponibles pour la sélection. Seuls les types de pages et de catégories d’index sont disponibles.

5. Cliquez sur Créer.

Une fois qu’un utilisateur final accède à l’URL spécifiée et ouvre le widget, il verra l’article ou la catégorie mappée. Ce contenu est conservé lorsqu’ils naviguent entre les onglets widget au sein de la même version et langue.

Modification des correspondances d’URL

1. Naviguer vers Connexions () > Widget de la base de connaissances.
2. Survolez le widget souhaité et cliquez sur Modifier ().
3. Dans l’onglet de mappage d’URL , trouvez la liste des correspondances disponibles.
4. Survolez la correspondance souhaitée et cliquez sur Modifier ().
5. Le panneau de mappage Mettre à jour l’URL apparaît.
6. Mettez à jour les informations souhaitées et cliquez sur Mettre à jour.

Suppression des correspondances URL

1. Naviguer vers Connexions () > widget de base de connaissances.
2. Survolez le widget souhaité et cliquez sur Modifier ().
3. Dans l’onglet de mappage d’URL , trouvez la liste des correspondances disponibles.
4. Survolez la correspondance souhaitée et cliquez sur Supprimer ().
5. Cliquez sur Oui dans l’invite de confirmation Supprimer .

Paramètres de mappage d’URL (comportement par défaut)

Vous pouvez définir le comportement du widget pour les URL qui n’ont pas de mappage configuré.

1. Naviguer vers Connexions () > widget de la base de connaissances.
2. Survolez le widget souhaité et cliquez sur Modifier ().
3. Cliquez sur l’onglet Configurer & connecter .
4. Dans Définir les contrôles, développez la section des paramètres de mappage d’URL.
5. Sélectionnez l’option souhaitée :
   • Naviguez vers la page aide/base de connaissances — Affichez l’article ou la catégorie dans l’onglet Aide de la page ou la base de connaissances du widget.
   • N’apportez aucun changement à la configuration existante — affichez le dernier article ou catégorie ouvert dans le widget.
6. Cliquez sur Enregistrer.

Configuration de l’assistance par IA contextuelle

L’action d’assistance IA contextuelle vous permet d’afficher des invites alimentées par l’IA dans le widget en fonction du contexte de la page. Les invites peuvent apparaître lorsque les utilisateurs cliquent sur un bouton ou automatiquement lorsqu’ils ouvrent une page spécifique.

Vous pouvez configurer l’assistance de l’IA contextuelle de deux manières :

• Invite par boutons — Affiche une aide contextuelle lorsque les lecteurs cliquent sur des boutons spécifiques sur votre site web ou application.
• Invite au niveau de la page — Fournit une aide automatique pilotée par l’IA lorsque les utilisateurs ouvrent une page spécifique, sans nécessiter d’interaction avec les boutons.

Invite basée sur des boutons

Chaque invite que vous ajoutez génère une clé de déclenchement unique. L’invite est automatiquement validée en appuyant sur Entrée pour confirmer si une réponse est trouvée dans vos sources connectées. Vous pouvez configurer jusqu’à 5 correspondances bouton-invite par URL.

1. Dans la section Configurer l’aide à l’IA contextuelle , laissez la case Activer les invites au niveau de la page non cochée.
2. Saisissez votre invite de recherche.
3. Appuyez sur Entrée pour valider.
   • Si une réponse est trouvée, une étiquette verte Réponse trouvée apparaît.
   • Si aucune réponse n’est trouvée, une étiquette rouge « Réponse non trouvée » apparaît.
4. Si vous mettez à jour un bouton existant, copiez la touche Trigger et ajoutez-la au code du bouton en utilisant l’attribut d360AIHelp :

<button d360AIHelp="no6gNpyDqtyBhCVFMhYDXhugZ">Need help?</button>

5. Si vous créez un nouveau bouton, cliquez sur Copier le code à côté de Code d’installation et collez l’extrait dans le HTML de votre page.

6. Pour ajouter une autre invitation, cliquez sur Ajouter plus et répétez. Pour supprimer une invite, cliquez sur Supprimer.

Invite au niveau de la page

1. Sélectionnez la case à cocher pour l’invite au niveau de la page .
2. Dans le champ de recherche , saisissez votre requête.
3. Appuyez sur Entrée pour valider la demande.
   • Réponse verte trouvée = réponse disponible.
   • Réponse rouge non trouvée = pas correspondance.
4. Pour ajouter une autre invitation, cliquez sur Ajouter plus. Vous pouvez ajouter jusqu’à 5 invites par URL.
   • La première question apparaît comme la question principale.
   • Les autres requêtes apparaissent sous forme de requêtes suggérées.
5. Pour supprimer une invite, cliquez sur Supprimer à côté.

Une fois configuré, cliquez sur Créer.

Vous pouvez combiner des actions standard de mappage d’URL (comme Afficher un article) avec une assistance d’IA contextuelle sur différentes URL afin d’offrir une expérience utilisateur personnalisée et intelligente.

Utilisation du regex dans le mappage d’URL

Comprendre la correspondance d’URL est importante pour un mappage efficace des URL. Activez le bouton Is Regex lors de l’ajout ou de l’édition d’une correspondance pour utiliser des expressions régulières.

Patrons réguliers courants

Mapper un motif d’URL comme /users/{id}:

^/users/[0-9]+$

Carte /blog/* (joker) :

^/blog/.*?$

Carte /search?q={query}:

^/search?q=[a-zA-Z0-9]+$

URL des sous-domaines de la carte :

^https?://?[a-zA-Z0-9-]+.example.com$

Limites et limitations

• Les correspondances URL doivent utiliser le contenu dans la portée d’accès au contenu du widget. Si le périmètre change, les correspondances existantes peuvent être invalidées.
• Les modifications de configuration sont mises en cache jusqu’à 15 minutes. Videz le cache de l’application pour voir les changements immédiatement.

Meilleures pratiques

• Cartographiez d’abord vos pages de support les plus visitées — les analyses vous montreront où les utilisateurs recherchent le plus souvent pour obtenir de l’aide.
• Utilisez l’action Masquer sur les pages à forte friction (connexion, paiement, première configuration) où le widget distrait plutôt qu’aiderait.
• Utilisez Is Regex pour les mappages basés sur des motifs qui doivent couvrir plusieurs URL similaires.

FAQ

li#page-help-tab { display: none; }
.article-header .article-back-icon { display: none; }

.search-container { display: none !Important; }

setTimeout(function() { $('.search-container').hide(); }, 2000);
setTimeout(function() { $("#knowledge-base-tab").click(); }, 2000);