コールバック関数 callback-functions

Dynamic Chat ウィジェットコールバック関数を使用すると、対話イベントをサードパーティプラットフォームに送信できます。

はじめに getting-started

このイベントは、Dynamic Chat ウィジェットの使用準備が整っていることを示し、Dynamic Chat に関連するすべてのスクリプトが web ページに読み込まれると発生します。

window.addEventListener('adobedx.conversations.ready', () => {
    // code here will execute when chatbot scripts are loaded in a webpage
});

対話イベント conversation-events

このイベントは、特定の訪問者の特定のページでターゲットとされる対話に関連しています。

対話トリガー済み

Web サイトの訪問者をターゲットとした対話(ダイアログなど)が解決され、チャットボットが訪問者に表示されます。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_TRIGGERED, (event) => {
 // code here will execute when the chatbot is loaded for a visitor
    });
});

対話エンゲージ済み conversation-engaged

訪問者がチャットボットに関与しました(最初の応答を提供するなど)。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_ENGAGED, (event) => {
 // code here will execute when a visitor engages with the chatbot
     });
});

対話完了 conversation-completed

訪問者が対話の終了に達しました。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_COMPLETED, (event) => {
 // code here will execute when a conversation is completed
     });
});

対話クローズ済み

訪問者が終了に達する前に対話をクローズしました。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_CLOSED, (event) => {
 // code here will execute when a conversation is closed
    });
});

event パラメーターは、対話に関連するメタデータを含むオブジェクトです。このメタデータには、event.data にアクセスすることでアクセスできます。

アクセスできるいくつかの主なメタデータ値を次に示します。

メタデータ
属性
対話名
payload.name
対話 ID
payload.id
対話タイプ(ダイアログ/対話フロー)
payload.type
UI タイプ(ポップアップ/チャットボット/インライン)
payload.uiType
セッション ID
payload.sid

訪問者入力イベント

このイベントは、対話に関与している訪問者が取引先責任者情報(電話番号やメールアドレスなど)を入力するとトリガーされます。このカテゴリに該当するイベントを次に示します。

電話番号 phone-number

このイベントは、訪問者が対話中に電話番号を入力した際にトリガーされます。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_INPUT_PHONE, (event) => {
 // code here will execute when a visitor provides their phone number
    });
});

メール ID email-id

このイベントは、訪問者が対話中にメールアドレスを入力した際にトリガーされます。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_INPUT_EMAIL, (event) => {
 // code here will execute when a visitor provides their email address
    });
});

event パラメーターは、対話に関連するメタデータを含むオブジェクトです。このメタデータには、event.data にアクセスすることでアクセスできます。

アクセスできるいくつかの主なメタデータ値を次に示します。

メタデータ
属性
対話名
payload.name
対話 ID
payload.id
対話タイプ(ダイアログ/対話フロー)
payload.type
UI タイプ(ポップアップ/チャットボット/インライン)
payload.uiType
セッション ID
payload.sid

ミーティング予約イベント meeting-booking-events

このイベントは、訪問者がビジネス担当者とのミーティングを予約するとトリガーされます。

このカテゴリに該当するイベントを次に示します。

ミーティング予約済み meeting-booked

このイベントは、訪問者がエージェントのカレンダーでミーティングを予約するとトリガーされます。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_MEETING_BOOKED, (event) => {
 // code here will execute when a meeting is booked
    });
});

event パラメーターは、対話に関連するメタデータを含むオブジェクトです。このメタデータには、event.data にアクセスすることでアクセスできます。

アクセスできるいくつかの主なメタデータ値を次に示します。

メタデータ
属性
対話名
payload.name
対話 ID
payload.id
対話タイプ(ダイアログ/対話フロー)
payload.type
UI タイプ(ポップアップ/チャットボット/インライン)
payload.uiType
セッション ID
payload.sid
エージェント名
payload.agentName
エージェント ID
payload.agentID
ミーティング情報
payload.meetingInfo

ライブチャットイベント live-chat-events

このイベントは、訪問者がチャットボットとのエンゲージメント中にライブエージェントに接続するとトリガーされます。

このカテゴリに該当するイベントを次に示します。

ライブチャットリクエスト済み live-chat-requested

このイベントは、訪問者がライブエージェントとチャットするオプションを選択し、対応可能なエージェントが解決されるとトリガーされます。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_LIVE_CHAT_REQUESTED, (event) => {
 // code here will execute when a visitor requests a live chat
    });
});

ライブチャット開始済み live-chat-initiated

このイベントは、訪問者がライブエージェントとチャットするオプションを選択し、エージェントがチャットを受け入れるとトリガーされます。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_LIVE_CHAT_INITIATED, (event) => {
 // code here will execute after a live agent accepts the chat
    });
});

ライブチャット終了済み live-chat-ended

このイベントは、訪問者とライブエージェント間の対話が終了するとトリガーされます。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_LIVE_CHAT_ENDED, (event) => {
 // code here will execute when a live chat is ended
    });
});

ライブチャットタイムアウト live-chat-timeout

このイベントは、訪問者が応答の停止やドロップを行ったので、ライブチャットの対話がタイムアウトするとトリガーされます。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_LIVE_CHAT_REQUEST_TIMEOUT, (event) => {
 // code here will execute when a visitor abandons a live chat
    });
});

event パラメーターは、対話に関連するメタデータを含むオブジェクトです。このメタデータには、event.data にアクセスすることでアクセスできます。

アクセスできるいくつかの主なメタデータ値を次に示します。

メタデータ
属性
対話名
payload.name
対話 ID
payload.id
対話タイプ(ダイアログ/対話フロー)
payload.type
UI タイプ(ポップアップ/チャットボット/インライン)
payload.uiType
セッション ID
payload.sid
エージェント名
payload.agentName
エージェント ID
payload.agentID

これらのイベントのいずれかを Adobe Analytics や Google Analytics などの分析プラットフォームに送信する場合は、これらの Dynamic Chat イベント内にそれぞれのトラッキング呼び出しを追加する必要があります。次の例のようになります。

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_TRIGGERED, (event) => {
 // Enter Adobe Analytics or Google Analytics function here
    ga('send', 'event', {
      eventCategory: Dynamic Chat Conversations',
      eventAction: 'Conversation Triggered',
      eventLabel: event.data.payload.id,
    });
    });
});
recommendation-more-help
94ec3174-1d6c-4f51-822d-5424bedeecac