Search

API

1. 참고 사항

2. Version History

Search
생성 일자
태그
담당자

3. API 연동

1) 캠페인 리스트

https://api.greenp.kr/ads_json.html
1-1) Content Type
content-type=text/html;charset=UTF-8
1-2) Response Format
Output : JSON
{‘rst’: ...}
1-3) Request Parameter Information
HTTP Method : - POST, GET
Search
Param
Type
Size
Desc
string
20
발급된 매체코드
int
페이지수
int
페이지당 리스트수(default: 500)
1-4) Response Data
Search
Param
Type
Desc
string
캠페인키
string
캠페인명
string
패키지명
string
캠페인 재 참여 가능 여부 (Y: 재 참여 가능, N: 재 참여 불가)
string
캠페인 아이콘 (썸네일) 이미지
string
캠페인 피드형 이미지 (720x360)
string
캠페인 참여 조건
string
캠페인설명
int
리워드금액
string
OS구분(A: AOS, I: IOS , W: WEB, ALL: 모두)
int
광고형식(1: CPI, 2: CPE, 3: CPA, 4: CPS, 6: CPC, 7: CPSNS, 8: 뉴스 피드 적립형)
string
광고서브형식 - 7번 CPSNS에만 해당 (L: 유튜브 좋아요, Y: 유튜브 구독, I: 인스타 팔로우,F: 페이스북 좋아요, K: 카카오플러스 친구, N: 네이버스토어 찜, P: 네이버상품 찜, Q: 네이버 포스트 팔로우, C: 네이버 채널 구독, T: 트위터 팔로우, D: 틱톡 팔로우, E: 네이버 플레이스 저장, M: 멜론 음원듣기, Z: 기타)
string
클릭 URL (캠페인참여 url )

2) 캠페인 참여

2-1) Content Type
content-type=text/html;charset=UTF-8
2-2) Response Format
Output : JSON
{‘rst’: ...}
2-3) Request Parameter Information
HTTP Method : - POST, GET
Search
Param
Type
Size
Desc
string
40
(기본포함) 발급된 캠페인코드
string
10
(기본포함) 발급된 매체코드
string
40
매체 파트너 고유아이디
string
40
구글광고 아이디 (안드로이드일 경우만) AdvertisingIdClient.Info idInfo = null; idInfo = AdvertisingIdClient.getAdvertisingIdInfo(mContext); return idInfo.getId();
string
40
iOS 고유 식별자(IOS일 경우만)
string
20
디바이스 아이디 TelephonyManager mngr = (TelephonyManager)mContext.getSystemService(Context.TELEPHONY_SERVICE); return mngr.getDeviceId();
string
100
구글 계정 SHA1로 인코딩 한것을 다중일 경우 , 로 연결하여 주세요 Account[] accounts = AccountManager.get(mContext).getAccounts();
string
40
안드로이드 아이디 return Settings.Secure.getString(mContext.getContentResolver(), Settings.Secure.ANDROID_ID);
string
40
브랜드 return Build.BRAND;
string
40
모델 return Build.MODEL;
string
20
사용자 IP
string
255
매체용 추가정보 (매체 uniq 클릭값등)
string
1
y : 바로 이동 , 변수가 없을경우 기존 json 리턴함
2-4) Response Data
Search
Param
Type
Desc
string
S : 성공 E1 : 참여 대상 아님 E2 : 잘못된 접근 E3 : 종료된 이벤트 E4 : 금일 참여가 마감 E5 : 이미 참여했던 이벤트 E6 : 사용 안 함 E7 : 광고 접속에 실패 E8 : 제휴사로부터 응답요청이 지연 E9 : 설치한 내역이 존재 E10 : 진행 중이지 않은 광고 E100 : 기타 E101 : 상품정보가 없습니다. E103 : 필수 정보 부족 E104 : OS 타입이 다릅니다. E105 : 제출한 미션이 검토중으로 적립 대기중입니다.
string
참여 랜딩 url
string
에러메세지

3) 패키지 설치 알림 (CPI 경우)

3-1) Content Type
content-type=text/html;charset=UTF-8
3-2) Response Format
Output : JSON
{‘rst’: ...}
3-3) Request Parameter Information
HTTP Method : - POST, GET
Search
Param
Type
Size
Desc
string
40
발급된 캠페인코드
string
40
설치된 패키지명
string
10
발급된 매체코드
string
40
매체별 유저 고유 식별값
string
40
구글광고 아이디 AdvertisingIdClient.Info idInfo = null; idInfo = AdvertisingIdClient.getAdvertisingIdInfo(mContext); return idInfo.getId();
string
40
iOS 고유 식별자(IOS일 경우만)
string
20
디바이스 아이디 TelephonyManager mngr = (TelephonyManager)mContext.getSystemService(Context.TELEPHONY_SERVICE); return mngr.getDeviceId();
string
100
구글 계정 SHA1로 인코딩 한것을 다중일 경우 , 로 연결하여 주세요 Account[] accounts = AccountManager.get(mContext).getAccounts();
string
40
안드로이드 아이디 return Settings.Secure.getString(mContext.getContentResolver(), Settings.Secure.ANDROID_ID);
string
40
브랜드 return Build.BRAND;
string
40
모델 return Build.MODEL;
string
20
사용자 IP
3-4) Response Data
Search
Param
Type
Desc
string
결과 (S: 성공,E*: 에러) E1 : 참여 대상 아님 E2 : 잘못된 접근 E3 : 종료된 이벤트 E4 : 금일 참여가 마감 E5 : 이미 참여했던 이벤트 E6 : 다른 경로로 참여했던 이벤트 E7 : 광고 접속에 실패 E8 : 제휴사로부터 응답요청이 지연 E9 : 설치한 내역이 존재 E10 : 진행 중 이지 않은 광고 E100 : 기타 E101 : 상품정보가 없습니다. E102 : CPI 상품이 아닙니다. E103 : 필수 정보 부족 E104 : OS 타입이 다릅니다.
string
에러메세지

4) 참여완료 Callback

http://매체사 callback
4-1) Content Type
content-type=text/html;charset=UTF-8
4-2) Send Parameter Information
HTTP Method : - GET, POST, POST(JSON)
매체 어드민에서 설정하실 수 있습니다.
param : 전송받으실 포스트백 변수를 설정 가능
Search
Param
Macro
Type
Desc
{ads_idx}
int
광고번호
{ads_type}
int
광고형식(1: CPI, 2: CPE, 3: CPA, 4: CPS, 6: CPC, 7: CPSNS, 8: 뉴스 피드 적립형)
{ads_name}
string
광고명
{rwd_cost}
int
리워드금액
{etc}
string
매체용 추가정보 (매체 uniq 클릭값 등)
{app_uid}
string
매체사에서 보낸 app_uid 값
{gp_key}
string
그린피 전환키 값
{rwd_date}
date
전환일자(0000-00-00 00:00:00)
{adid_or_idfa}
string
adid or idfa
{ads_re_participate}
string
Y: 중복지급가능 N: 중복지급불가

5) 유저 참여 광고 목록

5-1) Content Type
content-type=text/html;charset=UTF-8
5-2) Request Parameter Information
HTTP Method : - POST, GET
Search
Param
Type
Size
Desc
string
20
발급된 매체코드
string
40
매체 파트너 고유아이디
string
40
구글광고 아이디
string
40
iOS 고유 식별자(IOS일 경우만)
date
0000-00-00(default: 오늘 날짜)
date
0000-00-00(default: 오늘 날짜)
5-3) Response Format
Output : JSON
{ "rst": "S", "msg": "", "data": [ { "ads_idx": 32049, "ads_name": "쿠팡 방문하기" }, { "ads_idx": 26079, "ads_name": "스포키 프로야구 생중계 (보러가기/Visit)" } ] }
5-4) Response Data
Search
Param
Type
Desc
string
S : 성공 E100 : 기타 E103 : 필수 정보 부족 E107: 등록되지 않은 매체입니다.
string
에러메세지
string
ads_idx : 광고번호 ads_name : 광고명

6) CS 문의하기

Search
url
method
enctype
6-1) Request Parameter Information
HTTP Method : - GET, POST
Search
Param
Type
Size
Desc
string
20
발급된 매체코드
string
40
매체 파트너 고유아이디
string
40
구글광고 아이디
string
40
iOS 고유 식별자(IOS일 경우만)
int
11
광고번호
int
11
문의유형(1: 광고적립문의, 2: 기타문의)
string
255
cs 내용
string
14
연락처
string
100
이메일
string
50
성명
첨부파일
6-2) Response Format
Output : JSON
{ "rst": "S", "msg": "CS 문의가 등록되었습니다.", "idx": 123, } { "rst": "E100", "msg": "CS 문의가 등록에 실패하였습니다. 고객센터로 문의해주세요.” }
6-3) Response Data
Search
Param
Type
Desc
string
S : 성공 E100 : 기타
string
에러메세지
int
문의번호

7) CS 문의 리스트

7-1) Request Parameter Information
HTTP Method : - GET, POST
Search
Param
Type
Size
Desc
string
20
발급된 매체코드
string
40
매체 파트너 고유아이디
string
40
구글광고 아이디
string
40
iOS 고유 식별자(IOS일 경우만)
date
0000-00-00(default: 오늘 날짜)
date
0000-00-00(default: 오늘 날짜)
7-2) Response Format
Output : JSON
{ "rst": "0", "msg": "", "data": [ { "q_idx": "2059", "ads_idx": "32049", "ads_name": "쿠팡 방문하기", "ads_icon_img": "https://img.greenp.kr/cpi/16830989809977.png", "ads_summary": "[참여방법] \r\\n\"쿠팡\" 에 방문하고 리워드를 적립 받으세요.\r\\n\r\\n[앱 설명]\r\\n- 밤 12시 전까지 주문, 다음날 로켓배송\r\\n- 와우멤버십 회원은 무조건 무료배송\r\\n- 모든 신선식품 8시간 내 배송, 로켓프레시\r\\n- 할인 또 할인, 와우멤버십 추가 할인\r\\n- 믿을 수 있는 해외 쇼핑 쉽고 빠른 로켓 직구", "ads_reward_price": 360, "ads_price_type": "C", "app_uid": "media_user", "q_mobile": "01012345678", "q_name": "홍길동", "q_con": "[문의유형] 광고적립 문의\n[참여일] 2023-05-10 06:23:53\n[답변 이메일] hongildong@gmail.com\n[문의내용] 쿠방. 홈페이지 에 방문 했는데요 리워드 가 안되요", "q_regdate": "2023-04-04 17:29:26", "q_status": "R", "q_ans_con": "", "q_ansdate": "0000-00-00 00:00:00” } ] }
7-3) Response Data
Search
Param
Type
Desc
string
S : 성공 E100 : 기타
string
에러메세지
string
q_idx : 고유번호,  ads_idx : 광고번호, ads_name: 광고명,  ads_icon_img: 아이콘 이미지,  ads_summary: 캠페인설명,  ads_reward_price: 리워드금액,  ads_price_type: 포인트명 app_uid: 사용자ID,  q_mobile: 연락처,  q_name: 성명,  q_con: CS 내용, q_regdate: 등록일자,  q_status: 처리상태,  q_ans_con: CS 답변내용,  q_ansdate: CS 답변일자