픽셀의 작동 방식
Converlay는 Shopify의 Web Pixels API를 사용하여 스토어프론트 이벤트를 수집합니다. 픽셀은 Shopify가 전적으로 관리하는 샌드박스 iframe 안에서 실행되므로 스토어 성능에 전혀 영향을 주지 않습니다.
샌드박스 실행
Shopify는 커스텀 픽셀을 격리된 샌드박스에서 로드합니다. 따라서 픽셀은 메인 페이지의 DOM이나 쿠키에 접근하거나 스토어프론트를 간섭할 수 없습니다. 이벤트는 Shopify의 이벤트 버스를 통해 수신됩니다.
사용 가능한 브라우저 API
| API | 사용 가능 여부 |
|---|---|
browser.localStorage | 예 |
browser.cookie | 아니요 |
document.cookie | 아니요 |
window.localStorage | 아니요(browser.localStorage 사용) |
fetch / sendBeacon | 예 |
수집되는 데이터
모든 이벤트 페이로드에는 다음이 포함됩니다.
- 클라이언트 ID —
browser.localStorage에 저장되는 영구 식별자 - 세션 ID — 30분 롤링 윈도우, localStorage에도 저장
- 클릭 ID — 페이지 URL에서 추출되는
gclid,fbclid,ttclid - UTM 파라미터 —
utm_source,utm_medium,utm_campaign,utm_term,utm_content - Facebook Browser ID — 클라이언트 ID에서 생성되는
_fbp, fbclid에서 생성되는_fbc - 결제 단계의 PII — 이메일, 전화번호, 이름, 주소(전달 전에 서버사이드에서 SHA-256으로 해시 처리)
- 동의 상태 — Shopify의 Customer Privacy API에서 Google Consent Mode v2 신호로 매핑
전송 방식
이벤트는 페이지 이탈 시에도 안정적으로 전송되도록 navigator.sendBeacon을 사용하여 Converlay 수집 엔드포인트로 전송됩니다. sendBeacon을 사용할 수 없는 경우 픽셀은 표준 fetch POST 요청으로 폴백합니다.
데이터 지속성
클라이언트 ID와 세션 ID는 browser.localStorage에 저장됩니다. localStorage를 사용할 수 없는 경우(예: 일부 프라이버시 중심 브라우저) 픽셀은 인메모리 저장소로 폴백합니다. 이 경우 ID는 페이지 로드마다 다시 생성됩니다.
픽셀 버전 관리
각 픽셀 배포에는 버전 번호와 커밋 해시가 포함됩니다. 실행 중인 버전은 Converlay 대시보드에서 확인하거나, 브라우저 콘솔에서 [Converlay] 로그 항목을 검색하여 확인할 수 있습니다.
캐싱
Shopify는 웹 픽셀 코드를 적극적으로 캐싱합니다. 새 픽셀 버전을 배포한 후 코드 변경 사항을 적용하려면 설정 → 고객 이벤트에서 픽셀 연결을 해제한 뒤 다시 연결해야 합니다. 설정 변경 사항은 일괄 업데이터를 통해 원격으로 적용할 수 있습니다.