이벤트 추적
converlay.track(eventName, properties)를 사용하여 이벤트를 전송합니다. SDK는 각 이벤트에 클라이언트 ID, 세션, UTM, 클릭 ID, 동의 상태를 자동으로 추가합니다.
API 시그니처
track() signature
converlay.track('event_name', {
ecommerce: {
transaction_id: 'ORD-123',
value: 99.99,
currency: 'USD',
items: [
{
item_id: 'SKU-001',
item_name: 'Classic Tee',
price: 29.99,
quantity: 2,
},
],
},
userData: {
email: 'customer@example.com',
},
pageType: 'product',
})표준 이벤트 이름
GA4, Meta, TikTok 이벤트 유형에 자동으로 매핑하려면 다음 이벤트 이름을 사용하세요:
| 이벤트 이름 | 발생 시점 |
|---|---|
page_view | 페이지 로드 또는 클라이언트사이드 내비게이션 |
view_item | 상품 상세 페이지 |
view_item_list | 컬렉션 또는 검색 결과 페이지 |
add_to_cart | 장바구니에 상품 추가 |
remove_from_cart | 장바구니에서 상품 제거 |
search | 검색어 제출 |
begin_checkout | 결제 시작 |
add_payment_info | 결제 정보 입력 |
add_shipping_info | 배송 정보 입력 |
purchase | 주문 완료 |
커스텀 이벤트
어떤 문자열이든 이벤트 이름으로 사용할 수 있습니다. 커스텀 이벤트는 이를 지원하는 연동 대상에 그대로 전달됩니다.
TrackProperties 필드
| 필드 | 타입 | 설명 |
|---|---|---|
ecommerce | EcommerceData | 거래 및 상품 데이터 |
userData | UserData | 향상된 매칭을 위한 고객 PII(서버사이드에서 해시 처리) |
pageType | string | 페이지 유형 라벨(예: "product", "collection", "cart") |
[key: string] | unknown | 기타 추가 커스텀 속성 |
예시
상품 조회
typescript
converlay.track('view_item', {
ecommerce: {
items: [{
item_id: 'SKU-001',
item_name: 'Classic Tee',
item_variant: 'Blue / Large',
price: 29.99,
quantity: 1,
}],
},
})장바구니 추가
typescript
converlay.track('add_to_cart', {
ecommerce: {
value: 29.99,
currency: 'USD',
items: [{
item_id: 'SKU-001',
item_name: 'Classic Tee',
price: 29.99,
quantity: 1,
}],
},
})구매
typescript
converlay.track('purchase', {
ecommerce: {
transaction_id: 'ORD-5678',
value: 129.99,
currency: 'USD',
items: [
{ item_id: 'SKU-001', item_name: 'Classic Tee', price: 29.99, quantity: 2 },
{ item_id: 'SKU-042', item_name: 'Hoodie', price: 70.01, quantity: 1 },
],
},
userData: {
email: 'customer@example.com',
phone: '+15551234567',
firstName: 'Jane',
lastName: 'Doe',
},
})