사용자에게 보상을 지급하기 위해서 포스트백(Postback) 연동이 필요합니다. 포스트백 요청은 보안을 위해 서버 간 통신(Server-to-Server) 형태로 진행됩니다.
...
파라미터 필드(Field) | 타입
(Type) | 설명 |
|---|
user_id
| String
(max 65) | 매체사에서 정의한 유저의 식별값 최대 65자까지만 전달 가능합니다. |
transaction_id
| String
(max 32) | 보상에 발급되는 ID. 각 보상을 식별하고 포인트 중복 지급을 방지하기 위해 사용 | Panel |
|---|
| panelIconId | atlassian-warning |
|---|
| panelIcon | :warning: |
|---|
| bgColor | #FFEBE6 |
|---|
| 재적립 시도 시 동일한 transaction_id로 포스트백을 요청합니다. 같은 transaction_id로 요청이 온 경우에 포인트가 중복 적립되지는 않는지 필수적으로 유의해서 처리해야 합니다. |
|
point
| Integer | 유저에게 지급해야하는 포인트 |
unit_id
| Long | 광고가 노출된 지면의 ID 값 | Note |
|---|
현재 주로 사용하는 값은 15자리의 숫자입니다. |
|
title
| String
(max 255) | 포인트가 지급된 방식에 설정된 이름 광고 (참여한 광고의 이름) 그 외는 모두 빈값
| Info |
|---|
최대 한글 255자까지 전달될 수 있으므로 연동 시 DB별 String 사이즈를 참조해 주세요. |
|
actionevent_typeat
| String
Long (max 32timestamp) 포인트를 지급 받기 위해 유저가 취한 액션 타입 | opened: Feed 지면 진입 (지면을 방문하기만 해도 기본 리워드 적립)
u: 잠금 해제
l: 랜딩
a포인트 지급 시점 (UNIX Timestamp 초단위) 대부분 API 호출시점과 동일하지만 API 호출이 재시도인 경우 다를 수 있습니다. |
action_type
| String
(max 32) | 포인트를 지급 받기 위해 유저가 취한 액션 타입 opened: Feed 지면 진입 (지면을 방문하기만 해도 기본 리워드 적립)
u: 잠금 해제
l: 랜딩
a: 액션 (해당 광고의 요구 액션을 완료했을 때)
p: 컨텐츠 참여
won: Potto에서 당첨번호에 당첨되었을 시 포인트 적립을 요청
manual: 담당자 수기 적립 요청
spinned : 룰렛 미션 참여 시 지급되는 포인트
daily : Feed 출석체크(데일리 리워드 이벤트) 참여 보상
benefit_luckybox : 럭키박스 참여 보상
benefit_missionpack: 미션팩 특별 보상
benefit_missionpack_task: 미션팩 미션별 보상
| Expand |
|---|
| booster_attended : 버즈부스터 출석체크 보상
booster_hiddendone : 버즈부스터 비노출 캠페인 보상
booster_optedin : 버즈부스터 마케팅 수신동의 캠페인 보상
booster_spinned : 버즈부스터 룰렛 캠페인 보상
booster_scratched : 버즈부스터 긁는 복권 캠페인 보상
booster_stamped : 버즈부스터 스템프 캠페인 보상
booster_inviting : 친구 초대 캠페인 보상 (초대 한 사람)
booster_invited : 친구 초대 캠페인 보상 (초대 받은 사람)
|
| Note |
|---|
추후 다양한 action_type이 타입이 추가될 수 있습니다. 따라서 포스트백 요청을 받을 때 정의된 값만 받도록 하는 것이 아닌, 값에 구애받지 않고 요청을 처리할 수 있도록 유의 바랍니다. |
|
event_at
| Long (timestamp) | 포인트 지급 시점 (UNIX Timestamp 초단위) 대부분 API 호출시점과 동일하지만 API 호출이 재시도인 경우 다를 수 있습니다. |
extra
| String
(max 1024) | 파라미터를 추가해야할 경우, 해당 파라미터(JSON serialize 된 문자열 값)를 활용 매체사가 지정한 캠페인 데이터 (대시보드에서 캠페인을 생성할 때 지정할 수 있습니다) e.g {"sub_type": "A", "source":"external"}, 값에 구애받지 않고 요청을 처리할 수 있도록 유의 바랍니다. |
|
revenue_type
| String
(max 32) | 유저가 참여한 광고의 광고 유형 |
extra
| String
(max 1024) | 파라미터를 추가해야할 경우, 해당 파라미터(JSON serialize 된 문자열 값)를 활용 | Info |
|---|
파라미터를 추가하고 싶으시다면 help@buzzvil.com으로 문의 부탁드립니다. |
|
campaign_id
| Long | 유저가 참여한 캠페인(광고, 컨텐츠, 프로모션) 의 ID입니다. |
data
| String | HTTP request parameter를 암호화 해서 전송하는 경우 사용되는 파라미터 | Info |
|---|
자세한 내용은 아래 HTTP Request Parameter Encryption/Decryption을 참조하세요. |
|
c
| String | HTTP request parameter에 Checksum을 전송하는 경우 사용되는 파라미터 | Info |
|---|
자세한 내용은 아래 Add Checksum Parameter를 참조하세요. |
|
custom2
| String
(max 255) | 퍼블리셔 실시간 S2S API 제품 연동 매체사에서 지정하는 커스텀 파라미터 |
custom3
| String
(max 255) | 퍼블리셔 실시간 S2S API 제품 연동 매체사에서 지정하는 커스텀 파라미터 |
custom4
| String
(max 255) | 퍼블리셔 실시간 S2S API 제품 연동 매체사에서 지정하는 커스텀 파라미터 |
...
| Code Block |
|---|
{
"user_id": "12345",
"point": 1,
"transaction_id": "126905422_10000001",
"event_at": 1641452397,
"unit_id": 5539189976900000,
"action_type": "l",
"title": "\uad11\uace0\u0020\ud2b9\uac00타이틀",
"extra": "{}"
} |
IP Whitelist 추가
...
