1.
Click_key = gpkey
•
유저가 캠페인을 클릭할때마다 새로 생성되는 고유값, 해당 값 기준으로 유저에게 리워드를 지급하고 있음 , 즉 같은 유저가 참여해도 캠페인 클릭때마다 다르게 부여되는 값
2.
App_uid
•
유저마다 고유하게 부여되는 유저 식별값
3.
ad_channel_id : 그린피 앱/채널을 구분하는 고유 id
>> 그린피 앱/채널을 식별하기 위한 값으로, 해당 값을 포함해야 그린피에 매핑된 광고 리스트 조회 가능
3.
블랙리스트 (원치 않는 광고 제외) 등록 방법
•
Network API로 연동하는 경우, 광고 리스트를 내려주니까 제외하고 오픈
•
SDK로 연동하는 경우 운영팀에서 해당 매체에 광고를 OFF 하면 됨
4.
PostBack Parameter 관련 문의 건
•
Custom 1 빈값으로 들어오는건 설정이 가능한걸지?
>> 클릭 API 호출 시점에 Custom1 파라미터 명으로 값을 같이 넘겨주셔야 포스트백 시점에 돌려받을 수 있음
•
포스트백 URL로 리워드 전문을 보내줄때 POST 방식에서 기본은 어떤 포맷으로 데이터 송신해주는지
>> 설정한 값들은 POSTFIELDS에 담아서 전달하고 있습니다.
5.
Callback ip : 어떤 과정 중에 사용되는 값일지?
•
화이트 리스트 처리를 위해 사용되는 필드이며, 현재는 없어도 통신에 문제가 없기 때문에, 원하지 않으면 셋팅 안해도 됨
6.
API 연동 관련 문의
7.
광고를 카테고리 분류, 광고주 분류 등 다양한 방법으로 정렬 및 필터링을 하고싶은데 방법이 있을지?
•
카테고리 분류는 제공되고 있으며, 제공된 API 가이드 참고
•
API 연동 가이드에 기입된 데이터 외에 추가적으로 수집하는 정보는 없음
8.
Request Parameter 관련 문의 건
•
ads_sub_cate 와 ssm_idx 다른점이 무엇인가요?
>>ads_sub_cate : 당사가 지정 해놓은 카테고리 분류 묶음 > 광고 분류 (참여형, SNS 구독형 등 분류 가능)
>>ssm_idx : 원하시는 분류를 직접 커스텀 하고 싶으신 경우 사용
9.
Type은 int인데 Json 포맷으로 요청을 보내면 되는걸까요?
- 타입은 무조건 int로 보내지 않으셔도 됩니다.
10.
클릭로그 결과값 관련
•
클릭로그의 제휴사
>> 그린피가 직광고 랜딩 URL에 랜딩 하겠다를 의미, 그린피가 이런 값을 넣어서 랜딩하겠다는 뜻 *제휴사에서 주는 응답값이 아님
•
클릭로그의 결과
>> 직광고 랜딩URL에 그린피에서 수집한 데이터들을 넣어서 정상적으로 랜딩 URL로 랜딩되면 “S” 발생
즉 제휴사가 우리에게 응답해준 값 S: 너희 랜딩 잘됐어
11.
만약 ADID/IDFA 수집이 어렵다면
•
ADID/IDFA 수집 불가하다는 내용과 함께 귀사에서 별도로 유저에게 부여한 고유 식별값을 저희에게 전달주시면 됩니다.
(내부적으로 app_uid 라 부르고 있습니다)
•
app_uid만 있어도 참여 가능한 캠페인은 아래와 같습니다.1. 구독형 캠페인(유튜브, 인스타그램, 네이버 플레이스 캠페인 등)
2. app_uid만 있어도 참여 가능한 일부 캠페인(일부 게임 캠페인은 진행 가능합니다)
•
API 연동 시 귀사에서 노출 구좌에 광고 On/Off, CS 처리, UI 구성 모두 진행하셔야 하며, 리워드 캠페인(그린피가 제공하는 캠페인)의 경우 실시간으로 On/Off 되는 특징이 있는 점 참고 부탁드립니다. (API 호출 주기는 5분 내외로 진행하시는 것을 추천드립니다.
12.
Admin Web
•
SDK 연동 시 매체 어드민에서 대메뉴 정렬 조정 가능 , 별도 메뉴얼은 없음
13.
광고 목록 호출 주기
•
API 연동 시 5분-10분 주기로 API 리스트 호출하는 것을 권장
14.
grp_key 값은 유니크한 값일지?
•
유니크한 값이 맞고 길이제한은 64자로 확인 (변동 가능성 있으므로 cost는 여유있게 잡길 부탁)
15.
grp_key 생성 규칙
•
grp_key 생성 규칙은 영문+숫자로 이루어진 64자리 string
•
따로 공백이나 특수문자는 사용되지 않음
16.
광고를 카테고리 분류, 광고주 분류 등 다양한 방법으로 정렬 및 필터링 하고싶다, 가능할지?
•
ads_sub_cate" 로 광고 분류(참여형/SNS 구독형 등) 가능
•
다만 광고마다 금융, 게임, 음식, 부동산, 의류 등 업종에 관한 정보로 분류를 하고싶다 가능할지?
•
업종에 대한 정보값은 API로 공유하고 있지 않음 / 원하는 업종 카테고리를 말해주면 그린피 측에서 매체 필터링하여 내려드릴 수 있음.
17.
grp_key 값이란 ?
•
그린피에서 클릭이 발생했을 때 생성한 유니크한 키값으로 광고주 랜딩페이지 뒤에 자동으로 붙여서 가는 값
18.
appcode : 발급된 매체 코드
19.
에러코드
S : 성공
E1 : 참여 대상 아님
E2 : 잘못된 접근
E3 : 종료된 이벤트
E4 : 금일 참여가 마감
E5 : 이미 참여했던 이벤트
E6 : 다른 경로로 참여했던 이벤트
E7 : 광고 접속에 실패
E8 : 제휴사로부터 응답요청이 지연
E9 : 설치한 내역이 존재
E10 : 진행 중 이지 않은 광고
E16 : 시간캡이 설정된 광고
E100 : 기타
E101 : 상품정보가 없습니다.
E103 : 필수정보 부족
E104 : OS 타입이 다릅니다.
E105 : 제출한 미션이 검토중으로 적립 대기중입니다.
E106: 참여 이력이 존재하지 않습니다.
E108 : 당일 참여하실 수 있는 광고 개수가 마감되었습니다.
E109: 같은 업체의 미션을 다른 프로세스로 이미 참여하였습니다.
20.
S2S 연동 방식
서버 투 서버 연동 방식
그린피 오퍼월 통해 캠페인 참여할때마다 그린피가 grp_key 값을 생성하여 전달
해당 값을 광고주 쿠기 또는 세션에 저장한 후 , 회원가입(포백)이 완료되면 저장한 grp_key 값과 크로스체크할 수 있는 키값 포함하여 포스트백을 전송 줌
이때 cps 상품의 경우, etc1 . cost, type 값도 같이 전달 가능유무ㅡ 확인
ㄴ 광고주 전환수 vc 그린피 전환수 차이가 날 수 있는 상황을 대비해 매칭을 위해서 위 3개 파라미터 값도 달라고 함
[S2S 연동]
•
grp_key : 클릭키 값
•
gp_key : 전환키 값(transaction)
포스트백 url 전달 주면서, 끝에다가 gp_key 값 포함해서 달라고 해야 함
ㄴ 포스트백 예시 url은 매체사 > 매체 > 연동 에서 Postback URL 확인