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

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 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 Modul Engagement Messenger aus, das Sie auf Ihrer Website installieren möchten.
    3. Wählen Sie in der Spalte Modul bearbeiten die Option Bearbeiten aus.
    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 ein Benutzer einen Suchbegriff in Engagement Messengereingibt, wird standardmäßig der URL-Slug der Website (der letzte Teil der URL) in die Suchabfrage einbezogen. 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://beispiel.service-now.com/product-xyzlautet der Suchbegriff beispielsweise „Produkt 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. Wählen Sie 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 hinzu, wenn Sie einen Suchabfrageparameter an KI-Suche übergeben, 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>