Verwenden Sie den Code zum Einbetten von Engagement Messenger, um proaktive Empfehlungen auf einer Webseite zu integrieren

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer
  • Ändern Sie den Einbettungscode von Engagement Messenger, um Empfehlungen zu aktivieren und die Suchabfrage für Empfehlungen basierend auf KI-Suchezu übergeben.

    Vorbereitungen

    Prozedur

    1. Navigieren zu Alle > Engagement Messenger > Module.
    2. Wählen Sie das Engagement Messenger-Modul aus, das Sie auf Ihrer Website installieren möchten.
    3. Klicken Sie in der Spalte „Modul bearbeiten“ auf Bearbeiten.
    4. Wählen Sie im Modul Konfigurieren von Engagement Messenger die Registerkarte Implementieren aus.
    5. Öffnen Sie die HTML-Datei der Webseite auf der Website, auf der Sie Engagement Messenger integrieren, in einem Texteditor.
    6. Kopieren Sie auf der Registerkarte Implementieren den Code aus dem Abschnitt Code einbetten.
    7. Fügen Sie den kopierten Code vor dem schließenden Textkörper-Tag in die Textdatei ein.
    8. Aktivieren Sie Empfehlungen für eine bestimmte Seite im Messenger, indem Sie im Einbettungscode den Parameter enableRecommendations: true hinzufügen.
      Wenn der Anwender auf der Website, in die Sie Engagement Messengerintegrieren, einen Suchbegriff in Messenger eingibt , wird standardmäßig der Website-URL-Slug (letzter Teil der URL) als Suchabfrage betrachtet. Die URL-Slug-Bedingungen für die in der Messenger-Suchleiste eingegebene Suchabfrage lauten wie folgt:
      • Wenn am Ende der URL ein einzelner Schrägstrich steht, wird kein Suchbegriff ausgewählt. Beispiel: https://beispiel.service-now.com/.
      • Wenn ein Begriff am Ende der URL von Schrägstrichen umgeben ist, wird der eingeschlossene Text als Suchbegriff betrachtet. In der URL https://beispiel.service-now.com/product-xyz/wird beispielsweise „product xyz“ als Suchbegriff betrachtet.
      • Wenn auf einen einzelnen Schrägstrich Text folgt, wird dieser Text als Suchbegriff betrachtet. Beispielsweise wird in der URL https://example.service-now.com/search_string die Suchzeichenfolge als Suchbegriff betrachtet.
      Der URL-Slug wird verwendet, um die Suchabfrage wie folgt abzuleiten:
      • Alle Sonderzeichen werden durch ein Leerzeichen ersetzt. In der URL https://example.service-now.com/product-xyzlautet der Suchbegriff beispielsweise „product xyz“.
      • Jede Dateierweiterung wird ignoriert. In der URL https://beispiel.service-now/product.htmllautet der Suchbegriff beispielsweise „Produkt“.
    9. Aktivieren Sie Empfehlungen auf Modulebene.
      1. Navigieren zu Alle > Engagement Messenger > Module.
      2. Wählen Sie Ihr Engagement Messenger -Modul aus.
      3. Klicken Sie auf Bearbeiten.
      4. Wählen Sie in „Engagement Messenger-Modul konfigurieren“ die Registerkarte Verhalten aus.
      5. Aktivieren Sie den Umschalter Empfehlungen aktivieren.
    10. Wahlweise: Fügen Sie anwenderdefinierte Logik für die Übergabe eines Suchabfrageparameters an KI-Suche hinzu, indem Sie einen Funktionsrückruf als Wert für den Parameter getAISRecommendationsContext übergeben.
      Das folgende Beispiel zeigt den geänderten Code zum Generieren proaktiver Empfehlungen mit der anwenderdefinierten Logik zum Übergeben einer Suchkontextabfrage.
      ‹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. Speichern und veröffentlichen Sie die HTML-Datei.

    Ergebnisse

    Engagement Messenger zeigt Empfehlungen basierend auf dem Kontext an, der von der Drittpartei-Website bereitgestellt wird.

    Beispiel

    Das folgende Beispiel zeigt den geänderten Code zum Generieren von standardmäßigen proaktiven Empfehlungen für den Standardkontext.
    ‹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>