리워드 콜백

이 문서는 매체사가 애드팝콘 팝콘텐츠의 리워드 콜백을 받아 유저에게 리워드 지급 처리 후 응답하는 방법에 대한 연동 가이드입니다.

리워드 콜백을 보낼 애드팝콘 서버의 IP는 아래와 같습니다.

  • 52.193.130.252

  • 35.72.69.220

  • 1.232.46.2

Method

  • GET

  • POST

Content-Type

  • application/x-www-form-urlencoded [POST]

Callback Parameter

파라미터 명
설명
데이터 타입

servicecode

리워드 서비스 코드 (POPCONTENTS 고정)

string

usn

리워드를 지급받을 유저의 아이디

string

adid

유저의 구글 광고 아이디

string

idfa

유저의 IDFA

string

reward_key

완료마다 발급되는 유니크한 리워드 트랜잭션 식별값

string

quantity

리워드 수량

long

service_id

출석체크, 운세보기 등등 서비스의 고유 아이디

string

campaign_id

유저가 참여한 캠페인의 고유 아이디

string

campaign_name

유저가 참여한 캠페인의 이름

string

Callback Response Parameter (JSON)

애드팝콘 리워드 서버에서 전달하는 리워드 지급 정보를 수신하여 처리한 후, 처리 결과를 JSON 타입으로 아래 정의된 케이스에 맞춰 응답해야합니다.

파라미터 명
설명
데이터 타입

Result

리워드 지급 성공 유무

boolean

응답 코드

int

ResultMsg

응답 메시지

string

ResultCode

응답코드
설명
예시

1

성공

{"Result":true,"ResultCode":1,"ResultMsg":"success"}

3100

리워드 중복 지급

{"Result":false,"ResultCode":3100,"ResultMsg":"duplicate transaction"}

3200

유저 검증 실패

{"Result":false,"ResultCode":3200,"ResultMsg":"invalid user "}

4000

예외 발생

{"Result":false,"ResultCode":4000,"ResultMsg":"custom error message"}

Last updated

Was this helpful?