Web ページからコパイロットにコンテキスト変数を渡す

コパイロットをカスタム Web サイトに展開するときに、Web ページからコパイロットにコンテキスト変数を渡したい場合があります。 Web ページからコパイロットにコンテキスト変数を効果的に渡すことができ、これらの変数を使用してユーザー エクスペリエンスを向上させることができます。 コンテキスト変数を使用すると、コパイロットは Web サイトの訪問者に合わせた、より有意義なインタラクションを提供できます。

コンテキスト変数を渡すタイミング

• Web 分析トラッキング ID を Web ページからコパイロットに渡して、Web 分析とコパイロット分析を一緒に分析します。

• ユーザーがコパイロットの注文 ID を再度入力する必要がないように、Web ページからコパイロットに注文 ID を渡します。 コパイロットは、Web ページから注文 ID 情報を取得するだけです。

• Web サイトの現在のページを渡すことで、コパイロットはユーザーがアクセスしている Web ページに応じてエクスペリエンスをカスタマイズできます。

• コパイロットに Web ページの言語を渡すと、コパイロットは Web ページの言語に応じてエクスペリエンスをカスタマイズできます。

コンテキスト変数を渡すには、次の 2 つのステップがあります: まず、Web ページからコパイロットにコンテキストを渡し、コパイロットにコンテキストを変数として保存します。

Web ページのコンテキストをコパイロットに渡す

コパイロットを呼び出す JavaScript コードに、コンテキストとして送信する値を含めます。 Web サイトからコパイロットに OrderId などの情報を渡すことができます。 たとえば、次のコード スニペットでは、3 つのコンテキスト変数が送信されます:

• Language
• currentURL
• OrderId

注意Note

詳細については、複数のトピックにわたってグローバル変数を再利用する を参照してください。 さらに、完全なカスタム キャンバス Webchat.js HTML/JavaScript コード ブロックについては、コパイロットの外観と操作感をカスタマイズする を参照してください。

コンテキストをコパイロットの変数として保存する

会話開始 システム トピック に、「質問する」ノードを追加します。 トピック を適切に設定するには、次の手順を実行してください:

• 質問がユーザーに表示されることを確認します。

• ユーザー応答を変数として保存するを選択します。 変数はグローバルへ送られます。

• 外部ソースが値を設定可能 を選択します。 詳細については、外部ソースからグローバル変数の値を設定する を参照してください。

注意Note

この例では会話開始システム トピック を使用していますが、Web ページから受信したコンテキストを任意の トピック に保存できます。

この変数をコパイロットで使用すると、注文 ID の注文詳細を取得したり、言語に合わせてチャットの動作をカスタマイズするなど、任意の目的に使用できます。 このコンセプトを使ってウェブ解析とコパイロット解析を組み合わせる例については、Web 分析とコパイロットの分析を組み合わせる を参照してください。