GAD 오퍼월 연동 가이드

가이드는 로그인 없이 볼 수 있습니다. 콘솔은 공통 GAD 매체사 계정으로 로그인하며 PUBLISHER 권한이 필요합니다.

GAD 오퍼월을 스테이징 환경에서 연동하고 검증하는 방법을 안내합니다. 아래 순서대로 진행하면 광고 목록 조회부터 포스트백 수신 확인까지 끝낼 수 있습니다.

환경

환경	API 주소	용도
스테이징	`https://gad-staging.gpakorea.com`	연동 테스트. 테스트 광고만 있고 운영과 데이터가 나뉘어 있습니다.
운영	`https://gad.api.gpakorea.com`	실서비스

https://gad.api.gpakorea.com은 운영 SDK의 API 주소이며, 스테이징 가이드 주소는 https://developers-staging.gpakorea.com입니다. 문서·콘솔 주소와 API 주소는 다릅니다. SDK 사용자는 초기화의 환경 인자로 API 서버를 선택하며 직접 URL을 지정하지 않습니다. 서버 API 직접 연동 문서는 준비 중입니다.

스테이징은 가용성을 약속하지 않습니다. 장애 알림·구독이 없고 예고 없이 중단될 수 있습니다.

운영과 스테이징은 같은 GAD 매체사 계정을 사용합니다. 데이터·미디어키·콜백 설정은 환경마다 분리됩니다.

미디어키는 환경마다 따로 발급됩니다. 스테이징 키를 운영에, 운영 키를 스테이징에 쓰면 20(미디어키 오류)이 돌아옵니다.

스테이징 콘솔 로그인 — GAD 중앙 로그인에서 기존 매체사 계정으로 로그인하면 스테이징 콘솔로 돌아옵니다. 첫 로그인 시 전용 테스트 매체 4개가 자동으로 준비되며, '내 테스트 매체'에서 스테이징 미디어키를 확인하고 콜백 URL 을 등록합니다.
운영 콘솔 — 운영 환경은 운영 콘솔에서 매체를 등록하고 연동 정보를 넣습니다.

연동 방식

현재 Android SDK와 iOS SDK를 지원합니다. 앱의 플랫폼에 맞는 가이드로 시작하세요.

방식	설명	문서
SDK	광고 목록·상세·참여 화면을 SDK 가 그립니다. 앱은 초기화하고 화면을 띄우기만 합니다.	Android SDK iOS SDK
서버 API · 준비 중	서버 API 연동 가이드는 준비 중입니다.	서버 API 레퍼런스 · 준비 중

사용자가 광고를 완료하면 GAD 서버가 매체 서버로 포스트백을 보냅니다. 매체는 이 포스트백을 받아 사용자에게 리워드를 지급합니다.

콘솔에서 Android·SDK 또는 iOS·SDK 테스트 매체의 미디어키를 복사하세요. 서버 API용 매체키는 이번 SDK 연동에 사용하지 않습니다.

앱 밖 브라우저(모바일 웹·PC 웹) 지면은 이 연동의 범위가 아닙니다. 현재는 앱 안에서 Android 또는 iOS SDK 로 연동합니다. 서버 API 가이드는 준비 중입니다.

진행 순서: 스테이징 검증 후 운영 전환

아래 1~5단계는 스테이징 연동 검증입니다. 검증을 마친 뒤 6단계에서 운영으로 전환합니다.

공통 계정 로그인 — 스테이징 콘솔 로그인에서 GAD 중앙 로그인으로 이동합니다. 기존 GAD 매체사 계정으로 로그인하면 스테이징 콘솔로 돌아옵니다. 매체사 계정 또는 PUBLISHER 권한이 없으면 회사·앱 이름, Android/iOS 플랫폼, 담당자 이메일을 jyi4@gpakorea.com로 보내 문의하세요.
미디어키 확인 — 첫 로그인 시 자동으로 준비되는 전용 테스트 매체 4개 중 연동할 방식·플랫폼의 미디어키를 복사합니다.
콜백 URL 등록 — 매체사 개발팀이 운영하는 HTTPS 포스트백 수신 주소를 콘솔의 해당 SDK 테스트 매체에 등록합니다(등록 조건). 등록 후 jyi4@gpakorea.com 로 콜백 호스트 허용을 요청하고, 콘솔에서 허용됨 상태를 확인한 뒤 포스트백 테스트를 시작하세요. 호스트 허용의 소요 시간은 문의 시 확인해 주세요. 수신 서버가 아직 없다면 먼저 SDK 화면 연동을 진행하고, 포스트백 시험 방법은 GPA KOREA에 문의해 주세요.
연동 — Android SDK, iOS SDK 로 광고 목록을 띄웁니다.
테스트 — 테스트 광고에 참여하고 완료한 뒤 포스트백이 들어오는지 확인합니다(테스트 방법).
운영 전환 — 운영 미디어키와 운영 콜백 URL 로 바꾸고, SDK 의 스테이징 지정을 뺍니다.

알아둘 것

스테이징은 가용성을 약속하지 않습니다. 장애 알림·구독이 없고 예고 없이 중단될 수 있습니다.
앱 밖 브라우저(모바일 웹·PC 웹) 지면은 이 연동의 범위가 아닙니다. 현재는 앱 안에서 Android 또는 iOS SDK 로 연동합니다. 서버 API 가이드는 준비 중입니다.
미션형 광고는 스테이징에서 목록·상세·참여까지만 됩니다. 미션 제출과 검수는 시험할 수 없습니다.
스테이징은 GPA 가 허용한 호스트로만 포스트백을 보냅니다. 콜백 URL 을 등록한 뒤 호스트 허용을 요청해 주세요.
운영 매체 등록, 미디어키 확인, 콜백 URL 설정은 운영 콘솔에서 합니다. 운영과 스테이징은 같은 GAD 매체사 계정으로 로그인하며 데이터·미디어키·콜백 설정은 환경별로 분리됩니다.
스테이징은 연동에 필요한 경로만 인터넷에 열어 둡니다. 이 문서에 적힌 경로만 사용해 주세요. 경로는 소문자로, 끝에 슬래시 없이 적힌 그대로 호출합니다. 문서에 없는 경로는 예고 없이 막힐 수 있고, 막힌 경로는 403 입니다.
포스트백 발신 IP 가 필요하면 문의 메일로 요청해 주세요.

문의

연동 중 막히는 곳이 있으면 jyi4@gpakorea.com 로 알려 주세요. 미디어키(스테이징), 호출한 주소, 받은 응답을 함께 보내 주시면 빨리 확인할 수 있습니다.