ADPICK Campaign List API
1. API 설명
- 아래 json API로 현재 진행중인 캠페인 목록을 가져와 자신이 가진 앱이나 웹서비스에 자동으로 노출할 수 있습니다.
- 조회된 데이터로 자유롭게 자신만의 광고를 꾸며보세요.
2. 요청 파라미터 설명
- affid : 회원 아이디 (필수)
- os : ios (iOS 캠페인) 또는 android (Android 캠페인) [생략가능, 생략한 경우 API가 호출된 OS기기에 맞는 캠페인이 자동조회]
- adtype : CPI (설치형) 또는 CPA (가입형,이벤트형,사전예약) [생략가능, 생략한 경우 전체 캠페인]
- category : game (게임앱) 또는 notgame (비게임앱) [생략가능, 생략한 경우 전체 캠페인]
- order : rand (랜덤 순서) 또는 randone (랜덤으로 1개의 캠페인) [생략가능, 생략한 경우 최신순]
3. 주요 응답 데이터 설명
- - apOffer : 캠페인 코드
- - apType : 캠페인 종류 (1 : 앱설치형, 3 : 가입형, 4 : 이벤트형, 16 : 사전예약)
- - apCategory : 캠페인 카테고리 (1 : 게임, 2 : 쇼핑, 3 : 교육, 4 : 생활, 5 : 웹툰)
- - apPackage : Android 캠페인 구글플레이 패키지명
- - apItemid : iOS 캠페인 앱스토어 아이템 아이디
- - apAppTitle : 앱명
- - apHeadline : 한 줄 설명
- - apVideo : 동영상 소재
- - apDailyCap : 데일리 캡 (0 : 제한없음)
- - apRemain : 오늘 남은 수
- - apOS : 캠페인 OS (Both : Android, iOS 모두 가능)
- - apAppPromoText : 홍보문구
- - apKPI : 미정산 조건
- - apPartner : 지정 회원 캠페인
- - apImages : 사이즈별 홍보이미지
- - apTrackingLink : 캠페인 트랙킹(클릭) 링크
- - apHook : TUNE, Appsflyer 트래커를 사용하는 앱
- - apEvent : 리텐션 추적이 가능한 캠페인
API 예제 URL의 응답 데이터
-
[ { "apOffer": "e4cb7", "apType": "1", "apCategory": "2", "apPackage": "kr.co.autopass", "apItemid": "1662330552", "apAppTitle": "화물차리스 전문 화물박사 - 1톤트럭, 특장차 즉시출고", "apHeadline": "화물차 리스 전문 화물박사", "apVideo": "", "apDailyCap": "0", "apRemain": 296, "apOS": "Both", "apAppPromoText": "", "apPartner": "", "apImages": { "icon": "https://play-lh.googleusercontent.com/uGoGyRmfV6XlIXvqdFZ1B6ufHyUm0a1onrSbVT1UQHbrl1t5eNW6StYyHh6mGGdclqY", "icon57": "https://img.podgate.com/i/57&https://play-lh.googleusercontent.com/uGoGyRmfV6XlIXvqdFZ1B6ufHyUm0a1onrSbVT1UQHbrl1t5eNW6StYyHh6mGGdclqY", "icon114": "https://img.podgate.com/i/114&https://play-lh.googleusercontent.com/uGoGyRmfV6XlIXvqdFZ1B6ufHyUm0a1onrSbVT1UQHbrl1t5eNW6StYyHh6mGGdclqY", "icon256": "https://play-lh.googleusercontent.com/uGoGyRmfV6XlIXvqdFZ1B6ufHyUm0a1onrSbVT1UQHbrl1t5eNW6StYyHh6mGGdclqY", "banner640x100": "", "banner640x960": "", "banner960x640": "", "banner640x640": "", "banner1024x500": "https://s3.ap-northeast-2.amazonaws.com/oddm.img/2024/18474ba71f1712027552.jpg" }, "apTrackingLink": "https://deg.kr/6f36c7e", "apKPI": "", "apHook": "false", "apEvent": "true" } ]
4. 주의사항
- API는 별도의 DB나 파일로 주기적으로 저장하여 사용해야하며, 최대 1분에 1회 이하로 호출해야합니다.
- API의 과도한 호출 시에는 사용에 제한이 있을 수 있습니다.