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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 Tous > Engagement Messenger > Modules.
    2. Sélectionnez le module Engagement Messenger que vous souhaitez installer sur votre site Web.
    3. Dans la colonne Modifier le module, cliquez sur 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 à partir de la section Code intégré.
    7. Collez le code que vous avez copié dans le fichier texte avant la balise de corps de fermeture.
    8. Activez les recommandations pour une page spécifique dans la messagerie en ajoutant le paramètre enableRecommendations : true dans le code intégré.
      Dans le site Web sur lequel vous vous intégrez Engagement Messenger, lorsque l’utilisateur saisit un terme de recherche dans la messagerie, par défaut, le slug d’URL du site Web (dernière partie de l’URL) sera considéré comme la requête de recherche. Les conditions de la slug d’URL pour la requête de recherche saisie dans la barre de recherche de la messagerie sont les suivantes :
      • Si une seule barre oblique figure à 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 inclus est considéré comme un terme de recherche. Par exemple, dans la https://example.service-now.com/product-xyz/ d’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 est utilisée pour déduire la requête de recherche comme suit :
      • Tous les caractères spéciaux sont remplacés par un espace. Par exemple, dans le https://example.service-now.com/product-xyz de l’URL, le terme de recherche est « produit xyz ».
      • Toute extension de fichier est ignorée. Par exemple, dans le https://example.service-now/product.html de l’URL, le terme de recherche est « produit ».
    9. Activez les recommandations au niveau du module.
      1. Accédez à la Tous > Engagement Messenger > Modules.
      2. Sélectionnez votre Engagement Messenger module.
      3. Cliquez sur 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 pour transmettre un paramètre de requête de recherche à en Recherche IA transmettant un rappel de fonction comme valeur pour un paramètre getAISRecommendationsContext.
      L’exemple suivant montre le code modifié pour générer des recommandations proactives avec la logique personnalisée pour transmettre 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 basées sur le 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>