incento 개발자센터Reference
이벤트 훅
loginRequired, widgetOpen, widgetClose 등 SDK 이벤트 훅 레퍼런스입니다.
SDK는 위젯 상태 변화와 로그인 요청을 이벤트 훅으로 전달합니다. 이벤트 개념과 목록은 모든 플랫폼이 동일하며, 등록·핸들러 구현 방식은 플랫폼마다 다릅니다.
- JS SDK: MPA — 이벤트 훅 · SPA
- Mobile SDK: iOS · Android
이벤트 목록
| 이벤트 | 발생 시점 | 필수 여부 |
|---|---|---|
loginRequired | 위젯 내 로그인 버튼 클릭 시 | ✅ 필수 |
widgetOpen | 위젯이 열릴 때 | — |
widgetClose | 위젯이 닫힐 때 | — |
loginRequired (필수)
위젯 내에서 로그인이 필요한 상황이 발생할 때 호출됩니다.
미등록 시 위젯 내 [로그인] 버튼이 동작하지 않습니다. 반드시 등록하세요.
로그인 완료 후 위젯을 자동으로 다시 열려면, 로그인 흐름에서
incento_popup 파라미터를
활용합니다. 플랫폼별 구현 예시는 각 연동 가이드를 참고하세요.
등록 규칙
loginRequired,widgetOpen,widgetClose모두 SDK 초기화 전후 언제든 등록할 수 있습니다.- 같은 이벤트에 핸들러를 여러 개 등록하면 등록 순서대로 모두 호출됩니다. 덮어쓰지 않습니다.
- 이벤트는 위젯 iframe 로드 후 발생하므로, 초기화 이후에 등록해도 이벤트를 놓치지 않습니다.