로딩중입니다
애드팝콘 SDK 자가 검증 가이드 (Android)
12/13/2017 11:34:25 AM

애드팝콘 오퍼월 검증 안내

애드팝콘 오퍼월 서비스는 반드시 검증을 받아야 하는 서비스입니다.

매체 검증에서는 오퍼월이 적절하게 노출되는지, 광고 참여 후 보상이 정상적으로 지급처리되고, 유저가 이를 즉각 확인할 수 있는 지를 중점적으로 검증합니다.


검증 주의 사항

  1. 검증 결과는 48시간안에 받아보실 수 있습니다.(근무일 기준)
  2. 검증 결과서는 회원가입할 때 입력한 이메일 주소로 전달 됩니다.
  3. 검증에 소요되는 시간을 줄이기 위해 최대한 자세하게 신청서를 작성 부탁 드립니다.
  4. 검증 체크리스트를 확인하시면 검수 반려 가능성이 줄어듭니다.
  5. 검증 결과는 검증을 신청한 이메일 계정으로 전달 됩니다.
  6. 마켓 업로드가 되기 전에 반드시 검증 과정을 거쳐야 합니다.

자가 검증 준비사항

adPOPCorn SDK 를 연동한 앱이 설치된 안드로이드 기기를 PC 에 연결합니다.

안드로이드 스튜디오 내에 탑제된 LogCat 혹은 안드로이드 기기 로그를 볼 수 있는 프로그램을 실행합니다.

실행 후 SDK 와 관련된 로그를 확인 할 수 있도록 tag 란에 "IGAW_QA" 입력합니다.




IgawCommon 자가 검증

단순 리워드를 제공하는 충전소 앱을 제외하고는 아래와 같이 IgawCommon SDK가 연동이 되어야 합니다.

IgawCommon 은 앱의 실행 횟수 및 DAU 그리고 앱 종료시 SDK 에서 수집한 데이터의 전송을 담당하는 SDK 입니다.

이를 위해 연동하신 앱에 앱 실행을 확인하는 IgawCommon.startSession API 와 

앱 종료를 확인하는 IgawCommon.endSession API 가 연동되어 있는지 확인해야 합니다.


IgawCommon.startSession API앱 설치 후 최초 실행 시 아래 로그가 나오는지 확인합니다.
IGAW_QA adbrix version : "현재 적용중인 SDK 버전" 
IGAW_QA common version : "현재 적용중인 SDK 버전"
ADBrixManager > startSession() : stack_count : 0


이후 앱이 onPause 에서 onResume 로 전환 시 (혹은 액티비티 전환 시)

아래와 같이 IgawCommon.startSession API 가 호출됩니다.

IGAW_QA ADBrixManager > startSession() : stack_count :0
IGAW_QA OnstartSession deeplink : bundle and data are null IGAW_QA channel_type : 1


IgawCommon.endSession API

앱 종료시 IgawCommon.endSession API 가 호출되는지 확인합니다.

IgawCommon.endSession 은 전원 버튼으로 기기 정지시, 홈버튼으로 앱 전환시, 뒤로가기 버튼으로 앱 종료시 

아래와 같이 호출되는지 확인합니다.

IGAW_QA endSession : stack_count : 1
IGAW_QA ADBrixManager > activity : session / start / session / end / 3988 / 20171205120850 IGAW_QA IGAW_QA ADBrixManager > Schedule check start : is schedule exist = true


위 API 가 정상적으로 호출되지 않는다면....

IgawCommon.startSession / IgawCommon.endSession 이 각 상황별로 정상적으로 호출되지 않는다면

아래 첨부된 연동가이드에 따라 각 API가 연동되어 있는지 확인을 부탁드립니다.

[IGAW 공통연동 : 안드로이드]

[IGAW 공통연동 : 유니티 안드로이드]



adPOPCorn 자가 검증

adPOPCorn SDK는 모바일 애드 네트워크로서 모바일 앱에 광고수익을 제공하는 솔루션입니다.

애드팝콘에 대한 서비스 소개나 이용방법 안내는 아래 아티클에서 확인하실 수 있습니다.

[애드팝콘 서비스 안내]


유저식별값 호출

adPOPCorn을 이용하기 위해서는 각 유저마다 고유한 유저 식별 값을 갖도록 연동이 되어야 합니다.

adPOPCorn Offerwall에 진입 하기 전 아래와 같이 restore USN이 호출 되는 것인지 확인합니다.

IGAW_QA restoreUsn : "설정한 유저식별값"

Caution!!유저식별값의 경우 내부 정책 상 유저의 개인 정보가 포함 되어서는 안됩니다(이름 , 전화번호 , 회원ID, 이메일, IMEI)

Caution!!유저식별값의 경우 반드시 애드팝콘 오퍼월에 진입 하기 전 설정 되어야 합니다.

Caution!!유저식별값의 경우 유저마다 고유한 값을 갖도록 설정 되어야 하며 값이 변경 되어서는 안됩니다.


광고리스트 정상 노출

adPOPCorn을 이용하기 위해서는 광고리스트의 필수 아이콘이 정상적으로 노출 되어야 합니다.

adPOPCorn Offerwall 광고리스트가 정상적으로 노출 되고 있는지 확인 합니다.

  • (1) 플러스락 기능을 사용할 경우에만 노출 (pluslock.jar 파일 포함 시 노출 되며 현재는 지원 하고 있지 않음)
  • (2) 유저 CS 창구 및 지급된 리워드를 확인할 수 있는 메뉴
  • (3) 개인정보보호정책 관련 안내사항 메뉴

Caution!! res 파일 내에 이미지 파일이 누락 되어 있을 경우 필수 아이콘(2,3)이 노출 되지 않아 반려사유가 됩니다.

리워드 지급 확인

adPOPCorn을 이용하기 위해서는 광고를 참여한 후 참여한 유저에게 리워드가 정상 지급 되어야 합니다.

adPOPCorn Offerwall을 통하여 광고 참여 후 리워드가 정상 지급 되는지 확인합니다.


Caution!! "지급내역" 메뉴를 통하여 실제 리워드 지급 여부가 확인 되어야 합니다.

Caution!! "지급내역" 메뉴에 리워드 지급이 확인 되지만 실제 앱 내 리워드가 지급 되지 않을 경우 반려사유가 됩니다.


현금성 리워드 매체

현금성 리워드 매체의 경우 일부 악성 사용자들의 어뷰징을 사연에 방지하고자 아래와 같은 추가 연동이 필요합니다.

현금성 리워드 매체란 adPOPCorn Offerwall을 통하여 지급 받은 리워드로 아래와 같은 현물 상품으로 교환이 가능한 매체입니다.

  1. 현금 출금
  2. 문화 상품권
  3. 기프티콘
  4. 게임 혹은 기타 서비스에서 사용 가능한 캐시 아이템


필수 애드온 설치 및 adPOPCorn PUID 수집 API 추가

현금성 리워드 매체의 경우 adPOPCorn 에서 제공하는 필수 애드온 설치 및 adPOPCorn PUID 수집 API가 추가 되어야 합니다.

현금성 리워드 매체의 경우 adPOPCorn Offerwall 진입 전 아래와 같은 로그가 호출 되는지 확인합니다.

IGAW_QA setCashRewardAppFlag : true

Caution!! adPOPCorn PUID 수집 API는 반드시 Offerwall 진입 전 호출 되어야 합니다.

Caution!! 현금성 리워드 매체의 경우 회원가입절차에 인증 절차가 포함되어 있는 가입 절차가 아닐 경우 반려 사유가 됩니다


뷰 타입 매체

뷰 타입 매체의 경우 별도의 레이아웃을 생성하여 adPOPCorn Offerwall을 이용하는 서비스 입니다.

뷰 타입 매체의 경우 노출 카운트를 수집하기 위한 추가 연동이 필요합니다.

노출 카운트 수집 API가 추가 되었다면 adPOPCorn Offerwall 진입 전 아래와 같은 로그가 호출 되는지 확인합니다.

IGAW_QA Called ViewType Offerwall Impression


매체 검증 신청

셀프 검수가 완료되시면, [adPOPcorn Offerwall -> OfferWall 관리 -> 검수 및 최적화] 메뉴에서 검수를 신청합니다.

검수신청버튼은 실제 앱에서 테스트 광고를 참여완료한 이력이 조회될 때에만 활성화됩니다.

테스트 광고는 검수 및 최적화 항목에서 테스트디바이스를 설정 하시게 되면 노출 됩니다.


신청서 작성 요령

아래 작성 예시와 같이 검수 신청서를 작성하여 매체 검수를 신청합니다.

각 항목을 자세하게 작성할수록 검수에 소요되는 시간은 줄어듭니다.


1) adPOPcorn 충전소 버튼 위치

- 광고리스트 진입 방법을 작성합니다.

(ex : 로그인 후 메인 화면 좌측 상단 "무료 충전"버튼 클릭)


2) 지급받은 포인트 확인 방법

- 광고리스트에서 광고 참여 후 받은 리워드를 확인하는 방법을 작성합니다.

(ex : 광고리스트에서 빠져 나온 후 우측 상단 보석 숫자가 증가함)


3) 추가 검수 사항

- 검수 시 추가적인 요청사항을 작성합니다.

(ex : adbrix 도 추가로 연동 하였습니다. 정상적으로 연동 되었는지 확인 부탁 드립니다)


4) 다운로드 링크

- SDK가 연동된 바이너리 파일 (apk , ipa) 을 다운로드 받을 수 있는 URL을 입력 합니다. 직접 파일을 보내시려면 QA@igaworks.com 으로 보내주시길 부탁 드립니다. (검수 가능한 ipa 파일 세팅은 아래 iOS 매체 검수를 통해 확인해주세요.)


5) 검수 반려

- 검수가 반려 되었을 경우 반려사항이 수정된 apk 혹은 ipa 파일을 QA@igaworks.com 으로 보내주시길 부탁 드립니다.

[검수신청서 예시화면]


※ 이용에 불편한 점 혹은 검수에 궁금한 부분이 있으시다면 아래 메일로 연락 부탁 드립니다. ※

검수 문의 | IGAWorks 연동QA (QA@igaworks.com)

기술 문의 | IGAWorks 기술지원 (tech_support@igaworks.com)