incento 개발자센터SDKReference
boot 파라미터
SDK 초기화(boot) 호출에 전달하는 파라미터 레퍼런스입니다.
boot는 SDK의 진입점으로, 캠페인 조회 및 위젯 마운트를 시작합니다. 모든 플랫폼이
동일한 파라미터를 공유합니다. 플랫폼별 호출 형태는 각 연동 가이드를 참고하세요.
파라미터
Prop
Type
debug는 디버깅 용도입니다. 환경 변수로 관리하여 운영 배포 전 반드시 제거하거나 false로 두세요.
pagePath는 대시보드의 '경로별 리퍼럴 시도 횟수' 차트용 초기 세션 경로입니다. 이후 경로
변경분은 setPath로 갱신합니다. 자세한 내용은
경로별 리퍼럴 시도 추적을 참고하세요.
userCreatedAt — 기존 회원 식별
SDK 설치 이전부터 존재하던 기존 회원과 설치 이후 가입한 신규 회원을 구분하기 위해
회원의 원래 가입 일시를 전달합니다. 이 값은 고객사가 자신의 회원 DB에서 직접 읽어 넘겨주며,
인센토에 해당 회원이 신규 유저로 처음 등록될 때 가입일(date_joined)로 사용됩니다. 이미 등록된
유저에게는 무시되므로, 매 boot마다 항상 전달해도 안전합니다.
| 상황 | userCreatedAt 값 | 설명 |
|---|---|---|
| 기존 회원 (예: 2년 전 가입) | '2023-03-15T09:30:00+09:00' | SDK 설치 후 처음 로그인하더라도 인센토에 원래 가입일로 등록 |
| 신규 회원 (오늘 가입) | 현재 시각에 가까운 값 | 고객사가 막 생성한 회원 레코드의 가입 시각 |
| 가입 일시를 알 수 없음 | 생략 또는 null | 서버 현재 시각으로 처리 |
미래 시점은 허용되지 않습니다. 미래 datetime을 전달하면 400 validation_error로 거부됩니다.
boot 동작 순서
- URL 파라미터 파싱 (쿠키 저장:
incentoRefId,incentoCampaignId,incentoLinkTxnId) userId가 있으면 인증 토큰 발급 (또는 기존incentoCustomerAuth쿠키 재사용)- 활성 캠페인 조회 → 없으면 위젯 마운트 없이 종료
- 위젯 iframe 및 런처 DOM 삽입
- URL 파라미터에 따른 자동 오픈 처리
| 조건 | 동작 |
|---|---|
incento_popup=true | 로그인 여부와 무관하게 즉시 위젯 오픈 |
show_incento_popup=true (비로그인 상태) | 쿠키(inc-show-popup)에 저장 → 이후 로그인 후 boot 시 자동 오픈 |
자세한 동작은 URL 파라미터를 참고하세요.