개발사에 SDK 키 전달하기

외부 개발사나 외주 스튜디오에 광고 연동 키를 배포할 때는 반드시 해당 게임에 한정된 ’게임별 SDK 키’만 전달해야 합니다.

본사의 ’조직 공용 SDK 키’는 본사가 소유한 모든 게임에 광고를 송출할 수 있는 강력한 키이므로 외부 파트너에게 전달하지 마세요.

1. 개발 수명 주기별 전달 가이드

graph LR
    Dev["1. 개발 및 테스트<br/>(SDK 키 미입력)"] --> Review["2. 플랫폼 심사<br/>(URL 제출)"]
    Review --> Approve["3. 플랫폼 승인<br/>(게임별 키 자동 발급)"]
    Approve --> Live["4. 라이브 빌드 배포<br/>(게임별 SDK 키 반영)"]

1단계: 프로토타입 및 개발 단계 (키 전달 불필요)

본사는 개발사에 게임 ID와 지면별 광고 단위 ID만 전달합니다.
개발사는 SDK 설정 시 SDK 키를 비워두고 빌드합니다. SDK 키가 없으면 자동으로 테스트 세션으로 동작하므로, 키 유출 위험 없이 지면 렌더링과 광고 표시 흐름을 완벽히 테스트할 수 있습니다.

2단계: 플랫폼 심사 접수

게임 소유 조직에서 스토어 링크나 H5 심사 URL을 콘솔에 입력하고 플랫폼 심사를 요청합니다.

3단계: 승인 후 게임별 SDK 키 전달

플랫폼이 최초 승인되면 콘솔의 게임 상세 → 설정 화면에 해당 게임 전용 SDK 키가 자동 발급됩니다.
본사 담당자는 승인된 플랫폼 정보와 이 게임별 SDK 키를 안전한 채널(사내 메신저 시크릿 채팅, 사내 시크릿 보관소 등)을 통해 개발사에 공유합니다.

4단계: 라이브 빌드 배포 및 검증

개발사는 전달받은 키를 라이브 빌드 설정에 입력하고 마켓에 배포합니다.
배포 후 성과 리포트에서 실제 유효 노출과 예상 수익이 정상 집계되는지 확인합니다.

2. 키 유출 의심 시 대응 프로세스

외부 개발사 담당자의 퇴사, Git 공개 저장소 커밋 실수 등으로 키가 유출되었거나 노출이 의심되는 경우 다음 순서로 대응하세요.

영향 범위 파악: 노출된 키가 ’게임별 SDK 키’인지 확인하고, 해당 키가 적용된 라이브 앱의 배포 스토어 및 활성 유저 수를 파악합니다.
운영팀에 키 재발급 요청: EasterAd 운영팀 채널로 해당 게임 ID와 사유를 전달하여 게임별 SDK 키 재발급을 요청합니다.
신규 빌드 배포: 새로 발급된 SDK 키를 적용한 업데이트 빌드를 제작하여 스토어에 긴급 배포합니다.
기존 키 폐기 시점 조율: 기존 키를 즉시 폐기하면 아직 업데이트하지 않은 유저의 구버전 앱에서 광고 송출이 중단됩니다. 유저의 업데이트 전파율(통상 80~90% 이상)을 모니터링한 뒤, 운영팀과 협의하여 기존 키의 최종 폐기 시점을 확정하세요.

연관 안내서

SDK 키와 API 키의 기술적 차이점 비교: 연동에 사용할 키 선택
조직 공용 키의 2키 무중단 교체 방법: SDK 키 관리
파트너사 담당자별 콘솔 권한 설정: 개발사 파트너 권한 설정