호스트 앱 연결 가이드
- 조직과 앱을 만들고 정확한 허용 origin을 등록합니다.
- 앱에 지면을 만들고 공식 Koah slot은 이미 등록된 이름만 입력합니다.
- 호스트 앱 서버에서 서버 전용 키로 API tier(
https://api.<도메인>)의POST /v1/decisions를 호출합니다. 공개 웹 origin은 이 경로를403 api_tier_only로 거절하므로 서버 키를 브라우저 경로에 두지 마세요. consent·adFree·contextCategory는 호스트 앱 서버가 판단해야 합니다. - 허용 결과의 짧은 grant만 브라우저로 전달합니다. 서버 키를 노출하지 않습니다.
- 분리된 광고 요소에서
/assets/monetize.mjs의requestMonetizedAd를 호출합니다. 맥락은 고객 앱에서 최소화하여 SDK에만 전송합니다.
제어 API는 대화 본문을 받지 않습니다. 광고 허가 실패·타임아웃·no-fill에서도 앱의 본문 답변은 그대로 제공하세요. 관리자 콘솔에서 광고 SDK를 실행하지 마세요.
제공자 활성화는 서버 설정과 승인된 publisher가 모두 필요한 외부 게이트입니다. 수익 보고는 실제 지급 확인이 아닙니다.
Koah 공식 SDK 계약서버 키와 대화 원문을 브라우저 로그·SaaS 감사 기록에 남기지 마세요.