동영상 광고 지원 기능이 출시됨에 따라 구매자는 Authorized Buyers를 통해 동영상 인벤토리를 구매할 수 있습니다. 이 문서에서는 Authorized Buyers 프로토콜을 사용하여 RTB를 통해 구매하기 위한 통합 요구사항을 설명합니다. 사용 가능한 프로토콜에 대한 자세한 내용은 시작하기 가이드의 프로토콜 선택 섹션을 참조하세요.
구매자는 여러 게재위치(현재 인스트림 및 전면 광고)에서 동영상 인벤토리를 구매할 수 있습니다. 자세한 내용은 전면 광고를 참조하세요.
구매자 요구사항
신규 RTB 구매자는 최신 프로토콜 버퍼와 다음 섹션에서 설명하는 정보를 사용하여 입찰자를 개발해야 합니다. 프로토콜을 다운로드하려면 실시간 입찰 참조 데이터 페이지를 확인하세요. 입찰자 개발에 대한 자세한 내용은 요청 처리 및 응답 작성을 참고하세요.
지원되는 매크로
인스트림 동영상 광고 소재에서 지원되는 매크로는 다음과 같습니다.
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Authorized Buyers는 VAST 래퍼에
클릭 추적기를 포함하므로 클릭 매크로 (예: CLICK_URL_ESC
)가 필요하지 않습니다.
인스트림 광고에서는 클릭 매크로가 지원되지 않습니다.
지원되는 매크로에 관한 자세한 내용은 응답 빌드에서 매크로 지정을 참고하세요.
콜아웃 세부정보
실시간 입찰 프로토콜은 real-time-bidding-proto.txt 파일에 정의된 동영상 메시지를 사용하여 동영상 요청을 식별하고 요청에 대한 동영상별 추가 정보를 제공합니다.
다음 중첩 동영상 메시지 필드 목록도 자세한 설명과 예를 제공합니다.
description_url
-
동영상 콘텐츠를 설명하는 페이지의 URL(매개변수가 삭제됨) 게시자가 이 URL을 Google에 제출합니다. 예를 들면 다음과 같습니다.
http://www.publisher.com/watchpagelink
EndCapSupport
-
사용 설정하면 동영상 광고 재생이 완료된 후 컴패니언 광고를 선택하여 동영상 슬롯의 엔드 캡 (정보 카드)으로 렌더링할 수 있습니다.
END_CAP_NOT_ENABLED
컴패니언 광고는 엔드 캡으로 렌더링되지 않습니다. END_CAP_OPTIONAL
응답에 요건을 충족하는 컴패니언 배너가 포함되어 있으면 엔드 캡이 렌더링되지만, 컴패니언 배너가 필수는 아닙니다. END_CAP_FORBIDDEN
컴패니언 광고가 포함된 응답이 필터링되었습니다. END_CAP_REQUIRED
컴패니언 광고가 없는 응답은 필터링됩니다. is_embedded_offsite
-
true
로 설정되면 동영상이 게시자 도메인 외부의 페이지에 삽입됩니다. is_rewarded
-
true
로 설정하면 사용자가 동영상 광고를 시청하여 보상을 받았음을 나타냅니다. 일반적인 보상으로는 추가 기사를 무료로 읽거나, 게임에서 추가 생명을 얻거나, 스폰서가 광고 없이 음악 세션을 이용할 수 있습니다. max_ad_duration
-
반환된 광고에 허용되는 최대 기간(밀리초)입니다.
0
로 설정하면 최대 지속 시간이 없습니다. max_ads_in_pod
- Authorized Buyers 동영상 광고 모음에 있는 최대 광고 수입니다. 0이 아닌 값은 현재 광고 슬롯이 여러 동영상 광고를 표시할 수 있는 동영상 광고 모음임을 나타냅니다. 표시되는 실제 동영상 광고 수는 이 값보다 작거나 같을 수 있지만 이를 초과할 수 없습니다.
min_ad_duration
- 반환해야 하는 최소 광고 시간(밀리초)입니다. 값이 설정되지 않거나 0보다 작거나 같으면 최소 기간이 없습니다.
Placement
-
동영상이 재생되는 위치를 설명합니다.
UNKNOWN_PLACEMENT
게재위치를 알 수 없거나 확인할 수 없습니다. INSTREAM
인스트림은 광고가 다른 동영상 콘텐츠 전후 또는 중간에 재생되는 것을 의미합니다. 일반적인 TV 광고와 유사합니다. 사용자가 시청 중인 동영상 콘텐츠는 광고가 재생되는 동안 재생되지 않습니다. INTERSTITIAL
전면 광고란 동영상 광고가 동영상이 아닌 콘텐츠 (예: 뉴스 기사 또는 비디오 게임) 앞에서 재생됨을 의미합니다. 광고가 화면에서 콘텐츠가 차지하는 공간의 전부 또는 대부분을 차지하며 사용자는 광고가 끝나거나 광고를 건너뛰지 않으면 콘텐츠로 진행할 수 없습니다. IN_FEED
인피드 동영상 형식은 사용자가 콘텐츠 피드(일반적으로 소셜 앱 피드, 뉴스 기사 등)를 스크롤할 때 이를 보여주는 동영상 광고 소재입니다. 동영상은 기본 피드와 사용자의 시각 및 읽기 흐름으로 렌더링됩니다. 동영상은 인배너 동영상과 달리 측면에 렌더링되지 않습니다. skippable_max_ad_duration
- 이 광고를 건너뛸 수 있는 경우 반환해야 하는 광고의 최대 시간(밀리초)입니다. 이는 일반적으로 건너뛸 수 없는 광고에 허용되는 최대 시간과 다릅니다. 이 필드가 설정되지 않거나 0 이하의 값이 있으면 모든 기간이 허용됩니다.
VideoPlaybackMethod
-
동영상 광고를 재생하는 방법을 설명합니다.
재생 방법은 사용 가능한 최상의 측정값에 따라 자동 재생 또는 클릭 재생방식으로 결정됩니다.
AUTO_PLAY_SOUND_ON
는 사운드가 켜진 상태에서 광고가 자동으로 재생됨을 의미합니다. AUTO_PLAY_SOUND_OFF
음소거 상태에서 광고가 자동으로 재생됨을 의미합니다. CLICK_TO_PLAY
는 광고를 클릭할 때까지 광고가 재생되지 않음을 의미합니다. video_ad_skippable
- 다음 값 중 하나를 포함하는
SkippableBidRequestType
의 값입니다.ALLOW_SKIPPABLE
는 건너뛸 수 있는 광고와 건너뛸 수 없는 광고가 모두 허용됨을 의미합니다. REQUIRE_SKIPPABLE
는 건너뛸 수 있는 광고만 반환될 수 있음을 의미합니다. BLOCK_SKIPPABLE
즉, 건너뛸 수 없는 광고만 반환될 수 있습니다. 이 필드를 설정하지 않으면 기본적으로 건너뛸 수 있는 광고를 허용합니다.
videoad_start_delay
-
동영상 시작부터 광고가 표시되는 지점까지의 시간(밀리초)입니다. 0은 프리롤을 의미하고 -1은 포스트롤을 의미합니다. 다른 양수 값은 슬롯이 동영상 중간에 있음을 나타냅니다.
값은 이 매개변수가 설정된 경우에만 유효합니다. 설정하지 않으면 디스플레이 위치를 알 수 없습니다.
이러한 신호는 동영상 광고 소재에만 적용되는 것은 아니지만, 입찰자가 읽을 때 특히 유용합니다.
advertising_id
- 이 필드는 SSL을 사용할 때만 설정되는 16바이트 UUID입니다.
암호화되지 않은
encrypted_advertising_id
버전입니다. iOS 기기의 경우 광고주 식별자 (IDFA)가 포함됩니다. Android 기기의 경우 Android 식별자 (ADID)가 포함됩니다. 커넥티드 TV 기기의 경우 고유 식별자(예: Roku의 RIDA)가 포함됩니다. device_type
- 기기 유형을 지정합니다.
UNKNOWN_DEVICE
가 이 필드의 기본값입니다. HIGHEND_PHONE
동영상 기능이 있는 휴대전화가 포함됩니다. TABLET
태블릿 기기 포함 PERSONAL_COMPUTER
여기에는 데스크톱 및 노트북 기기가 포함됩니다 CONNECTED_TV
여기에는 연결된 TV (스마트 TV 등) 및 연결된 기기 (예: Roku, Apple TV 등)가 모두 포함됩니다. GAME_CONSOLE
여기에는 전용 게임 기기가 포함됩니다. brand
- 기기의 브랜드 (예: Nokia 또는 삼성)를 지정합니다. 이 필드는 선택사항이며, 기본적으로 지정되지 않습니다.
model
- 기기의 정확한 모델 (예: N70 또는 Galaxy)을 지정합니다. 이 필드는 선택사항이며, 기본적으로 지정되지 않습니다.
screen_orientation
-
광고 요청이 전송될 때 기기의 방향을 지정합니다.
유효한 값은
LANDSCAPE
,PORTRAIT
,UNKNOWN_ORIENTATION
입니다. viewability
- 이전에 해당 슬롯을 조회할 수 있었던 빈도를 기준으로 최종 사용자가 이 슬롯을 조회할 수 있을 가능성에 대한 추정치를 제공합니다. [0, 100] 범위의 백분율로 표시됩니다. 기본값
-1
는 이전 조회가능성 데이터를 사용할 수 없음을 나타냅니다. content_attributes.duration_seconds
-
동영상이 재생되는 시간(초)입니다(예: 200).
이는
ContentAttributes
메시지에서 선언됩니다. 이 값은 동영상 게시자가 제공하는 동영상 메타데이터에 지정된 값으로 설정됩니다.
동영상 입찰 요청에는 카테고리, 허용된 공급업체, 채널 정보와 같은 인벤토리에 관한 정보도 포함됩니다. 입찰 요청의 다른 모든 기존 필드가 동영상에도 적용됩니다.
동영상 요청의 AdSlot 메시지에 있는 너비와 높이 필드는 동영상 광고 플레이어의 크기에 해당합니다.
allowed_vendor_type
- 허용된 공급업체입니다. ID 목록은 기술 문서의 vendors.txt 파일을 참조하세요. (예: 309 = DFA 동영상 단위).
allowed_video_formats
-
이 요청에 대한 응답으로 게재되는 광고에 허용되는 동영상 기술을 설명합니다.
응답은 허용된 동영상 기술 중 하나 이상에 대한 지원을 나타내야 합니다.
이렇게 반복되는 필드의 값은 열거형 VideoFormat에서 가져옵니다.
VIDEO_FLASH
Flash Video (FLV) 형식을 사용하는 동영상을 허용합니다. VIDEO_HTML5
HTML5 동영상 형식을 사용하는 동영상을 허용합니다. VPAID_FLASH
동영상 플레이어 광고 게재 인터페이스 정의 (VPAID) Flash 동영상 형식을 사용하는 동영상을 사용할 수 있습니다. VPAID_JS
VPAID 자바스크립트 동영상 형식을 사용하는 동영상을 허용합니다. companion_slot
-
이 필드는 다음 필드를 포함하는 CompanionSlot 메시지를 나타냅니다.
height
이 슬롯에 사용할 수 있는 높이입니다. width
이 슬롯에 사용할 수 있는 너비입니다. CreativeFormat
광고 소재 형식은 이 컴패니언 슬롯에 있는 광고 소재에 가능한 형식을 나타냅니다. url
-
동영상 보기 페이지의 URL 또는 동영상이 삽입된 페이지의 URL입니다. 예를 들면 다음과 같습니다.
http://www.publisher.com/watchpagelink
동영상 요청에 응답할 때
입찰자는 video_url
필드에
VAST 리디렉션 URL을 반환해야 합니다.
또한 입찰 응답에는 동영상 광고에
해당하는 선언이 포함되어야 합니다.
다음은 적절한 동영상 입찰 응답을 발췌한 것입니다.
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
동영상 입찰 응답에서 중요한 필드는 다음과 같습니다.
attribute
-
이 스니펫에서 게재할 수 있는 광고의 모든 속성입니다. ID 목록은
buyer-declarable-creative-attributes.txt 파일을 참조하세요.
입찰 요청의
excluded_attribute
목록에 이러한 속성이 모두 포함되어 있지 않은지 확인합니다. 이 필드는 HTML 스니펫 또는 동영상 광고가 반환되는 경우에만 설정합니다. 예를 들어 이 필드를30
로 설정하면 광고를 렌더링하려면 VPAID 지원이 필요하다는 뜻입니다. protocol
-
동영상 광고 요청에 대해 게시자가 지원하는 VAST 버전을 설명하여
지정된 버전 이하의 VAST 광고를 허용합니다.
지원되는 동영상 광고 프로토콜의 배열을 포함합니다.
이는 OpenRTB 2.4의 동작과 일치합니다.
가능한 값은
VAST_2_0
,VAST_3_0
,VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
,VAST_4_0_WRAPPER
입니다. video_url
-
동영상 광고의 VAST 리디렉션 URL입니다. 예를 들면 다음과 같습니다.
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
- 구매자가 동영상을 포함하는 방법
- 모든 동영상 형식에 대한 OpenRTB 권장 신호
- 모든 동영상 형식에 대한 Authorized Buyers 프로토콜 권장 신호
- 게시자가 동영상을 허용/허용하는 방법
- 특이 사례
사전 타겟팅
동영상 인벤토리를 수신하려면 RTB 구매자에게 동영상 인벤토리가 포함된 RTB에 대한 사전 타겟팅 구성이 있어야 합니다.
입찰 요청 및 응답 예시
AdX 동영상 형식
구매자가 동영상을 포함할 수 있는 방법
다음 표는 구매자가 웹 및 모바일 앱의 광고 소재 및 게재위치에 각각 게재할 수 있는 동영상 및 게재위치에 동영상을 포함할 수 있는 방법을 보여줍니다.
웹
동영상 광고 소재 | 인스트림 (모두) | 인피드/도움말 | 네이티브 인피드/도움말 | 전면 광고 | 인배너 |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
맞춤 자바스크립트 |
|
||||
네이티브 + VAST |
|
모바일 앱
동영상 광고 소재 | 인스트림 (모두) | 인피드/도움말 | 네이티브 인피드/도움말 | 전면 광고 | 인배너 |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
맞춤 자바스크립트 |
|||||
네이티브 + VAST |
키: | 형식/기술을 사용할 수 없음 | 이 게재위치에 허용되는 동영상 광고 소재, 게시자 차단이 적용됨 |
이 게재위치에서 동영상 광고 소재를 사용할 수 없습니다. |
---|
OpenRTB 권장 신호
다음 표는 데스크톱 및 모바일 웹과 모바일 앱의 모든 동영상 형식에 대한 OpenRTB 권장 신호를 보여줍니다.
데스크톱 및 모바일 웹
동영상 형식 | 권장 신호 (동영상 관련 신호만) | 관련 신호 (동영상 관련 신호만) |
---|---|---|
인스트림 (VPAID) |
VIDEO 객체 있음 및 |
|
인스트림 (VPAID 없음) |
VIDEO 객체 있음 및 |
|
아웃스트림 캠페인 |
VIDEO 객체 있음
|
|
인피드 광고 |
VIDEO 객체 있음 및 |
|
인아티클 광고 |
VIDEO 객체 있음 및 |
|
네이티브 |
NATIVE 객체 존재 및 |
|
인배너 |
동영상 객체가 없음 & |
모바일 앱
동영상 형식 | 입찰 요청 세부정보 (동영상 관련 세부정보만) | |
---|---|---|
인스트림 |
VIDEO 객체 있음 및 |
|
아웃스트림 캠페인 |
VIDEO 객체 있음
|
|
인피드 광고 |
VIDEO 객체 있음 및 |
|
인아티클 광고 |
VIDEO 객체 있음 및 |
|
네이티브 |
NATIVE 객체 존재 및 |
|
전면 광고 (VAST) |
VIDEO 객체 있음 및 |
|
전면 광고 (VAST 제외) |
VIDEO 객체 있음 및 |
필터링됨 |
인배너 (MRAID) |
동영상 객체가 없음 & |
|
인배너 (MRAID 없음) |
동영상 객체가 없음 & |
AdX 프로토콜 권장 신호
다음 표는 데스크톱 및 모바일 웹과 모바일 앱의 모든 동영상 형식에 대한 Authorized Buyers proto의 권장 신호를 보여줍니다.
데스크톱 및 모바일 웹
동영상 형식 | 추천 동영상 관련 신호 | 관련 동영상 관련 신호 |
---|---|---|
인스트림 (VPAID) |
동영상 메시지 및 |
|
인스트림 (VPAID 없음) |
동영상 메시지 및 |
Allowed_video_formats = VIDEO_HTML5 & |
인피드 광고 |
동영상 메시지 및 |
Allowed_video_formats = VIDEO_HTML5 & |
인아티클 광고 |
동영상 메시지 및 |
|
네이티브 |
네이티브 메시지 내에 NATIVE 메시지 및 |
|
인배너 |
|
|
모바일 앱
다음 표는 데스크톱 및 모바일 웹과 모바일 앱의 모든 동영상 형식에 대한 AdX proto의 권장 신호를 보여줍니다.
동영상 형식 | 동영상 관련 입찰 요청 세부정보 | 동영상 관련 관련 신호 |
---|---|---|
인스트림 |
동영상 메시지 있음 |
|
인피드 광고 |
동영상 메시지 및 |
|
인아티클 광고 |
VIDEO 메시지 및 |
|
네이티브 |
네이티브 메시지 내에 NATIVE 메시지 및 |
|
전면 광고 |
동영상 메시지 및 |
|
인배너 (MRAID) |
|
|
인배너 (MRAID 없음) |
|
|
게시자가 동영상을 허용/금지할 수 있는 방법
다음 표에서는 게시자가 게재위치에서 동영상을 허용하거나 허용하지 않을 수 있는 방법 및 OpenRTB 및 AdX Proto의 입찰 요청에서 어떻게 명시하는지를 보여 줍니다.
OpenRTB
펍 옵션 | 적용 가능한 형식 | 입찰 요청에서 다음과 같이 설명됩니다. |
---|---|---|
인스트림 동영상에 광고 단위 지정 |
인스트림 (모두) |
동영상 객체 존재 및 |
VPAID 선택 |
인스트림 웹 |
Video 객체 및 |
IBV 선택 |
인배너 전면 광고 |
|
아웃스트림 선택 (instructions) |
인피드 광고 인아티클 광고 |
동영상 객체 있음 |
아웃스트림 선택 (instructions) |
네이티브 |
네이티브 객체 있음 |
동영상 전면 광고 차단 |
전면 광고 앱 |
VIDEO 객체가 없음 |
AdX Proto
펍 옵션 | 적용 가능한 형식 | 입찰 요청에는 다음과 같이 설명됩니다. (참고: 입찰 요청의 게시자 옵션을 나타내는 모든 지표입니다. 권장 신호는 아래 표를 참고하세요.) | 기본 설정 |
---|---|---|---|
인스트림 동영상에 광고 단위 지정 |
인스트림 (모두) |
동영상 메시지 있음 및 |
해당 사항 없음 |
VPAID 선택 |
인스트림 웹 |
동영상 메시지 있음 및
|
선택 해제됨 |
IBV 선택 |
인배너 전면 광고 |
|
선택 해제됨 |
아웃스트림 선택 (instructions) |
인피드 광고 인아티클 광고 |
동영상 메시지 있음 및 |
선택 해제됨 |
아웃스트림 선택 (instructions) |
네이티브 |
NATIVE 메시지 있음 및 네이티브 메시지 내 |
선택 해제됨 |
동영상 전면 광고 차단 |
전면 광고 앱 |
동영상 메시지가 없음 |
선택됨 |
특이 사례
# | 케이스 설명 | 설명 | 입찰 요청 |
---|---|---|---|
1 |
MRAID를 사용한 지연된 맞춤 닫기 |
전면 광고의 경우 맞춤 닫기를 사용하지 않았더라도 광고를 닫으면 MRAID를 사용하는 구매자에게 알림이 전송될 수 있습니다. AdX가 적용된 X는 맞춤 닫기가 5초 후에 표시되더라도 항상 모든 맞춤 닫기 위에 표시됩니다. |
용어 설명
Authorized Buyers 동영상 용어집을 참조하세요.
인스트림 및 아웃스트림 형식의 AdX 및 OpenRTB 필드
AdX Proto
BidRequest.Video에 연결합니다. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
OpenRTB Proto
OpenRTB 2.5 (47페이지부터)를 참조하세요.
BidRequest.Video에 연결합니다. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
노출이 선형인지, 비선형인지 등인지를 나타냅니다. 아무것도 지정하지 않으면 모두 허용된다고 가정합니다.
|
||||
videoad_start_delay
|
|
입찰 요청 값 소스
OpenRTB 객체 | 필드 | AdX /Exchange 입찰 아웃스트림 |
샘플 값 | 누가 결정하나요? /이 값의 출처는 인가요? |
---|---|---|---|---|
객체 | ||||
동영상 | MIME | 예 | ["application/javascript", "video/mp4"]", |
|
최소 기간 | 아니요 | 게시자 구성됨 | ||
최대 지속 시간 | 예 | 게시자 구성됨 | ||
재생 가능 hod |
예 | [6] | 일반적으로 게시자 구성됨 |
|
api (MRAID) | 예 | [1,2] | ||
protocols(프로토콜) | 예 | [2,3,5,6,7,8] | ||
선형성 | 예 | [1] | ||
게재위치 | 예 | [1] | ||
플레이어 너비 | 예 | 400,400,300 | ||
플레이어 높이 | 예 | 225,300,153 | ||
시작 지연 | 예 | 0 | Google, 기본값 5초 | |
건너뛰기 | 예 | 1 | 게시자/Google - 전면 광고의 경우 => Google - 인스트림의 경우 가 건너뛸 수 있는 광고, 건너뛸 수 없는 광고 또는 둘 다를 허용할지 결정합니다. 건너뛸 수 없는 보상형 광고 |
|
최소 비트 전송률 | No | |||
최대 비트 전송률 | 아니요 | |||
pos | 예 | 1 | ||
기기 | ||||
Px 비율 | 예 | 1 | ||
노출(수) | ||||
보안 | 예 | 1 | Google 의 기본값은 true 로 설정됩니다. 광고 태그는 항상 안전하기 때문입니다. |