제휴사(DSP) - 그린피 (SSP) 연동 시
1.
제휴사한테 API 연동 가이드 받기
2.
싱글 이벤트만 내려주는지 또는 멀티 이벤트도 같이 내려주는지 문의하기
** 멀티 이벤트도 내려준다면, 개발팀에 이벤트 포스트백도 달라고 요청해야 함
가이드를 받으면
3.
그린피 포스트백 URL 주면서 제휴사 캠페인 참여 시 그린피에서 생성한 클릭키를 포스트백 호출할때 함께 전달 가능할지 문의하기
** 클릭키는 유저가 캠페인 클릭할때마다 새로 생성되는 고유 값으로 해당 값 기준으로 유저에게 리워드 지급 하고 있음
** 멀티 미션 내려주면 포스트백 URL + 이벤트백 포스트백 URL 같이 주기 (이벤트 포스트백은 호출 시 evt_name 포함해서 호출함
개발팀에 요청할 내용
1.
그린피 어드민 제휴사에 00제휴사 생성 후
2.
제휴가 키 포함해서 대원과장님께 해당 제휴사에 보낼 포스트백 url 전달 부탁드립니다 라고 요청
3.
000한테 apo 연동 가이드 받으면, jira에 연동 요청글 올리기
Gree-x (DSP) → 그린피 한테 물량 주는 연동
Gree-x (DSP) × GreenP 연동 정리
1. 필요 서류
•
제휴사(Gree-x)는 그린피에게 API 연동 가이드 및 리워드 미디어 성과 측정 파트너십 사양서 전달 필요
•
사양서 발급용 Media API Key 필요 → GreenP 요청 완료
◦
Media API Key: 162ca37a-3e6a-433c-ba29-ced620da30fc
◦
연동가이드 및 API KEY 발급 요청
유저 매칭 방식 (GreenP 기준)
•
GreenP는 click_key 기준으로 유저 매칭하여 리워드를 지급
•
따라서 Gree-x 캠페인 참여 시 전달한 click_key를 리워드 지급 대상일 때 다시 포스트백 받을 수 있는지 확인 필요
•
추가로 그린피가 gree-x에, click_url에 어떤 파라미터 값으로 전달드리면 되고, 포스트백 시 어떤 파라미터 값으로 넘겨줄 수 있는지도 확인이 필요
•
gree-x : 그린피의 고유한 미디어 유저 id를 포함하여 세트로 보내길 요청
ex. http://www.example.com/click?media_user_id=xxxxxxxxxxxxxxxx
•
그린피 : 포스트백 시 어떤 파라미터 값으로 넘겨줄 수 있는지도 확인이 필요
ㄴ gree-x가 포스트백으로 회신 가능한 파라미터는 http request parameter list에 기재된 파라미터임
•
그린피 : 호출 시, ad_channer_id 값이 필요해 확인 요청 (그린피 → Gree-x)
>> ad channel id는 gfr90534576으로 설정 확인.
•
리워드 지급 대상에 대한 포스트백의 경우, 그린피 포스트백 주소를 드리면 그린피 포스트백 api를 호출해주는건지 문의
>> 성과(리워드 지급 대상) 발생 시 뿐만 아니라 기본적으로 모든 성과를 전송해드리는 바잇
또한 귀사(그린피)의 포스트백 url을 공유해주면, gree-x 측에서 해당 url을 호출한다는점 맞음.
ad channer id를 넣으면 gree-x에서 내려오는 광고 리스트 확인이 가능.
gree-x 는 api 를 통한 캠페인 자동 수집이 아닌 언어 번역을 거쳐 이메일로 전달하는 방식을 취하고 있음.
•
media user id 파라미터는 gree-x 측에서 유저 식별값으로 사용하고 있을지, 해당 값에 그린피 click key를 담으려고 하는데, click key의 경우 클릭할때마다 변경되다보니 media user id 를 유저 식별값으로 사용한다면, 별도의 파라미더에 그린피 click key를 담아서 드려야 할 것 같음
>> gree-x : user id의 경우 유저마다 고유한 값을 보내줘야 하기 때문에, 클릭 할때마다 변하는 값이라면
media session 1에 값을 넣어주면 될 듯
>> 그린피 : media session 1에는 캠페인 클릭시마다 변하는 값인 click key를 담아 드리고,
유저 고유 식별값 user id 인 app-uid도 캠페인 참여시 같이 담아 드리겠다.
** 언어 번역 후 api로 캠페인 내려주는건 불가
** 언어 번역 하지 않고 api로 내려주는것 또한 불가
** 캠페인은 이메일로 전달 줄 예정
그린피 포스트백 url 전달 필요 GreenP → Gree-x
ㄴ https : // api.greenp.kr/postback/greex.proc?media_user_id={media_user_ud}
그린피 → gree-x
gree x 랜딩url?media_session_1={click_key}&user_id={app_uid}
gree-x → 그린피
https://api.greenp.kr/postback/greex.proc?click_key={media_session_1}
*포스트백 호출 시 app_uid는 돌려주지 않아도 됨
그린피 click key : 같은 유저가 참여해도 캠페인 클릭때마다 다르게 부여되는 값
그린피 app_uid: 유저마다 고유하게 부여되는 유저 식별값
2.
GMO
그린피 (DSP) → GMO (SSP) 물량 주는 연동
그린피가 API 연동 가이드 , 매체사 어드민 계정. API 앱코드 발급하여 전달
•
appcode: rihL35wEnd
•
•
매체사 어드민 계정
id: gmo_tech / pw: gmo1234
전환테스트 체크 리스트
클릭키
리워드 지급 매체에 잘 했는지
싱글/멀티 유형별
파라미터 매칭 잘 들어 왔는지
제휴사 에러코드 (API 문서에서 확인)