기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

웹 데이터 트래커를 사용하여 웹 사이트 방문자 활동 캡처

웹 데이터 트래커는 방문자가 클릭 항목, 검색 결과, 양식 제출 등 웹 사이트와 상호 작용하는 방식을 캡처합니다. 해당 활동을 Customer Profiles의 해당 프로필과 연결합니다. 트래커는 커뮤니케이션 위젯의 일부이며 위젯 수준에서 제어됩니다. 웹 데이터 트래커와 웹 알림이 함께 작동하는 방식에 대한 개요는 섹션을 참조하세요웹 데이터 트래커 및 웹 알림.

사전 조건

1단계: 커뮤니케이션 위젯에서 데이터 수집 활성화

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합니다.

메서드 서명

await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)

객체 스키마

는 다음 객체를 eventPayload 지원합니다. 사용 사례에 맞게 필드 조합을 사용합니다.

* 필수 필드

통합 단계 및 사용 예제

를 호출한 후 웹 사이트의 이벤트 핸들러에 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'
        }
    ]
});

예약 이벤트 유형

다음 이벤트 유형은 사전 정의된 스키마로 예약됩니다.

커스텀 이벤트

예약된 이벤트 유형 외에도 모든 사용자 지정 이벤트 유형 문자열(예: clear_cart 또는 wishlist_add)을 정의할 수 있습니다. 사용자 지정 이벤트의 경우:

await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', {
    cart_id: 'cart-123',
    item_list: [
        { item_id: 'p1', item_name: 'Widget', quantity: 1 }
    ]
});

클릭스트림을 Customer Profile과 연결

웹 데이터 트래커에서 캡처한 Clickstream 데이터는 Customer Profiles로 지속적으로 스트리밍됩니다. 데이터가 프로필과 연결되는 방법은 위젯 초기화 중에 프로필 키가 제공되는지 여부에 따라 달라집니다.

웹 분석 이벤트를 기존 프로필과 연결

추적을 알려진 프로필과 연결하려면 JWT 클레임profileKeys에서를 설정하여 연결 시 기존 프로필을 검색하고 연결하며, 서비스는 이러한 키를 사용하여 SearchProfiles API를 통해 일치하는 프로필을 찾습니다. 이를 위해서는 커뮤니케이션 위젯에서 보안을 활성화해야 합니다. 설정 세부 정보는 섹션을 참조하세요3단계: 커뮤니케이션 위젯 코드 및 보안 키 확인 및 복사.

{
  "sub": "<widgetId>",
  "iat": 1234567890,
  "exp": 1234571490,
  "profileKeys": {
    "_email": "user@example.com",
    "_account": "ACCT-12345"
  },
  "profileKeysOperator": "OR"
}

사용자 지정 식별자를 기준으로 이벤트 그룹화

기존 프로필에 연결할 필요가 없지만 클릭스트림 활동을 직접 그룹화하려는 경우 사용자 지정 식별자를 제공할 수 있습니다. 동일한 식별자를 공유하는 클릭스트림 이벤트는 공통 _webAnalyticsUserId 프로필 키로 그룹화됩니다.

두 가지 방법으로 제공할 수 있습니다.

캡처된 내용

트래커가 기본적으로 캡처하는 활동의 전체 목록은 섹션을 참조하세요웹 데이터 트래커가 캡처하는 내용.

개인 정보 보호 및 동의

웹 데이터 트래커는 옵트인 방식으로 설계되었습니다. 커뮤니케이션 위젯에서 데이터 수집을 활성화하지 않으면 클릭스트림 데이터가 캡처되지 않습니다. 양식 필드 값, 암호 및 결제 정보는 양식 제출 이벤트가 추적되더라도 자동으로 수집되지 않습니다.