테스트 방법

스테이징에서 광고 목록 조회, 참여, 완료, 포스트백 수신까지 한 번 끝까지 해 보는 절차입니다.

1. 준비

스테이징 콘솔에서 GAD 중앙 로그인으로 이동해 기존 매체사 계정으로 로그인합니다. 로그인 후 스테이징으로 돌아오며 첫 로그인 시 전용 테스트 매체 4개가 자동으로 준비됩니다. 매체사 계정 또는 PUBLISHER 권한이 없으면 jyi4@gpakorea.com로 문의하세요.
'내 테스트 매체'에서 Android·SDK 또는 iOS·SDK 미디어키를 복사합니다.
매체사 개발팀이 준비한 HTTPS 포스트백 수신 URL을 콘솔의 해당 SDK 테스트 매체에 등록하고, GPA KOREA에 호스트 허용을 요청합니다.
수신 서버가 아직 없다면 목록·상세 화면까지 먼저 확인합니다. 포스트백 시험 지원이 필요하면 jyi4@gpakorea.com 로 문의해 주세요.

콜백 URL 은 테스트하기 전에 등록해 주세요. 등록하지 않은 매체에서 완료된 건은 포스트백이 나가지 않습니다.

2. 테스트 광고

스테이징에는 테스트 광고가 4개 있고 Android SDK와 iOS SDK 테스트 매체의 목록에 나옵니다. Android에서는 참여·설치·미션 광고는 광고적립 탭, CPS는 쇼핑적립 탭에서 확인합니다. iOS에서는 같은 광고 목록에 표시됩니다. 물량 제한은 없으며, 완료한 광고의 재참여 제한은 아래와 같습니다.

광고키	유형	SDK 방식
`staging-ad-2`	참여형(방문형)	참여하면 랜딩 페이지가 열립니다. 랜딩에서 방문하러가기, 적립요청을 차례로 누르면 완료되고 포스트백이 나갑니다. 완료하면 상세 화면의 버튼이 완료 표시로 바뀝니다.
`staging-ad-3`	설치형	참여까지만 됩니다. 설치할 실제 앱이 없어 SDK 가 설치를 확인하지 못합니다.
`staging-ad-1`	미션형	목록·상세·참여까지만 됩니다. 스테이징에서는 미션 제출과 검수를 시험할 수 없습니다.
`staging-ad-4`	CPS(구매형)	목록·상세·참여 후 자체 안내 화면까지 확인합니다. Android에서는 쇼핑적립 탭에 있습니다. 실제 상점·결제·구매확정·취소·적립은 제공하지 않습니다.

미션형 광고는 스테이징에서 목록·상세·참여까지만 됩니다. 미션 제출과 검수는 시험할 수 없습니다.

CPS 자체 시험

CPS 테스트 광고는 목록·상세·참여 후 이 안내 화면까지 확인하는 상품입니다. 실제 상점과 연결하지 않았으며 결제·구매확정·취소·적립을 처리하지 않습니다. 외부 상점의 구매 연동 검증은 별도로 진행합니다.

3. SDK 방식으로 해 보기

앱에서 스테이징 환경으로 초기화하고 광고 목록을 엽니다(Android, iOS). 화면에 STAGING 표식과 플랫폼별 탭의 테스트 광고가 보이는지 확인합니다.
참여형 광고(staging-ad-2)를 골라 참여합니다. 랜딩 페이지가 열립니다(Android는 기기 기본 브라우저, iOS는 앱 안의 웹뷰).
랜딩의 '방문하러가기'를 누르면 새 브라우저 화면(iOS는 Safari)이 열립니다. 랜딩 페이지로 돌아와 '적립요청'을 누릅니다. 완료 처리되고 포스트백이 예약됩니다.
iOS에서는 랜딩의 '닫기'를 누릅니다. SDK가 참여 상태를 다시 읽습니다.
앱으로 돌아오면 상세 화면의 버튼이 완료 표시로 바뀝니다. 완료한 광고에는 다시 참여할 수 없습니다.
아래 4번처럼 매체사 수신 서버의 기록으로 포스트백 수신을 확인합니다.

4. 포스트백 수신 확인

콜백 URL을 등록한 뒤: 콘솔의 콜백 상태가 '허용됨'이어야 발송됩니다. '허용 대기'이면 jyi4@gpakorea.com 로 호스트 허용을 요청해 주세요.
본문의 uid, adKey, publisher_data, point 가 기대한 값인지 봅니다(포스트백 규격).

5. 다시 테스트하기

한 광고는 사용자(uid)마다, 기기(adid)마다 한 번만 완료됩니다(운영과 같은 규칙). 완료한 뒤에는 같은 사용자든 같은 기기든 그 광고의 참여와 완료가 22 로 거절됩니다. 다시 시험할 때는 앱을 새 테스트 사용자 ID로 초기화하고, 다른 테스트 기기나 새 시뮬레이터를 사용합니다. SDK는 기기 식별값을 자동으로 정하므로 초기화 코드에서 adid를 임의로 지정하는 방법은 제공하지 않습니다. 같은 기기로 재시험해야 하면 jyi4@gpakorea.com로 시험 대상과 사용한 테스트 사용자 ID를 알려 주세요.

기기는 adid 로만 구분합니다. 완료한 기기는 uid 를 바꾸거나 다른 미디어키를 써도 그 광고에 다시 참여할 수 없습니다.
완료한 사용자가 새 adid 로 다시 참여하면 22 로 거절되고, 그 새 adid 도 완료한 기기로 기록됩니다.
테스트 광고는 서로 막지 않습니다. 한 광고를 완료해도 다른 테스트 광고에는 참여할 수 있습니다.
SDK가 기기 식별값을 함께 보내며, 해당 기기에서 완료한 광고는 목록에서 빠질 수 있습니다.

6. 잘 안 될 때

증상	확인할 것
HTTP 403	주소가 문서와 글자 그대로 같은지 봅니다(소문자, 끝 슬래시 없음, HTTP 메서드).
`code 20`	미디어키가 스테이징 콘솔의 키인지 봅니다. 운영 키는 스테이징에서 쓸 수 없습니다.
목록이 비어 있음	방식과 플랫폼에 맞는 테스트 매체 키인지 봅니다.
`code 100`	`adid` 가 비었거나 0 으로만 된 값인지, `uid` 가 48자를 넘는지 봅니다.
설치형 참여가 `code 300`	설치형의 IP 중복 제한에 걸린 응답입니다. SDK에서 IP 값을 바꾸도록 요청하지 마세요. 사용한 테스트 광고와 발생 시각을 담당자에게 알려 주세요. 설치형 시험 범위는 참여까지입니다.
포스트백이 오지 않음	콘솔의 콜백 상태(미등록·허용 대기)를 보고, 완료하기 전에 콜백 URL 을 등록했는지 확인합니다.
SDK 화면에 STAGING 표식이 없음	광고 목록·상세처럼 표식이 제공되는 화면에서 확인합니다. Android 매체 웹뷰 브리지와 iOS 랜딩에는 표식이 없을 수 있습니다. 초기화 환경 인자·SDK 로그·실제 요청 주소가 스테이징인지 함께 확인하고, 환경 인자 없는 초기화가 뒤에 다시 불리지 않았는지 봅니다.

스테이징의 한계

스테이징은 가용성을 약속하지 않습니다. 장애 알림·구독이 없고 예고 없이 중단될 수 있습니다.
미션형 광고는 스테이징에서 목록·상세·참여까지만 됩니다. 미션 제출과 검수는 시험할 수 없습니다.
앱 밖 브라우저(모바일 웹·PC 웹) 지면은 이 연동의 범위가 아닙니다. 현재는 앱 안에서 Android 또는 iOS SDK 로 연동합니다. 서버 API 가이드는 준비 중입니다.
설치형 광고는 설치할 실제 앱이 없습니다. SDK 방식에서는 참여까지만 확인합니다.