비디오 광고
비디오 광고 연동을 위한 Open RTB 규약입니다.
Last updated
비디오 광고 연동을 위한 Open RTB 규약입니다.
Last updated
SSP DSP
메조미디어 SSP 는 HTTP POST 방식으로 아래 정의된 객체를 JSON 형태로 작성해 DSP 인터페이스를 호출합니다. 요청 객체 정의는 OPEN RTB 2.5 규격을 따릅니다.
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
imp / video
imp / video / ext
app / publisher
RTB 프로토콜에는 없는 메조미디어의 확장 필드 입니다.
RTB 프로토콜에는 없는 메조미디어의 확장 필드 입니다.
DSP 는 아래 정의된 객체를 HTTP body 에 포함해 응답합니다. 객체 정의는 OPEN RTB 2.5 규격을 따릅니다.
JSON 형식의 응답 객체입니다.
XML 로 정의되는 객체입니다. 객체 정의는 VAST 3.0 규격을 따릅니다.
adm / VAST
adm / Ad
요소 값은 광고 엔진 이름입니다.
adm / Ad / Inline / Creatives / Creative / Linear / TrackingEvents / Tracking
요소 값은 트래킹 이벤트 전달을 위한 HTTP(s) URL 입니다.
요소 값은 트래킹 이벤트 전달을 위한 HTTP(s) URL 입니다.
(이벤트 값과 offset 값이 같은) 동일한 이벤트에 서로 다른 트래킹 URL 을 지정할 수 있습니다.
요소 값은 클릭 이벤트를 처리하기 위한 HTTP(s) URL 입니다.
ClickThrough : DSP 에서 클릭 이벤트를 처리한 뒤, 최종 광고 랜딩으로 리다이렉트 하도록 구성할 수 있습니다.
adm / Ad / Inline / Creatives / Creative / Linear / MediaFiles / MediaFile
요소 값은 비디오 콘텐츠의 경로입니다. (HTTP, HTTPS)
해당 내용은 iOS14 버전 혹은 그 이상의 환경에서 SKAdNetwork가 활성화된 캠페인을 지원하기 위한 내용입니다.
BidRequest / imp / banner / ext / skadn
해당 Object를 사용하기 위해서는 우선적으로 아래 사항들이 준비되어야 합니다.
BidResponse / imp / banner / ext / skadn
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| Field | Type | Required | Description |
|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
DSP SSP
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 이벤트 값 | 설명 |
|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 요소 / 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 | 예 |
|---|---|---|---|---|
| 필드 | 유형 | 필수 | 설명 | 예 |
|---|---|---|---|---|
id
string
Y
요청 유니크 아이디
cur
string array
N
ISO-4217-alpha 경매에 사용할 수 있는 통화 입니다. 예: “KRW”
test
integer
N
경매가 테스트 모드(1)건 실시간 모드(0)건, 테스트 경매에는 입찰할 수 없습니다
at
integer
Y
0 : fixed price, 1: first price, 2: second price
tmax
integer
Y
최대허용시간 (ms).
imp
object array
Y
imp 객체를 참고하십시오.
app
object
Y
app 객체를 참고하십시오.
device
object
Y
device 객체를 참고하십시오.
user
object
Y
user 객체를 참고하십시오.
bcat
string array
N
IAB 카테고리 기준으로 광고주 카테고리를 차단합니다.
badv
string array
N
광고주의 도메인을 차단합니다.
bapp
string array
N
App의 번들이나 패키지명을 차단합니다.
ext
object
Y
ext 객체를 참고하십시오.
id
string
Y
노출에 대한 유니크 아이디
bidfloor
float
Y
입찰로 인정받을 수 있는 최소 가격. 예) 4.12
bidfloorcur
string
Y
통화, 예) ‘KRW’
secure
integer
Y
0 : http, 1 : https
video
object
Y
video 객체를 참고하십시오.
instl
integer
Y
전면광고 여부를 전달합니다. (default: 0) * 1 = the ad is interstitial or full screen * 0 = not interstitial.
displaymanager
string
Y
SSP 플랫폼명 또는 SDK명을 의미합니다.
displaymanagerver
string
Y
SSP 플랫폼 또는 SDK 버전을 의미합니다.
mimes
string array
Y
MIME 타입. 예) “video/mp4”
w
integer
Y
비디오의 가로 크기
h
integer
Y
비디오의 세로 크기
minduration
integer
Y
비디오가 재생되어야 하는 최소 시간(초)
maxduration
integer
Y
비디오가 재생될 수 있는 최대 시간(초)
protocols
integer array
Y
VAST 버전. “3” 을 전달합니다.
startdelay
integer
Y
프리롤, 미드롤, 포스트롤 광고 구분값을 전달합니다. * 0 = 프리롤 * -1 = 일반 미드롤 * -2 = 일반 포스트롤
linearity
integer
Y
1: in stream, 2: out stream
delivery
integer array
Y
2 (Progressive) 로 전달합니다.
placement
integer
Y
비디오 게재 위치 * 1 = 플레이어 내 * 2 = 배너 내 * 3 = 기사 내 * 4 = 피드 내 * 5 = 전면/슬라이드/플로팅
ext
object
N
표준 항목 외에 필요한 정보를 전달합니다.(ex, rewarded)
rewarded
integer
N
Reward 광고 여부를 전달합니다. * 0 = no(non-reward) * 1 = yes(reward)
id
string
Y
퍼블리셔 ID
name
string
N
애플리케이션 이름
bundle
string
Y
번들 이름, 패키지 이름
storeurl
string
N
앱스토어 URL
cat
string array
N
카테고리
publisher
object
Y
publisher 객체를 참고하십시오.
id
string
Y
퍼블리셔 ID
name
string
N
퍼블리셔 명
cat
string array
N
카테고리
ua
string
Y
디바이스의 User Agent 정보
dnt
integer
N
위치 추적 금지 활성화 여부. 0: 추적 가능, 1: 추적 금지.
ip
string
Y
IPV4 주소
model
string
N
모델명
os
string
Y
운영체제. 예) iOS, Anroid
osv
string
Y
운영체제 버전. 예) 8.1, 9.2
js
integer
N
RTB 프로토콜에 1로 정의되어 있습니다.
ifa
string
Y
Apple IFA 또는 Google 의 ADID
id
string
Y
사용자의 고유 ID
Price_type
integer
N
0: CPM, 2: CPC
id
string
Y
Bid Request 의 ID
bidid
string
Y
Bid 오브젝트의 ID
cur
string array
Y
입찰시 사용할 통화. 예) KRW
seatbid
object array
Y
bid 객체 에 대한 배열
id
string
Y
입찰 정보를 관리하는 ID
price
float
Y
입찰 가격
adm
string (XML)
Y
adm 객체를 참고하십시오.
nurl
string
N
낙찰 알림 url (win URL) 낙찰가를 {AUCTION_PRICE} 매크로에 치환하여 전달합니다.
burl
string
N
낙찰 청구 알림 url (Billing notice URL) 낙찰가를 {AUCTION_PRICE} 매크로에 치환하여 전달합니다.
lurl
string
N
유찰 알림 url (Loss notice URL) {AUCTION_LOSS} 매크로에 유찰 사유 코드를 치환하여 전달합니다.
adomain
string array
Y
광고주 도메인
cid
string
Y
광고주 캠페인명 / id
crid
string
Y
광고주 광고물명 / id
cat
string array
Y
카테고리
ext
object
Y
ext 객체를 참고하십시오.
VAST
element
Y
VAST 정의를 참고하십시오.
version
integer (속성)
Y
VAST 규약 버전. 3.0 인 경우, 3으로 작성합니다.
Ad
element array
Y
Ad 정의를 참고하십시오.
id
integer (속성)
N
광고 ID
sequence
integer (속성)
N
광고의 sequence 번호
Inline
element
Y
Inline 정의를 참고하십시오.
AdSystem
integer
N
AdSystem 정의를 참고하십시오.
AdTitle
integer
N
광고 이름
Extensions
element
N
Extensions 정의를 참고하십시오.
Error
element
N
Player 에러 발생시 호출할 트래킹 URL
Impression
element
Y
동영상 시작시 호출할 트래킹 URL
Creatives
element array
Y
Creative element 에 대한 배열
version
integer (속성)
N
광고 엔진 버전
requestID
string
N
광고 요청 고유 코드
id
integer (속성)
N
광고 번호
sequence
integer (속성)
N
광고 시퀀스
Linear
element
Y
Linear 정의를 참고하십시오.
Duration
string
N
영상 길이 / 재생 시간. hh:mm:ss 형태로 지정합니다.
TrackingEvents
element array
N
Tracking element 대한 배열
VideoClicks
element
N
VideoClicks 정의를 참고하십시오.
MediaFiles
element array
Y
MediaFile element 대한 배열
event
string (속성)
Y
이벤트 이름을 지정합니다. 예) start, firstQuartile, midpoint
offset
element array
N
이벤트 발생 조건이 되는 재생 시간을 지정합니다. hh:mm:ss 형태로 지정.
start
동영상이 시작된 경우 호출하는 트래킹 URL
firstQuartile
동영상이 25% 재생된 경우 호출하는 트래킹 URL
midpoint
동영상이 50% 재생된 경우 호출하는 트래킹 URL
thirdQuartile
동영상이 75% 재생된 경우 호출하는 트래킹 URL
complete
동영상 재생이 완료된 경우 호출하는 트래킹 URL
progress
동영상이 지정된 offset 속성만큼 재생된 경우 호출하는 트래킹 URL
ClickThrough
string
Y
광고 랜딩 페이지 URL
ClickTracking
string
N
광고 클릭 이벤트 트래킹 URL
offset
string
N
지정된 시간까지 재생된 이후에 광고 클릭이 가능합니다.
delivery
string (속성)
N
동영상 소재 재생 방식. progressive 를 지원합니다.
type
string (속성)
N
동영상 소재 타입. 예) video/mp4
width
integer (속성)
N
동영상 소재의 폭
height
integer (속성)
N
동영상 소재의 높이
bitrate
integer (속성)
N
동영상 소재의 비트레이트
1
DSP는 Apple의 SKAdNetwork API에 Ad Network로 등록되어 있어야 한다. (https://developer.apple.com/documentation/storekit/skadnetwork/registering_an_ad_network)
2
Apple로부터 Public key를 발급받고 Postback URL을 설정해야 한다.
3
Apple로부터 발급받은 SKAdNetwork ID를 MezzoMedia 담당자에게 전달하고 MezzoMedia는 전달받은 SKAdNetwork ID를 자사와 제휴된 퍼블리셔의 info.plist에 등록 요청한다.
4
DSP에서 SKAdNetwork가 활성화된 캠페인 Response를 전달할 때는 SKAdNetwork ID 및 관련된 모든 정보를 포함해야한다.
5
광고주 App은 registerAppForAdNetworkAttribution()를 통해 SKAdNetwork 사용자로 등록해야 한다.
6
DSP는 SKAdNetwork를 통해 설치 데이터를 제공 받을 수 있다.
1
DSP에서 제공하는 SKAdNetwork ID가 퍼블리셔의 info.plist에 등록되어 있어야 한다.
2
사용자 기기의 운영체제가 iOS14 혹은 그 이상이어야 한다.
3
SKAdNetwork를 지원하는 버전의 SDK를 설치해야한다.
4
DSP는 메조미디어의 Bid Request 규약을 준수해야한다.
version
string
Y
사용하는 SKadNetwork 버전. “2.0” 혹은 그 이상.
“version”:”2.0”
sourceapp
string
Y
Apple App 스토어에 등록된 퍼블리셔 App ID. ‘BidRequest.app.bundle’ 과 매칭
“sourceapp”:”000000000”
skadnetids
string
Y
퍼블리셔 App 내 info.plist에 입력된 SKAdNetwork IDs
“skadnetids”:[“feyaarzu9v.skadnetwork”]
version
string
Y
사용하는 SKadNetwork 버전. “2.0” 혹은 그 이상.
“version”:”2.0”
network
string
Y
광고 네트워크 식별자. Request에 포함된 skadnetids와 최소 한 개는 매칭되어야 함
“network”:[“feyaarzu9v.skadnetwork”]
campaign
string
Y
Apple의 규격에 맞는 캠페인 ID. 1과 100 사이의 정수를 이용해서 표현해야함
“campaign”:”45”
itunesitem
string
Y
Apple App 스토어에 등록된 광고주 App ID. ‘Bidresponse.bid.bundle’과 매칭
“itunesitem”:”123456789”
nonce
string
Y
개별 광고 response의 유니크 ID
“nonce”:”123b1a78-b5ef-98ad-1234-ab-c4effa00b8”
sourceapp
string
Y
Apple App 스토어에 등록된 퍼블리셔 App ID. ‘BidRequest.imp.ext.skad.sourceapp’ 과 매칭
“sourceapp”:”000000000”
timestamp
string
Y
Unix time을 string 값으로 전달
“timestamp”:”1234567890”
signature
string
Y
Apple에서 제공하는 SKAdNetwork sigature 값
“signature”:”ABCDEFGHijkl-lmb…”