기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
웹 데이터 트래커를 사용하여 웹 사이트 방문자 활동 캡처
웹 데이터 트래커는 방문자가 클릭 항목, 검색 결과, 양식 제출 등 웹 사이트와 상호 작용하는 방식을 캡처합니다. 해당 활동을 Customer Profiles의 해당 프로필과 연결합니다. 트래커는 커뮤니케이션 위젯의 일부이며 위젯 수준에서 제어됩니다. 웹 데이터 트래커와 웹 알림이 함께 작동하는 방식에 대한 개요는 섹션을 참조하세요웹 데이터 트래커 및 웹 알림.
사전 조건
-
커뮤니케이션 위젯이 구성된 고객 연결 인스턴스입니다. 자세한 내용은 Connect Customer에서 호스팅하는 웹 사이트에 채팅 사용자 인터페이스 추가 단원을 참조하십시오.
-
인스턴스에서 Customer Profiles가 활성화되었습니다. 자세한 내용은 Connect Customer 인스턴스에 대해 Customer Profiles 활성화 단원을 참조하십시오.
1단계: 커뮤니케이션 위젯에서 데이터 수집 활성화
-
Connect Customer 관리자 웹 사이트에 로그인합니다.
-
탐색 메뉴에서 채널을 선택한 다음 커뮤니케이션 위젯을 선택합니다.
-
새 위젯을 생성하거나 기존 위젯을 편집합니다. 자세한 내용은 Connect Customer에서 호스팅하는 웹 사이트에 채팅 사용자 인터페이스 추가 단원을 참조하십시오.
-
데이터 수집을 활성화하여 클릭스트림 추적을 활성화합니다.
-
(선택 사항) 데이터 수집 설정에는 고급 데이터 수집에 대한 옵션이 포함됩니다. 이 기능을 켜면 서비스가 HTML 콘텐츠와의 방문자 상호 작용을 자동으로 수집하여 더 풍부하고 정확한 예측 인사이트를 얻을 수 있습니다.
-
(선택 사항)이 위젯에서 사전 알림을 보내려는 경우 웹 알림을 활성화합니다. 자세한 내용은 Connect Customer 아웃바운드 캠페인을 사용하여 웹 알림 전송 단원을 참조하십시오.
-
위젯이 포함된 웹 사이트 도메인을 허용된 도메인 목록에 추가합니다.
-
위젯을 저장하고 위젯 코드 조각을 복사합니다. 다음 단계에서이 코드 조각을 웹 사이트에 포함합니다.
2단계: 위젯 임베드 및 추적 초기화
웹 사이트의 HTML에 위젯 조각을 임베드합니다. 코드 조각이 로드된 후 방문자 동의를 얻은 후 트래커를 초기화합니다.
// Start tracking visitor behavior (after obtaining consent) await window.amazon_connect.Web.ClickStream.init(); // (Optional) Enable web notifications for this visitor await window.amazon_connect.Web.Notification.init();
중요
개인 정보 보호 정책 및 관련 규정에 따라 적절한 방문자 동의를 받은 후에만 추적을 초기화합니다.
참고
단일 페이지 애플리케이션의 경우 최상위 페이지에 코드 조각을 한 번 포함합니다. 다중 페이지 애플리케이션의 경우 활동을 캡처하려는 모든 페이지에 코드 조각을 포함합니다.
3단계: (선택 사항) 비즈니스별 이벤트 추적
구매 완료, add-to-cart 작업 또는 제품 보기와 같은 사용자 지정 비즈니스 이벤트를 캡처하려면 이벤트가 발생할 때 웹 사이트에서 JavaScript를 호출recordBusinessMetric합니다.
중요
Find Similar Items 및와 같은 항목 컨텍스트가 필요한 추천자와 함께 데이터 트래커를 사용하려면 비즈니스별 이벤트를 사용하고 item_id 필드를 포함해야 Frequently Paired Items합니다.
메서드 서명
await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)
파라미터 |
유형 |
설명 |
|---|---|---|
|
문자열 |
비즈니스 이벤트 이름 - 예약 유형 또는 사용자 지정 문자열입니다. |
|
객체 |
아래 객체 스키마를 사용하여 구조화된 이벤트 데이터입니다. |
객체 스키마
는 다음 객체를 eventPayload 지원합니다. 사용 사례에 맞게 필드 조합을 사용합니다.
객체 |
키 필드 |
설명 |
|---|---|---|
item |
|
단일 제품 또는 항목 |
item_list |
목록<항목> |
항목 객체 배열(최소 1개) |
장바구니 |
|
장바구니 |
주문 |
|
완료된 주문 |
search |
|
검색 작업 |
양식 |
|
양식 상호 작용 |
스크롤 |
|
스크롤 위치(하나 이상의 필드 필요) |
event_value |
number |
이벤트의 중요도를 나타내는 숫자 값 |
* 필수 필드
통합 단계 및 사용 예제
를 호출한 후 웹 사이트의 이벤트 핸들러에 recordBusinessMetric() 호출을 amazon_connect.Web.ClickStream.init()추가합니다(예: 클릭).
예 - 장바구니에 추가
await amazon_connect.Web.ClickStream.recordBusinessMetric('add_to_cart', { item: { item_id: 'prod-123', item_name: 'Wireless Headphones', price: 49.99, quantity: 1, currency: 'USD' } });
예 - 항목 보기
await amazon_connect.Web.ClickStream.recordBusinessMetric('view_items', { item_list: [ { item_id: 'item_10', quantity: 1, item_name: 'Premium Wireless Headphones', category: 'Electronics', price: 89.99, currency: 'USD' } ] });
예약 이벤트 유형
다음 이벤트 유형은 사전 정의된 스키마로 예약됩니다.
이벤트 유형 |
필수 객체 |
설명 |
|---|---|---|
|
item |
방문자가 장바구니에 항목을 추가할 때 추적 |
|
순서 |
완료된 구매를 추적합니다. |
|
item_list |
방문자가 하나 이상의 항목을 볼 때 추적 |
커스텀 이벤트
예약된 이벤트 유형 외에도 사용자 지정 이벤트 유형 문자열(예: clear_cart 또는 wishlist_add)을 정의할 수 있습니다. 사용자 지정 이벤트의 경우:
-
서비스는 이벤트 구조에 대해 엄격한 검증을 적용하지 않습니다.
-
위의 객체 스키마의 필드 조합을 사용 사례에 맞게 사용할 수 있습니다.
-
표시된 대로 필드 이름을 정확하게 사용합니다(예:가
cart_id아닌cartId).
await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', { cart_id: 'cart-123', item_list: [ { item_id: 'p1', item_name: 'Widget', quantity: 1 } ] });
인증된 사용자와 클릭스트림 연결
웹 데이터 트래커에서 캡처한 Clickstream 데이터는 Customer Profiles로 지속적으로 스트리밍되고 방문자의 프로필과 연결됩니다. 다음 표에서는 익명 및 인증된 방문자에 대해 해당 연결이 작동하는 방식을 설명합니다.
방문자 유형 |
프로필 연결 동작 |
|---|---|
익명 방문자 |
세션 식별자로만 추적됩니다. 동작 데이터는 캡처되지만 알려진 고객 자격 증명과 연결되지 않습니다. 개인 식별 정보는 수집되지 않습니다. |
인증된 방문자 |
위젯 초기화 중에 인증된 사용자 ID를 전달하면 서비스는 모든 클릭스트림 활동을 Customer Profiles에서 해당 사용자의 알려진 프로필에 연결합니다. 이를 통해 개인화가 더 풍부해지고 트리거 조건이 더 정확해집니다. |
추적을 인증된 사용자와 연결하려면 다음 방법 중 하나를 사용합니다.
-
(권장) CustomerId JWT 클레임 사용 - 통신 위젯에서 보안을 활성화한 경우 JSON 웹 토큰(JWT) 클레임의
CustomerId필드에 인증된 사용자 ID를 포함합니다. 이렇게 하면 클라이언트 측 코드에 ID를 노출하지 않고 클릭스트림 활동이 사용자의 프로필에 연결됩니다. 설정 세부 정보는 섹션을 참조하세요3단계: 커뮤니케이션 위젯 코드 및 보안 키 확인 및 복사. -
초기화 중 사용자 ID 전달 - 위젯에서 보안이 활성화되지 않은 경우 트래커를 초기화할 때 인증된 사용자 ID를 인수로 전달합니다.
await window.amazon_connect.Web.ClickStream.init('<authenticated-user-id>');
중요
인증된 사용자 ID가 전달되면 계정 키를 통해 기존 프로필에 연결됩니다. 데이터 트래커 이벤트는 시간이 지남에 따라 누적되므로 프로파일 객체 제한에 도달하면 새 이벤트가 다른 객체 유형을 덮어쓰지 _webAnalytics 않도록 WebAnalytics-Clickstream 및에 대한 객체 제한을 설정합니다. 구성 지침은 Customer Profiles 데이터 제한을 참조하세요.
캡처된 내용
트래커가 기본적으로 캡처하는 활동의 전체 목록은 섹션을 참조하세요웹 데이터 트래커가 캡처하는 내용.
개인 정보 보호 및 동의
웹 데이터 트래커는 옵트인 방식으로 설계되었습니다. 커뮤니케이션 위젯에서 데이터 수집을 활성화하지 않으면 클릭스트림 데이터가 캡처되지 않습니다. 양식 필드 값, 암호 및 결제 정보는 양식 제출 이벤트가 추적되더라도 자동으로 수집되지 않습니다.
중요
개인 정보 보호 정책 및 일반 데이터 보호 규정(GDPR) 및 캘리포니아 소비자 개인 정보 보호법(CCPA)과 같은 관련 규정에 따라 데이터 추적을 초기화하기 전에 적절한 방문자 동의를 받아야 합니다.