incento 개발자센터보안 · 문제 해결
문제 해결
위젯이 표시되지 않을 때의 점검 항목과 체크리스트입니다.
위젯이 표시되지 않을 때
먼저 debug: true 옵션을 추가해 콘솔 로그를 확인하세요.
<script>
Incento('boot', { apiKey: 'inc_pk_YOUR_KEY', debug: true });
</script>콘솔에서 확인할 수 있는 로그 패턴:
| 로그 패턴 | 원인 | 조치 |
|---|---|---|
✅ boot: started 이후 로그 없음 | SDK 파일 로드 실패 | 네트워크 탭에서 s3.incento.kr 요청 확인, CSP 설정 점검 |
⚠️ auth: skipped (no userId) | userId 미전달 (정상) | 비로그인 상태이면 정상 |
❌ active campaign: not found | 활성 캠페인 없음 | 인센토 대시보드에서 캠페인 활성화 여부 확인 |
✅ active campaign: found 이후 위젯 미표시 | DOM 삽입 오류 또는 CSS 충돌 | document.getElementById('incento-widget') 존재 여부 확인, z-index 충돌 점검 |
체크리스트
□ API Key가 inc_pk_... 형식인가?
□ API Key에 현재 도메인이 등록되어 있는가?
□ 인센토 대시보드에 활성 상태의 캠페인이 있는가?
□ CSP 정책이 widget.incento.kr, s3.incento.kr을 차단하고 있지 않은가?
□ 스니펫이 <head> 또는 <body>에 삽입되어 있는가?
□ Incento.boot()가 스니펫 이후에 호출되는가?
□ 브라우저 콘솔에 JavaScript 오류가 없는가?