Utiliser Engagement Messenger le code intégré pour intégrer des recommandations proactives sur une page Web

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture
  • Modifiez le code incorporé de Engagement Messenger pour activer les recommandations et transmettre la requête de recherche pour les recommandations basées sur Recherche IA.

    Avant de commencer

    Procédure

    1. Accédez à la Tout > Engagement Messenger > Modules.
    2. Sélectionnez le Engagement Messenger module que vous souhaitez installer sur votre site web.
    3. Dans la colonne Modifier le module, sélectionnez Modifier.
    4. Dans le module Configurer Engagement Messenger, sélectionnez l’onglet Implémenter .
    5. Dans un éditeur de texte, ouvrez le fichier HTML de la page Web sur votre site Web où vous intégrez Engagement Messenger.
    6. Dans l’onglet Implémenter , copiez le code de la section Code incorporé.
    7. Collez le code que vous avez copié dans le fichier texte avant la balise body de fermeture.
    8. Activez les recommandations pour une page spécifique dans Messenger en ajoutant le paramètre enableRecommendations : true dans le code incorporé.
      Lorsqu’un utilisateur saisit un terme de recherche dans Engagement Messenger, la slug d’URL du site Web (la dernière partie de l’URL) est incluse par défaut dans la requête de recherche. Les conditions de slug d’URL pour la requête de recherche saisie dans la barre de recherche de Messenger sont les suivantes :
      • Si une seule barre oblique se trouve à la fin de l’URL, aucun terme de recherche n’est sélectionné. Par exemple, https://example.service-now.com/.
      • Si un terme est entouré de barres obliques à la fin de l’URL, le texte joint est considéré comme un terme de recherche. Par exemple, dans la https://example.service-now.com/product-xyz/ URL, le produit xyz est considéré comme un terme de recherche.
      • Si une seule barre oblique est suivie d’un texte, ce texte est considéré comme un terme de recherche. Par exemple, dans l’URL, https://example.service-now.com/search_string chaîne de recherche est considérée comme un terme de recherche.
      La slug d’URL permet de déduire la requête de recherche comme suit :
      • Tous les caractères spéciaux sont remplacés par un espace. Par exemple, dans la https://example.service-now.com/product-xyz URL, le terme de recherche est « produit xyz ».
      • Toute extension de fichier est ignorée. Par exemple, dans la https://example.service-now/product.html URL, le terme de recherche est « produit ».
    9. Activez les recommandations au niveau du module.
      1. Accédez à la Tout > Engagement Messenger > Modules.
      2. Sélectionnez votre Engagement Messenger module.
      3. Sélectionnez Modifier.
      4. Dans le module de configuration d'Engagement Messenger, sélectionnez l'onglet Comportement.
      5. Activez le commutateur Activer les recommandations .
    10. Facultatif : Ajoutez une logique personnalisée lors du passage d’un paramètre de Recherche IA requête de recherche en transmettant un rappel de fonction comme valeur d’un paramètre getAISRecommendationsContext.
      L’exemple suivant montre le code modifié pour générer des recommandations proactives avec la logique personnalisée de transmission d’une requête de contexte de recherche.
      ‹script src="https://example.service-now.com/scripts/sn_csm_ec.js"></script>
        ‹script>
        SN_CSM_EC.init({
                    moduleID:"https://instancename.service-now.com/<sys_id>",
                     loadFeature: SN CSM EC. loadEMFeature(),
                     enableRecommendations: true, 
                     getAISRecommendationsContext: function getSearchQuery(){
                     //Insert your code here to fetch the search query string return product xyz
      }
      
        };
        </script>
    11. Enregistrez et publiez le fichier HTML.

    Résultats

    Engagement Messenger Affiche des recommandations en fonction du contexte fourni par le site web tiers.

    Exemple

    L’exemple suivant montre le code modifié pour générer des recommandations proactives par défaut pour le contexte par défaut.
    ‹script src="https://example.service-now.com/scripts/sn_csm_ec.js"></script>
      ‹script>
      SN_CSM_EC.init({
                  moduleID:"https://instancename.service-now.com/<sys_id>",
                   loadFeature: SN CSM EC. loadEMFeature(),
                   enableRecommendations: true 
                  }
    
      };
      </script>