연동에 사용할 키 선택
연동 대상과 작업 범위에 따라 세 가지 자격증명(게임별 SDK 키, 조직 공용 SDK 키, REST API 키) 중 하나를 선택합니다.
1. 용도별 키 비교
섹션 제목: “1. 용도별 키 비교”| 구분 | 게임별 SDK 키 (권장) | 조직 공용 SDK 키 | REST API 키 |
|---|---|---|---|
| 주요 용도 | 단일 게임의 라이브 광고 세션 인증 | 조직 내 여러 게임의 통합 광고 세션 인증 | 서버 간 캠페인 관리 및 과금 내역 조회 |
| 적용 위치 | Unity 설정·H5 호스트 | Unity 설정·H5 호스트 | 백엔드 서버 환경 변수 / 시크릿 매니저 (Vault 등) |
| 권한 범위 | 해당 게임 1개로 한정 | 키를 발급한 조직이 소유한 모든 게임 | 부여된 역할(Role)에 따른 관리 작업 범위 |
| 발급 방식 | 게임 플랫폼 최초 승인 후 게임 설정에서 확인 | 조직 관리자가 조직 설정에서 수동 발급 (최대 2개 슬롯) | 조직 관리자가 멤버 관리에서 수동 발급 |
| 키 형태 | UUID (36자리 문자열) | UUID (36자리 문자열) | ea_<UUID>_<시크릿> |
| 클라이언트 포함 안전성 | 클라이언트 빌드에 포함 가능 | 클라이언트 빌드에 포함 가능 (외부 개발사에 전달 금지) | 클라이언트 빌드 포함 불가 (백엔드 서버 전용) |
2. 게임 클라이언트 연동: SDK 키 선택 기준
섹션 제목: “2. 게임 클라이언트 연동: SDK 키 선택 기준”개발·테스트할 때는 SDK 키를 생략해 테스트 세션으로 실행합니다. 라이브 광고로 전환할 때는 해당 플랫폼의 심사 승인과 유효한 SDK 키가 모두 필요합니다. Unity에서는 게임 SDK 설정에, Cocos에서는 H5 호스트의 최상위 sdkKey 옵션에 SDK 키를 입력합니다.
외부 개발사에는 게임별 SDK 키를 전달합니다. 같은 조직에서 여러 게임을 직접 빌드한다면 조직 공용 SDK 키를 선택할 수 있습니다.
3. 서버 자동화용 API 키
섹션 제목: “3. 서버 자동화용 API 키”게임·캠페인 관리나 잔액 조회를 자동화하려면 API 키를 발급하고 필요한 역할을 지정합니다. 키는 서버 환경 변수나 비밀 관리 시스템에 보관하고 서버에서만 사용합니다. 호출 방법은 API 인증을 따릅니다.