Versions Compared

Version Old Version 1 New Version 2
Changes made by

Koby

Koby

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

1. 플로우:시퀀스 다이어그램

...

해당 URL은 네이버SIS에 진입하기 위한 URL입니다.

Code Block
https://pointhub.buzzvil.com/buzzad/multi-action/sis?ifa={ifa}&unit_id={unid_id}&app_id={app_id}&puid={puid}

publisher_path : 버즈빌과 사전 협의된 path를 입력합니다.

...

구분

유형

내용

예시

app_id

Integer
(MAX 20)

매체 앱 아이디

  • 버즈빌에서 발급드린 고유 식별자입니다.

123234345

Unit_id

Integer
(MAX 20)

매체 지면 아이디

  • 버즈빌에서 발급드린 고유 식별자입니다.

1234567

ifa

String
(MAX 64)

사용자의 광고식별자

  • 광고 타게팅 및 어뷰징 필터링, CS 처리를 위해 필요합니다.

  • 광고식별자 수집이 불가능할 경우 uuid 포맷을 모두 0으로 채워 요청해야 합니다.

예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1

user_id(PUID)

String
(MAX 65)

사용자 고유 식별자

  • 서비스 도중 변하지 않는 고정 값입니다.

  • 광고 할당을 위한 필수 정보입니다.
    (최대 65자까지만 전달이 가능합니다.)

매체 협의 필요

client_id

String
(MAX 45)

광고에 참여한 유저의 ip

  • 실제 유저의 ip 값을 전달해 주어야 합니다.

  • 그러지 않을 경우 CPA 유형의 광고 송출이 불가합니다.

예제) 123.123.123.123

...

구분

유형

내용

예시

birthday

Status
colourGreen
title권장

String
(MAX 10)

유저의 생년월일

  • 생년월일 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

예제) 1993-01-09 ( O )19930109 ( X )

gender

Status
colourGreen
title권장

String
(MAX 20)

성별 타게팅을 위한 정보

  • 성별 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

  • M: 남자

  • F: 여자

platform

Status
colourGreen
title권장

String

기기의 OS 정보

  • A: Android

  • I: iOS

Status
colourGreen
title권장
carrier

String
(MAX 20)

통신사 정보

  • 통신사 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

  • kt: KT 통신사

  • skt: SKT 통신사

  • lgt: LGT 통신사

Status
colourGreen
title권장
device_name

String
(MAX 255)

디바이스 모델명

  • 디바이스 모델명이 없을 경우 일부 광고가 할당에서 제외됩니다.

예제) SHV-E250S,SHV-E275K,SM-G928L → SHV-E250S 또는 SHV-E275K 또는 SM-G928L 인 유저에게 타게팅

Status
colourGreen
title권장
latitude

Float
(MAX 32)

위도 와 경도

  • 지역별 광고 타게팅에 사용됩니다.

  • 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

Status
colourGreen
title권장
longitude

Float
(MAX 32)

Status
colourGreen
title권장
user_agent

String
(MAX 255)

User Agent.

  • 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.

...

파라미터 필드(Field)

타입
(Type)

설명

user_id

Status
colourGreen
titleREQUIRED

String 
(max 65)

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

최대 65자까지만 전달 가능합니다.

transaction_id

Status
colourGreen
titleREQUIRED

String 
(max 32)

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

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

Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFEBE6

재적립 시도 시 동일한 transaction_id로 포스트백을 요청합니다.

같은 transaction_id로 요청이 온 경우에 포인트가 중복 적립되지는 않는지 필수적으로 유의해서 처리해야 합니다.

point

Status
colourGreen
titleREQUIRED

Integer

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

unit_id

Status
colourGreen
titleREQUIRED

Long

광고가 노출된 지면의 ID 값

Note

현재 주로 사용하는 값은 15자리의 숫자입니다.

title

Status
colourGreen
titleREQUIRED

String
(max 255)

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

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

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

  • 그 외는 모두 빈값

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

Info

최대 한글 255자까지 전달될 수 있으므로 연동 시 DB별 String 사이즈를 참조해 주세요.

event_at

Status
colourGreen
titleREQUIRED

Long (timestamp)

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

대부분 API 호출시점과 동일하지만 API 호출이 재시도인 경우 다를 수 있습니다.

action_type

Status
colourRed
titleOPTIONAL

String
(max 32)

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

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

  • u: 잠금 해제

  • l: 랜딩

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

  • p: 컨텐츠 참여

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

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

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

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

  • benefit_luckybox : 럭키박스 참여 보상

  • benefit_missionpack: 미션팩 특별 보상

  • benefit_missionpack_task: 미션팩 미션별 보상

Expand
title버즈부스터를 함께 사용하는 경우

  • booster_attended : 버즈부스터 출석체크 보상

  • booster_hiddendone : 버즈부스터 비노출 캠페인 보상

  • booster_optedin : 버즈부스터 마케팅 수신동의 캠페인 보상

  • booster_spinned : 버즈부스터 룰렛 캠페인 보상

  • booster_scratched : 버즈부스터 긁는 복권 캠페인 보상

  • booster_stamped : 버즈부스터 스템프 캠페인 보상

  • booster_inviting : 친구 초대 캠페인 보상 (초대 한 사람)

  • booster_invited : 친구 초대 캠페인 보상 (초대 받은 사람)

Note

추후 다양한 action_type이 타입이 추가될 수 있습니다. 따라서 포스트백 요청을 받을 때 정의된 값만 받도록 하는 것이 아닌, 값에 구애받지 않고 요청을 처리할 수 있도록 유의 바랍니다.

revenue_type

Status
colourRed
titleOPTIONAL

String
(max 32)

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

Expand
title모든 광고 유형 리스트

  • cpc: 클릭형 상품

  • cpm: 노출형 상품

  • cpa: 일반 참여형 상품

  • cpk: 카카오톡 채널 추가 상품

  • cpq: 퀴즈 상품

  • cpqlite: 퀴즈 상품

  • cpl: 페이스북 좋아요 상품

  • cpyoutube: 유튜브 구독 상품

  • cps: 쇼핑형 상품

  • cptiktok: 틱톡 팔로우 상품

  • cpnstore: 네이버 스토어 알림설정 상품

  • cpi: 앱 설치 상품

  • cpe: 앱내 이벤트 참여 상품

  • cpylike: 유튜브 구독+좋아요 상품

  • cpinsta: 인스타그램 팔로우 상품

  • cpcquiz : 퀴즈 적립 컨텐츠

추후 다양한 타입이 추가될 수 있습니다.

extra

Status
colourRed
titleOPTIONAL

String
(max 1024)

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

Info

파라미터를 추가하고 싶으시다면 help@buzzvil.com으로 문의 부탁드립니다.

campaign_id

Status
colourRed
titleOPTIONAL

Long

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

data

Status
colourRed
titleOPTIONAL

String

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

Info

자세한 내용은 아래 HTTP Request Parameter Encryption/Decryption을 참조하세요.

c

Status
colourRed
titleOPTIONAL

String

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

Info

자세한 내용은 아래 Add Checksum Parameter를 참조하세요.

custom2

Status
colourRed
titleOPTIONAL

String
(max 255)

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

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

  • custom2~4까지 전달 가능

custom3

Status
colourRed
titleOPTIONAL

String
(max 255)

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

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

  • custom2~4까지 전달 가능

custom4

Status
colourRed
titleOPTIONAL

String
(max 255)

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

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

  • custom2~4까지 전달 가능

...