[DEPRECATED] Feed(Web) 포스트백 API 연동

요청 방향

버즈빌 서버 → 퍼블리셔 서버

HTTP Request method

POST - application/x-www-form-urlencoded

HTTP Request URL

퍼블리셔 서버의 엔드포인트 (i.e postback_url )

HTTP Request Parameters

아래 포스트백 파라미터 테이블을 참고합니다.

HTTP Response Code

버즈빌 서버는 퍼블리셔 서버로 부터 전달받은 응답 코드(Response Code)를 바탕으로 성공 여부를 판단합니다.

• 200 (ok): 성공 처리합니다.

• 그 외 응답 코드: 버즈빌 서버는 24시간 내 최대 5번까지 재시도합니다.

  • 재시도 요청 시간: 각 1분, 10분, 1시간, 3시간, 24시간 뒤

app_key

Long

O

O

퍼블리셔 서비스의 app_id 값입니다.

unit_id

Integer

O

O

광고가 노출된 웹 피드 지면의 ID 값입니다.

transaction_id

String 
(max 64)

O

O

보상에 발급되는 Transaction ID 입니다. 리워드 중복 지급을 방지하기 위해 사용합니다.

• 리워드 지급 요청 시 해당 Transaction ID로 리워드가 지급된 기록이 있다면, 중복 지급을 방지하기 위해 지급하지 않습니다.

user_id

String 
(max 255)

O

O

퍼블리셔 사용자의 ID 입니다. 웹 피드 연동 시 전달 받은 값입니다.

campaign_id

Long

O

O

리워드 포인트를 지급한 캠페인의 ID 입니다.

campaign_name

String
(max 255)

O

O

리워드 포인트를 지급한 캠페인의 이름입니다.

title

String
(max 255)

X

O

사용자가 참여한 광고의 제목입니다.

point

Integer

O

O

사용자에게 지급해야 하는 리워드 금액입니다.

is_media

Integer

O

O

• 0: 버즈빌의 캠페인을 의미합니다.

• 1: 퍼블리셔의 캠페인을 의미합니다.

revenue_type

String
(max 32)

O

O

광고의 타입입니다.

• cpi: 인스톨 광고 (Cost per Install, 인스톨 시 과금)

• cpe: 인스톨+실행 광고 (Cost per Engagement, 인스톨 후 실행시 과금)

• cpa: 액션형 광고 (Cost per Action, 광고주 측 액션 후 과금)

action_type

String
(max 32)

O

O

리워드를 받기 위한 사용자의 활동을 의미합니다.

• l: Landing, 광고주 페이지 접근 시 지급

• a: Action, 실행/가입 등의 광고주 정의 활동 시 지급

event_at

Long (timestamp)

O

O

리워드 관련 행동이 일어난 시각을 의미합니다.

extra

String
(max 1024)

O

O

퍼블리셔가 지정한 캠페인 데이터 입니다. JSON 형태의 문자열 값입니다. 대시보드에서 캠페인을 생성할 때 지정할 수 있습니다.

e.g {"sub_type": "A", "source":"external"}

unit_price

decimal (18,9)

X

O

퍼블리셔에게 제공되는 캠페인의 단위 금액입니다.

ifa

String
(max 64)

X

O

사용자의 광고 ID 입니다. e.g GAID, IDFA

reward

Integer

X

O

액션형 광고를 위한 지급 리워드 금액입니다. point 값과 동일합니다

allow_multiple_conversions

0 or 1

X

O

해당 광고에 여러 번 참여할 수 있는지 의미합니다.

• 0: 한 번만 참여할 수 있습니다.

• 1: 여러 번 참여할 수 있습니다. 특정 타입의 비디오 광고 등이 이에 속합니다.

data

String

OPTIONAL

파라미터가 암호화 되어 있을 경우 사용합니다. 다음 요청 파라미터 검증 항목을 참고합니다.