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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • Modifiez le code d’intégration de Engagement Messenger pour activer les recommandations et transmettre la requête de recherche pour les recommandations en fonction de Recherche IA.

    Avant de commencer

    Procédure

    1. Accédez à la Tout > 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 de la section Code d’intégration.
    7. Collez le code que vous avez copié dans le fichier texte avant la balise de fermeture du corps.
    8. Activez les recommandations pour une page spécifique dans Messenger en ajoutant le paramètre enableRecommendations : true dans le code d’intégration.
      Sur le site web où vous vous intégrez Engagement Messenger, lorsque l’utilisateur saisit un terme de recherche dans messenger, par défaut, le slug de l’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 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 inclus est considéré comme un terme de recherche. Par exemple, dans le 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.
      L’URL slug 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 le https://example.service-now.com/product-xyz d’URL, le terme recherché est « produit xyz ».
      • Toute extension de fichier est ignorée. Par exemple, dans le https://example.service-now/product.html URL, le terme recherché 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. 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 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>