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

애드팝콘 오퍼월 검증 안내

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

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


검증 주의 사항

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

자가 검증 준비사항

adPOPCorn SDK 를 연동한 앱이 설치된 아이폰 기기를 Mac 에 연결합니다.

SDK 연동시 모든 로그가 보여지는 코드 [IgaworksCore setLogLevel : IgaworksCoreLogTrace]; 추가되어 있어야 합니다. 


xcode 메뉴 내 Window -> Devices and Simulators 로 들어가 해당 기기의 로그를 확인합니다.


IgawCore 자가 검증

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

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

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

  

IgawCore.startSession API

앱 설치 후 최초 실행 시 아래 로그가 나오는지 확인합니다.

checksum = init;
k = "현재 연동중이신 앱키";
language = ko;


이후 앱이 Background 에서 onResume 로 전환 시 (액티비티 전환 시) 아래와 같이 IgawCore.startSession API 가 호출됩니다. 

activityGroupName : session, activityName : start


IgawCore.endSession API

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

IgawCore.endSession 은 전원 버튼으로 기기 정지시, 홈버튼으로 앱 전환시 아래와 같이 호출되어야 합니다.

activityGroupName : session, activityName : end


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

IgawCore.startSession / IgawCore.endSession 이 각 상황별로 정상적으로 호출되지 않는다면 아래 첨부된

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

[IGAW 공통연동 : iOS]

[IGAW 공통연동 : 유니티 iOS]


IgawadPOPCorn 자가 검증


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

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

[애드팝콘 서비스 안내]


유저식별값 호출

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

adPOPCorn Offerwall에 진입 하기 전 아래와 같은 코드가 노출 되는 것인지 확인 합니다.

AdPopcornOfferwall.framework Version : "현재 연동중인 버전"
appKey : "현재 연동중인 앱키"
hash key : "현재 연동중인 해시키"

userSerialNumber : "설정하신 유저 식별값 정보

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

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

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


광고리스트 정상 노출

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

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



리워드 지급 확인

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

adPOPCorn Offerwall 고객센터 메뉴에서 지급내역을 통하여 광고 참여 후 리워드가 정상 지급 되는지 확인합니다.


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

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


매체 검증 신청

셀프 검수가 완료되시면, [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 으로 보내주시길 부탁 드립니다.

[검수신청서 예시화면]


UDID 등록 


iOS 검수 요청 시 IGAWORKS QA팀에서 사용하는 테스트기기를 등록해 주신 후 ipa파일을 전달해 주셔야 합니다.
아래 UDID 목록을 확인하셔서 최소 1대 , 가능하면 3대의 디바이스 모두 등록하신 후 검수 요청을 부탁 드립니다.


순위 이름 UDID
1 IGAWORKS i-Pod Touch 5
e18219fcd6561c79b4218a636484b798aa4390ae
2 IGAWORKS i-Phone 6
2118b638dfbeb7c720328f7f844cb0b2ccf75dc2
3 IGAWORKS i-Phone 4
4775b58641a16c62f043555b2e77cf379d3f0959
4 IGAWORKS i-Pad 2
798403e1954e342cad1d2d3abffb15c5ff0f4e90

UDID 등록을 통한 검증 파일 제공 방법


https://developer.apple.com/ 링크를 클릭 하여 개발자 계정에 접속 합니다.
Certificates, Identifiers & Profiles로 이동 합니다.  

아래 스크린샷과 같이 All 메뉴를 클릭 합니다.


아래 스크린샷과 같이 + 버튼을 클릭 합니다.


테스트 디바이스의 이름과 UDID를 등록한 후 Continue 버튼을 클릭 합니다.



아래 스크린샷과 같이 All 버튼을 클릭 합니다.



전달해주실 프로젝트의 provisioning profile을 선택하시고 edit를 클릭 합니다.

아래 스크린샷 화면과 같이 이전에 등록한 테스트 디바이스 정보의 우측 체크박스를 체크 후

Generate 버튼을 클릭 하여 provisioning profile을 생성 합니다.

생성된 provisioning profile을 통하여 ipa 파일을 생성 후 ipa 파일을 qa@igaworks.com 으로 전달 합니다.



TestFlight를 통한 검증 파일 제공 방법


테스트를 진행 할 Binary 파일을 Apple에 Upload 합니다.
https://itunesconnect.apple.com/ 사이트에 접속 하여 개발자 계정으로 로그인 합니다.  
아래 보이는 나의 앱 페이지에서 TestFlight를 제공할 앱을 선택 합니다.

TestFlight 검수 진행 시 테스트를 진행하기 위한 앱이 준비 되어 있어야 합니다.

TestFlight의 외부 테스터를 선택하여 Igaworks tester email 주소를 추가 합니다.(email = tech_support@igaworks.com)



테스트가 가능 하도록 빌드를 아래 스크린샷과 같이 추가 합니다.(심사가 대기중이라면 심사 완료 후 테스트가 가능 합니다)



베타 버전의 심사가 완료 되고 테스트 메일을 보내 주시면 TestFlight를 통하여 테스트가 가능 합니다.

(애플에서 전달온 리딤코드를 이용하여 테스트가 가능하게 됩니다)


iOS 검증 주의사항


미디에이션 광고가 활성화 되어 앱 광고가 노출될 경우 Apple 측 검증에서 반려되는 경우가 있습니다.

그러므로 Apple 측 검증이 통과될 때까지 미디에이션 광고는 모두 Off 로 설정 부탁 드립니다.


1. 검증 요청을 주시기 전 미디에이션 광고의 상태를 모두 Off 로 설정 해 주시길 부탁 드립니다.

2. Apple 측 검증이 끝나기 전 까지 회원가입형의 일부 광고만 라이브를 하고 있습니다. Apple 측 검증이 모두 완료된 후 저희에게 내용을 전달해 주시면 나머지 광고 모두 라이브 진행하도록 하겠습니다.


3. iOS 앱 업데이트 및 재 심사 과정시에도 위와 같은 절차를 모두 지켜주시길 부탁 드립니다.


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

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

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