SDK
사전 준비
연동 전 필요한 API Key, 도메인 등록, 캠페인 조건을 안내합니다.
시작하기
인센토 위젯을 연동하기 전에 아래 요소를 확인해주세요.
- API 키 — 인센토 개발자센터 > 콘솔 > Credentials에서 조회할 수 있습니다.
- 활성 캠페인 1개 이상 — 활성 상태의 캠페인이 없으면 위젯이 표시되지 않습니다. 인센토 대시보드에서 관리합니다.
- 실제 동작 예제 — github.com/OpenFormatKorea/incento-sdk-sample-apps를 참고해 주세요.
- 환경별 연동 가이드 — 준비가 끝나면 다음 중 사용 환경에 맞는 가이드로 이동해주세요.
용어
문서 전반에서 사용하는 핵심 용어입니다.
| 용어 | 설명 |
|---|---|
| 캠페인 | 리워드 규칙과 노출 조건을 정의하는 단위입니다. 활성 캠페인이 1개 이상 있어야 위젯이 표시되며, 인센토 대시보드에서 관리합니다. |
| 위젯 | 리워드, 공유 링크 버튼 등의 캠페인 콘텐츠가 표시되는 패널입니다. 평소에는 닫혀 있다가 런처 클릭이나 코드 호출(open)로 열립니다. |
| 런처 | SDK가 기본 제공하는, 클릭하면 위젯을 여는 버튼입니다. 크기·위치·모양은 인센토 대시보드에서 설정한 값이 자동으로 반영됩니다. |
| 커스텀 런처 | 기본 런처 대신 연동 개발사가 직접 만든, 위젯을 여는 버튼·요소입니다. |
- 런처 클릭 없이 코드에서 위젯을 직접 열고 닫으려면
open/close를 사용합니다. 자세한 내용은 위젯 열기/닫기를 참고하세요. - 기본 런처 대신 직접 만든 버튼으로 위젯을 열려면 아래 환경별 연동 가이드의
커스텀 런처절을 참고하세요.
더 알아보기
🤖 AI로 연동
Cursor, Claude 등 AI 도구 활용