운영 키와 콜백 URL은 운영 콘솔에서 설정합니다. 공통 GAD 매체사 계정으로 로그인하며 운영 데이터와 설정은 스테이징과 분리됩니다.

포스트백 규격

사용자가 광고를 완료하면 GAD 서버가 매체에 등록된 콜백 URL 로 포스트백을 보냅니다. 매체 서버는 이 요청을 받아 사용자에게 리워드를 지급합니다. SDK 방식과 서버 API 방식이 같습니다.

요청

메서드	POST
주소	매체에 등록한 콜백 URL
Content-Type	`application/json`

본문 필드

필드	타입	설명
`seq`	string	포스트백 고유 ID. 재전송도 같은 값으로 옵니다 — 이 값으로 중복 적립을 막습니다
`media`	string	미디어키
`adKey`	string	광고키
`adTitle`	string	광고명
`uid`	string	참여 때 받은 사용자 ID
`publisher_data`	string \| null	참여 때 data 로 넘긴 값. 넘기지 않았으면 null
`point`	number	사용자에게 줄 리워드(광고 단가 × 매체 리워드 비율, 소수점 버림)

예시

POST <등록한 콜백 URL>
Content-Type: application/json

{
  "seq": "cmv17ned80006stip4updiqxv",
  "media": "<미디어키>",
  "adKey": "<운영 광고키>",
  "adTitle": "<운영 광고명>",
  "uid": "user-0001",
  "publisher_data": "order-123",
  "point": 5
}

응답과 재전송

HTTP 200 으로 응답하면 성공입니다. 응답 본문은 보지 않습니다.
3초 안에 응답하지 않으면 실패로 봅니다.
실패하면 1·5·10·60분 뒤에 차례로 다시 보냅니다(최대 4번). 그래도 실패하면 더 보내지 않습니다.
429·503 응답은 재전송 횟수에 넣지 않고 미뤘다가 다시 보냅니다. Retry-After 헤더(초)를 주면 그만큼(30~600초 범위) 기다립니다.
같은 포스트백이 다시 올 수 있습니다. seq 가 같은 요청은 한 번만 지급하도록 처리해 주세요.

콜백 URL 조건

https 주소
포트는 443(또는 생략)
IP 주소가 아닌 공개 도메인 이름(한 단어 이름·내부 전용 이름 제외)
주소에 사용자 정보(user:pass@)를 넣지 않음

운영 콜백 URL 은 운영 콘솔에서 운영 매체마다 등록합니다. 운영 미디어키와 연결된 매체에 운영 수신 서버의 URL 을 등록하세요.

콜백 URL 을 등록하지 않은 매체에서 완료된 건은 포스트백이 나가지 않습니다. 광고 참여 전에 먼저 등록해 주세요.

포스트백 발신 IP 가 필요하면 문의 메일로 요청해 주세요.

수신 서버 준비

매체사 개발팀이 포스트백을 받아 리워드를 지급할 HTTPS 주소를 준비합니다. 운영 서버와 테스트 서버를 구분해 등록하세요.

운영 광고를 제공하기 전에 수신 서버의 요청 검증, 중복 지급 방지, 리워드 지급 처리를 준비하세요. 시험 지원이 필요하면 상단 환경 이동 버튼으로 스테이징으로 전환해 검증 절차를 확인하세요.

현재 매체사로 보내는 포스트백에는 요청 서명이 포함되지 않습니다. 발신 IP 허용 목록이 필요하면 jyi4@gpakorea.com 로 문의하세요. seq는 중복 지급 방지용 식별자이며 요청의 발신자를 인증하지 않습니다.

GPA KOREA 내부 수신 도구는 매체사 서버의 요청 검증·중복 지급 방지·리워드 지급 구현을 대신하지 않습니다.

운영 콘솔

운영 매체 등록, 미디어키 확인, 콜백 URL 설정은 운영 콘솔에서 진행합니다. 테스트 매체와 테스트 광고를 이용하려면 상단 환경 이동 버튼으로 스테이징으로 전환하세요.