개발사에 SDK 키 전달하기
외부 개발사나 외주 스튜디오에 광고 연동 키를 배포할 때는 해당 게임에 한정된 ’게임별 SDK 키’만 전달합니다.
여러 게임에 쓰는 조직 공용 키는 자사 팀이 관리하는 빌드에만 사용합니다.
1. 개발 단계별 키 전달하기
섹션 제목: “1. 개발 단계별 키 전달하기”graph LR
Dev["1. 개발 및 테스트<br/>(SDK 키 미입력)"] --> Review["2. 플랫폼 심사<br/>(URL 제출)"]
Review --> Approve["3. 플랫폼 승인<br/>(게임별 키 자동 발급)"]
Approve --> Live["4. 라이브 빌드 배포<br/>(게임별 SDK 키 반영)"]
1단계: 프로토타입 및 개발 단계 (키 전달 불필요)
섹션 제목: “1단계: 프로토타입 및 개발 단계 (키 전달 불필요)”- 본사에서 개발사에 게임 ID와 지면별 광고 단위 ID만 전달합니다.
- 개발사에서 SDK 키를 입력하지 않고 빌드합니다. SDK 키를 비워두면 자동으로 테스트 세션으로 동작하므로 지면 배치와 광고 표시 흐름을 확인합니다.
2단계: 플랫폼 심사 접수
섹션 제목: “2단계: 플랫폼 심사 접수”- 콘솔에 스토어 링크 또는 H5 심사 URL을 입력하고 플랫폼 심사를 요청합니다.
3단계: 승인 후 게임별 SDK 키 전달
섹션 제목: “3단계: 승인 후 게임별 SDK 키 전달”- 플랫폼 최초 승인 후 콘솔의 게임 상세 → 설정 화면에서 해당 게임 전용 SDK 키를 확인합니다.
- 승인된 플랫폼 정보와 게임별 SDK 키를 사내 시크릿 보관소나 보안 채널로 개발사에 전달합니다.
4단계: 라이브 빌드 배포 및 검증
섹션 제목: “4단계: 라이브 빌드 배포 및 검증”- 개발사 담당자는 개발 환경에 맞춰 게임별 SDK 키를 설정합니다.
- Unity: 라이브 빌드 설정에 SDK 키를 입력합니다.
- Cocos SDK 0.2.0: H5 호스트의 최상위
sdkKey옵션에 키를 적용합니다.
- 라이브 빌드를 배포합니다.
- 배포 후 게임 및 광고 단위, 집계 기간과 시간대, 테스트·운영 구분을 기준으로 유효 노출과 수익을 확인합니다. 세부 확인 절차는 성과 보고서 확인하기을 따릅니다.
2. 키 유출에 대응하기
섹션 제목: “2. 키 유출에 대응하기”게임별 SDK 키가 유출되었거나 노출이 의심되면 다음 순서로 대응합니다.
- 키가 적용된 게임과 서비스 중인 빌드의 범위를 확인합니다.
- 문의하기로 게임 ID·노출 경위·빌드 적용 범위를 전달하여 키 재발급과 전환 일정을 요청합니다.
- 안내받은 일정에 따라 새 키를 Unity 빌드나 H5 호스트에 적용하고 배포합니다. 기존 키가 폐기되면 해당 키를 쓰는 게임의 광고가 중단되므로, 업데이트 적용 현황을 함께 확인합니다.
연관 안내서
섹션 제목: “연관 안내서”- SDK 키와 API 키의 기술적 차이점 비교: 연동에 사용할 키 선택
- 조직 공용 키의 2키 무중단 교체 방법: SDK 키 관리
- 파트너사 담당자별 콘솔 권한 설정: 개발사 파트너 권한 설정