설치

@converlay/sdk 패키지를 설치하여 Hydrogen, Next.js, Remix, Nuxt 또는 일반 HTML 등 모든 헤드리스 스토어프론트에 서버사이드 이벤트 트래킹을 추가합니다.

패키지 설치

npm

npm install @converlay/sdk

pnpm

pnpm add @converlay/sdk

yarn

yarn add @converlay/sdk

패키지 정보

의존성 없음, gzip 압축 시 약 2 KB. ES2020을 타깃으로 하는 ESM + CJS 듀얼 빌드로 제공됩니다.

옵션	타입	기본값	설명
`shopDomain`	`string`	—	필수. `.myshopify.com` 도메인
`endpoint`	`string`	`https://converlay.app/api/events/collect`	수집 API 엔드포인트
`autoPageView`	`boolean`	`false`	초기화 시 `page_view` 자동 전송
`debug`	`boolean`	`false`	이벤트를 브라우저 콘솔에 출력
`consent`	`ConsentInput`	`{analytics: true, marketing: true}`	초기 동의 상태

임포트	내용
`@converlay/sdk`	`createConverlay` 팩토리 함수
`@converlay/sdk/react`	`ConverlayProvider` + `useConverlay` 훅(피어 의존성: `react >= 18`)