이벤트 레퍼런스

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로 픽셀과 웹훅 소스 간의 이중 집계 방지

이전← 연동 대상 연결 다음중복 집계 방지 →