Page Comparison

요청 방향

버즈빌 → 매체사

HTTP Request method

POST - application/x-www-form-urlencoded

HTTP Request URL

매체사 서버의 endpoint

HTTP Request Parameters

아래 Http Request Parameters 테이블을 참고합니다.

HTTP Response Code

버즈빌 서버는 매체사 서버로 부터 전달받은 응답 코드(Response Code)를 바탕으로 적립 성공 여부를 판단합니다.

• 200 (okOK), 204 (No Content), 409 (Conflicted Request) : 성공 처리

  • 매체 서버에서 요청을 제대로 처리한 경우 (유저에게 포인트를 성공적으로 적립해준 경우) 의 응답 코드

• 200, 204, 409 이외의 응답 코드: 최대 5회까지 해당 Postback 요청을 재시도

  • 1분, 10분, 1시간, 3시간, 24시간의 간격을 두고 재적립 시도 수행

  • 200 이외의 응답 코드는 표준 HTTP 응답 코드를 참고합니다.

user_id

String 
(max 65)

매체사에서 정의한 유저의 식별값

transaction_id

String 
(max 32)

보상에 발급되는 ID. 각 보상을 식별하고 포인트 중복 지급을 방지하기 위해 사용

• 최대 32자까지 전달될 수 있으므로, 연동 시 확인이 필요합니다.

point

Integer

유저에게 지급해야하는 포인트

unit_id

Long

광고가 노출된 지면의 ID 값

title

String
(max 255)

포인트가 지급된 방식에 설정된 이름

• 광고 (참여한 광고의 이름)

  • e.g 출시 임박! 해당 CPS 상품을 먼저 만나보세요! 😁 #Buzzvil #환상적

• 그 외는 모두 빈값

  • ex. 룰렛/만보기/뽀또

action_type

String
(max 32)

포인트를 지급 받기 위해 유저가 취한 액션 타입

• opened: Feed 지면 진입 (지면을 방문하기만 해도 기본 리워드 적립)

• u: 잠금 해제

• l: 랜딩

• a: 액션 (해당 광고의 요구 액션을 완료했을 때)

• won: Potto에서 당첨번호에 당첨되었을 시 포인트 적립을 요청

• manual: 담당자 수기 적립 요청

• spinned : 룰렛 미션 참여 시 지급되는 포인트

• daily : Feed 출석체크(데일리 리워드 이벤트) 참여 보상

event_at

Long (timestamp)

포인트 지급 시점 (UNIX Timestamp 초단위)

• Timestamp 조회: https://www.epochconverter.com/

extra

String
(max 1024)

파라미터를 추가해야할 경우, 해당 파라미터(JSON serialize 된 문자열 값)를 활용

• 매체사가 지정한 캠페인 데이터 (대시보드에서 캠페인을 생성할 때 지정할 수 있습니다)

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

revenue_type

String
(max 32)

유저가 참여한 광고의 광고 유형

campaign_id

Long

유저가 참여한 캠페인(광고, 컨텐츠, 프로모션) 의 ID입니다.

data

String

HTTP request parameter를 암호화 해서 전송하는 경우 사용되는 파라미터

c

String

HTTP request parameter에 Checksum을 전송하는 경우 사용되는 파라미터

custom2

String
(max 255)

퍼블리셔 실시간 S2S API 제품 연동 매체사에서 지정하는 커스텀 파라미터

• 버즈빌에서 매체사로 포스트백 request 시 전달 되는 값

• custom2~4까지 전달 가능

custom3

String
(max 255)

퍼블리셔 실시간 S2S API 제품 연동 매체사에서 지정하는 커스텀 파라미터

• 버즈빌에서 매체사 로 포스트백 request 시 전달 되는 값

• custom2~4까지 전달 가능

custom4

String
(max 255)

퍼블리셔 실시간 S2S API 제품 연동 매체사에서 지정하는 커스텀 파라미터

• 버즈빌에서 매체사로 포스트백 request 시 전달 되는 값

• custom2~4까지 전달 가능