이벤트 레퍼런스
Converlay는 Shopify의 Web Pixels API를 통해 10가지 스토어프론트 이벤트를 자동으로 트래킹합니다. 수동 이벤트 설정이 필요 없으며, 방문자가 스토어에서 활동하면 모든 이벤트가 자동으로 발생합니다.
자동 트래킹 이벤트
| 이벤트 | 트리거 | 주요 데이터 |
|---|---|---|
page_view | 모든 페이지 로드 시 | URL, 리퍼러, UTM |
view_item | 상품 페이지 조회 | 상품 ID, 이름, 가격, 옵션(variant) |
view_item_list | 컬렉션/검색 결과 조회 | 상품 목록 ID, 상품 목록 |
add_to_cart | 장바구니에 상품 추가 | 상품 ID, 수량, 가격 |
remove_from_cart | 장바구니에서 상품 제거 | 상품 ID, 수량 |
search | 검색 실행 | 검색어 |
begin_checkout | 결제 시작 | 장바구니 금액, 상품 목록 |
add_payment_info | 결제 정보 입력 | 결제 수단 |
add_shipping_info | 배송 정보 입력 | 배송 방법 |
purchase | 주문 완료 | 트랜잭션 ID, 금액, 상품 목록, 사용자 데이터 |
이벤트 페이로드 구조
Converlay 수집 엔드포인트로 전송되는 모든 이벤트는 다음 구조를 따릅니다. purchase 이벤트의 예시입니다.
purchase event payload
{
"event_id": "evt_abc123",
"event_name": "purchase",
"shop_domain": "my-store.myshopify.com",
"page_url": "https://my-store.com/thank-you",
"client_id": "clid_...",
"session_id": "sid_...",
"fbp": "fb.1.1700000000000.1234567890",
"gclid": "CjwKCAiA...",
"consent_data": {
"analytics": true,
"marketing": true,
"ad_user_data": true,
"ad_personalization": true
},
"ecommerce": {
"transaction_id": "5678",
"value": 129.99,
"currency": "USD",
"items": [
{
"item_id": "gid://shopify/ProductVariant/123",
"item_name": "Classic Tee",
"price": 29.99,
"quantity": 2
}
]
},
"user_data": {
"email": "sha256:abc...",
"phone": "sha256:def..."
}
}PII 처리
사용자 데이터(이메일, 전화번호, 주소)는 광고 플랫폼으로 전달되기 전에 서버에서 SHA-256으로 해시 처리됩니다. 원본 PII는 절대 저장되거나 공유되지 않습니다. 해시 처리 전에 국가별 정규화가 적용됩니다.
이벤트 보강
전달 전에 각 이벤트는 다음 정보로 보강됩니다.
- 클릭 ID 스티칭 —
gclid,fbclid,ttclid가 세션 간에 유지됩니다 - Facebook 파라미터 — Meta CAPI 매칭을 위한
_fbp와_fbc생성 - 세션 컨텍스트 — 영구 클라이언트 ID를 가진 30분 롤링 세션
- 동의 신호 — Shopify의 Customer Privacy API에서 매핑된 Google Consent Mode v2 신호
- 이벤트 중복 제거 — 고유한
event_id로 픽셀과 웹훅 소스 간의 이중 집계 방지