콜백 함수

마지막 업데이트: 2024년 7월 22일

주제:
Dynamic Chat

Dynamic Chat 위젯 콜백 함수를 사용하여 대화 이벤트를 서드파티 플랫폼으로 보낼 수 있습니다.

시작하기

이 이벤트는 Dynamic Chat 위젯을 사용할 준비가 되었음을 나타내며 Dynamic Chat과 관련된 모든 스크립트가 웹 페이지에 로드될 때 실행됩니다.

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

대화 이벤트

이러한 이벤트는 특정 방문자의 특정 페이지를 대상으로 하는 대화와 관련이 있습니다.

대화가 트리거됨

웹 사이트 방문자를 대상으로 하는 대화(예: 대화)가 해결되고 챗봇이 표시됩니다.

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
    });
});

대화 참여

방문자가 챗봇과 참여(예: 첫 번째 응답 제공)했습니다.

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
     });
});

대화 완료됨

방문자가 대화의 끝에 도달했습니다.

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

방문자 입력 이벤트

이러한 이벤트는 대화에 참여하는 방문자가 연락처 정보(예: 전화 번호 또는 이메일 주소)를 제공할 때 트리거됩니다. 다음은 이 범주에 속하는 이벤트입니다.

전화번호

이 이벤트는 대화 중에 방문자가 전화 번호를 제공할 때 트리거됩니다.

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

이 이벤트는 대화 중에 방문자가 이메일 주소를 제공할 때 트리거됩니다.

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

모임 예약 이벤트

이러한 이벤트는 방문자가 비즈니스 담당자와 회의를 예약할 때 트리거됩니다.

다음은 이 범주에 속하는 이벤트입니다.

예약된 회의

이 이벤트는 방문자가 에이전트의 캘린더에서 모임을 예약할 때 트리거됩니다.

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

라이브 채팅 이벤트

이러한 이벤트는 방문자가 챗봇과 참여하는 동안 라이브 에이전트와 연결할 때 트리거됩니다.

다음은 이 범주에 속하는 이벤트입니다.

라이브 채팅 요청됨

이 이벤트는 방문자가 라이브 에이전트와 채팅하도록 옵션을 선택하고 사용 가능한 에이전트를 해결하는 경우 트리거됩니다.

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
    });
});

라이브 채팅 시작됨

이 이벤트는 방문자가 라이브 에이전트와 채팅하도록 옵션을 선택하고 에이전트가 채팅을 수락하면 트리거됩니다.

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
    });
});

라이브 채팅 종료됨

이 이벤트는 방문자와 라이브 에이전트 간의 대화가 종료될 때 트리거됩니다.

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
    });
});

라이브 채팅 시간 초과

이 이벤트는 방문자의 응답이 중지되었거나 방문자가 중단되어 라이브 채팅 대화 시간이 초과되면 트리거됩니다.

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,
    });
    });
});

이전 페이지라우팅

다음 페이지사용 제한

대화 종료됨

방문자 입력 이벤트

전화번호

이메일 ID

모임 예약 이벤트

예약된 회의

라이브 채팅 이벤트

라이브 채팅 요청됨

라이브 채팅 시작됨

라이브 채팅 종료됨

라이브 채팅 시간 초과

학습

설명서

인증

이벤트

커뮤니티

지원

리소스

Adobe 계정

Adobe

콜백 함수

시작하기

대화 이벤트

대화가 트리거됨

대화 참여

대화 완료됨

대화 종료됨

방문자 입력 이벤트

전화번호

이메일 ID

모임 예약 이벤트

예약된 회의

라이브 채팅 이벤트

라이브 채팅 요청됨

라이브 채팅 시작됨

라이브 채팅 종료됨

라이브 채팅 시간 초과

Marketo Engage