エンゲージメントメッセンジャー の埋め込みコードを使用した、Web ページでの積極的推奨の統合

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

    • エンゲージメントメッセンジャー の埋め込みコードを変更して推奨事項を有効にし、AI 検索 に基づく推奨事項の検索クエリを渡します。

    始める前に

    手順

    1. 次のように移動する。 All (すべて) > Engagement Messenger (エンゲージメントメッセンジャー) > モジュール.
    2. Web サイトにインストールする エンゲージメントメッセンジャー モジュールを選択します。
    3. [モジュールの編集] 列で、[編集] を選択します。
    4. [Engagement Messenger モジュールを構成] で [実装] タブを選択します。
    5. テキストエディターで、エンゲージメントメッセンジャー を統合する Web サイトの Web ページの HTML ファイルを開きます。
    6. [実装] タブで、[埋め込みコード] セクションからコードをコピーします。
    7. 本文終了タグの前にコピーしたコードをテキストファイルに貼り付けます。
    8. 埋め込みコードにパラメーター enableRecommendations: true を追加して、Messenger の特定のページの推奨事項を有効にします。
      ユーザーが エンゲージメントメッセンジャー に検索語を入力すると、Web サイトの URL スラッグ (URL の最後の部分) がデフォルトで検索クエリに含まれます。メッセンジャー検索バーに入力された検索クエリの URL スラグ条件は次のとおりです。
      • URL の末尾に単一のフォワードスラッシュがある場合、検索用語は選択されません。たとえば、https://example.service-now.com/ です。
      • URL の末尾で用語がフォワードスラッシュで囲まれている場合、囲まれたテキストは検索用語と見なされます。たとえば、URL「https://example.service-now.com/product-xyz/」では、「product xyz」が検索用語と見なされます。
      • 単一のフォワードスラッシュの後にテキストが続く場合、そのテキストは検索用語と見なされます。たとえば、URL「https://example.service-now.com/search_string」では、「search string」が検索用語と見なされます。
      URL スラグは、次のように検索クエリを推定するために使用されます。
      • すべての特殊文字はスペースに置き換えられます。たとえば、URL https://example.service-now.com/product-xyz では、検索用語は「製品 xyz」です。
      • ファイル拡張子は無視されます。たとえば、URL https://example.service-now/product.html では、検索用語は「product」です。
    9. モジュールレベルで推奨事項を有効にします。
      1. 次のように移動する。 All (すべて) > Engagement Messenger (エンゲージメントメッセンジャー) > モジュール.
      2. エンゲージメントメッセンジャー モジュールを選択します。
      3. [編集] を選択します。
      4. [Engagement Messenger モジュールを構成] で、[動作] タブを選択します。
      5. [推奨事項を有効にする] 切り替えスイッチを有効にします。
    10. オプション: 検索クエリパラメーターを AI 検索 に渡すときに、関数コールバックをパラメーター getAISRecommendationsContext の値として渡すことで、カスタムロジックを追加します。
      次の例は、検索コンテキストクエリを渡すためのカスタムロジックを使用して積極的推奨を生成するように変更されたコードを示しています。
      ‹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. HTML ファイルを保存して公開します。

    タスクの結果

    エンゲージメントメッセンジャー は、サードパーティの Web サイトによって提供されるコンテキストに基づいて推奨事項を表示します。

    例

    次の例は、デフォルトコンテキストのデフォルトの積極的推奨を生成するように変更されたコードを示しています。
    ‹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>