이 가이드에서는 통합 요구사항, 구성, 동영상에 입찰할 때 사용할 수 있는 관련 OpenRTB 프로토콜 필드 있습니다. Google RTB 프로토콜은 지원 중단되었으며 이 가이드에서는 다루지 않습니다. Google RTB 프로토콜의 동영상 광고에 대한 자세한 내용은 Google RTB의 동영상 광고 가이드를 참조하세요.
Google에서는 인스트림 광고, 네이티브 광고, 전면 광고 동영상을 지원합니다. 이러한 형식에 관한 자세한 내용은 네이티브 및 전면 광고 형식 가이드를 참고하세요.
구매자 요구사항
RTB 프로토콜
이 가이드에서는 일반적으로 Protobuf 형식을 참조하지만 필드 이름과 경로는 달리 명시되지 않는 한 그것과 JSON 형식에서 동일합니다.
OpenRTB 프로토콜 및 Google 전용 OpenRTB 확장 프로그램은 Protos 및 참조 데이터 페이지 대상 입찰자 개발에 대해 자세히 알아보려면 요청 처리 응답 작성.
광고 소재 검토
승인을 위해 입찰 전에 광고 소재를 제출하여 있습니다. 실시간 입찰 API의 광고 소재 리소스를 사용하여 검토 절차를 시작할 수 있습니다.
사전 타겟팅 구성
동영상 인벤토리를 수신하려면 Authorized Buyers 계정이 만들기 사전 타겟팅 구성 동영상 인벤토리도 포함됩니다
매크로
동영상 URL 링크 또는
BidResponse.seatbid.bid.adm 또한 동영상 또는
URL에 있는 경우 연결된 VAST XML 문서 내에 매크로를 배치할 수도 있습니다. 동영상 광고 소재에는 다음 매크로가 지원됩니다.
%%CACHEBUSTER%%%%WINNING_PRICE%%%%SITE%%
Authorized Buyers에서 VAST 래퍼에 클릭 추적 광고를 포함하므로 CLICK_URL_ESC와 같은 클릭 매크로는 지원되지 않습니다. 자세한 내용은
자세히 알아보려면
매크로를 지정합니다.
콜아웃 세부정보
OpenRTB의 BidRequest.imp.video 필드를 사용하여
수신 입찰 요청이 인스트림 광고에 대한 것인지 또는 전면 동영상에 대한 것인지 여부
요청에 대한 추가 동영상 관련 정보를 찾을 수 있습니다.
또한 네이티브 광고 인벤토리의 경우
BidRequest.imp.native.{request/request_native}.assets.video:
유사한 동영상 관련 정보가 있을 수 있습니다.
BidRequest.{app/site}.content.producer.domain-
동영상 콘텐츠를 설명하는 페이지의 URL(매개변수가 삭제됨)입니다. 게시자가 이 URL을 Google에 제출합니다. 예를 들면 다음과 같습니다.
http://www.publisher.com/watchpagelink
banner.vcm-
true로 설정하면 동영상 광고 재생이 완료된 후 동영상 슬롯에서 엔드캡(정보 카드)으로 렌더링되도록 컴패니언 광고를 선택할 수 있습니다. 그렇지 않으면 컴패니언 광고가 엔드 캡으로 렌더링되지 않습니다. BidRequest.imp.rwdd-
true로 설정하면 사용자가 리워드를 받을 수 있습니다. 일반적인 리워드로는 무료로 추가 기사를 읽거나, 게임에서 추가 생명을 받거나, 스폰서가 제공하는 광고 없는 음악 세션을 이용하는 것이 있습니다. BidRequest.imp.video.maxduration-
반환해야 하는 광고의 최대 허용 길이(초)입니다. 설정하지 않으면 최대 기간이 없습니다. 날짜
BidRequest.imp.video.skip는true이며 다르게 작동합니다. 건너뛸 수 있는 최대 동영상 재생 시간을 참조하세요. 를 참조하세요. BidRequest.imp.video.maxseq-
동영상 광고 모음의 최대 광고 수입니다. 설정하지 않으면 광고 슬롯이 동영상 광고 모음의 일부로 설정할 수 있습니다
게재된 실제 동영상 광고 수는 이보다 작거나 같을 수 있습니다. 이 값을 초과할 수 없습니다.
BidRequest.imp.video.minduration- 반환해야 하는 광고의 최소 재생 시간(초)입니다. 설정하지 않으면 최소 기간이 없습니다.
BidRequest.imp.video.plcmt-
동영상이 재생되는 위치를 설명합니다.
PLCMT_UNKNOWN게재위치를 알 수 없거나 확인할 수 없습니다. PLCMT_INSTREAM광고가 재생되기 전에 재생되는 프리롤, 미드롤, 포스트롤 광고 스트리밍 동영상 콘텐츠 재생 도중 또는 이후에 재생 있습니다. 인스트림 동영상은 플레이어 시작 시 기본적으로 '소리 켜짐'으로 설정되어 있거나 동영상 콘텐츠를 시청하려는 명시적인 사용자 의도가 있어야 합니다. 동영상 제목 주변에 다른 콘텐츠가 있을 수 있지만 사용자 방문의 중심이 동영상 콘텐츠여야 합니다. 페이지의 기본 콘텐츠로 유지되어야 하며 재생 시 오디오를 재생할 수 있는 유일한 동영상 플레이어여야 합니다. 플레이어가 플로팅/고정으로 전환되면 후속 광고 호출에서 업데이트된 플레이어 크기를 정확하게 전달해야 합니다. PLCMT_ACCOMPANYING_CONTENT광고가 재생되기 전에 재생되는 프리롤, 미드롤, 포스트롤 광고 전후 또는 중간에 표시되는 광고입니다 동영상 플레이어는 텍스트 또는 그래픽 콘텐츠의 단락 앞, 중간 또는 뒤에 로드되고 재생되며 표시 영역으로 들어올 때만 재생을 시작합니다. 함께 표시되는 콘텐츠는 표시 영역에 진입할 때만 재생을 시작해야 합니다. 페이지를 스크롤할 때 플로팅/고정 플레이어로 전환될 수 있습니다. PLCMT_INTERSTITIAL동영상 콘텐츠 없이 재생되는 동영상 광고입니다. 재생 중에는 페이지의 주요 초점이 되어야 하며 표시 영역의 대부분을 차지해야 하며 스크롤하여 표시 영역 밖으로 나갈 수 없습니다. 가능한 시간은 인앱 동영상 또는 슬라이드쇼와 같은 게재위치와 PLCMT_NO_CONTENT_STANDALONE동영상 콘텐츠를 스트리밍하지 않고 재생되는 동영상 광고입니다. 슬라이드쇼, 네이티브 피드, 인콘텐츠 또는 고정/플로팅과 같은 게재위치에 있을 수 있습니다. BidRequest.imp.video.playbackmethod-
동영상 광고를 재생하는 방법을 설명합니다.
재생 방법이 자동재생 또는 클릭 재생방식인지 결정됩니다.
가용한 최상의 측정값을 기준으로 합니다.
AUTO_PLAY_SOUND_ON사운드가 켜진 상태로 페이지 로드가 시작됩니다. AUTO_PLAY_SOUND_OFF페이지 로드 시 사운드를 끄고 시작합니다. CLICK_TO_PLAY소리가 켜진 상태에서 클릭하면 시작됩니다. MOUSE_OVER사운드가 켜진 상태에서 마우스 오버 시 시작됩니다. ENTER_SOUND_ON사운드가 켜진 상태에서 표시 영역을 진입하면 시작됩니다. ENTER_SOUND_OFF기본적으로 표시 영역에 진입할 때 음소거된 상태로 시작됩니다. BidRequest.imp.video.skiptrue인 경우 플레이어에서 동영상을 허용하는 것입니다. 건너뛸 수 있는지 아니면 건너뛸 수 있는 광고가 허용되는지를 확인할 수 있습니다. 그렇지 않으면 건너뛸 수 있는 광고가 허용되지 않음을 나타냅니다.BidRequest.imp.video.startdelay-
0은 프리롤, -1은 미드롤 및 -2를 의미합니다. 이는 포스트롤을 의미합니다.
다른 양수 값은 동영상 시작부터 광고가 표시되는 지점까지의 시간(초)입니다.
이러한 신호는 동영상 광고 소재에만 국한되지 않습니다. 특히 입찰자가 읽을 때 유용합니다.
BidRequest.device.ifa- 이 필드는 SSL을 사용할 때만 설정되는 36자 UUID이며 해싱되지 않습니다.
BidRequest.device.dpidm5의 암호화되지 않은 버전입니다. iOS 기기의 경우 광고주용 식별자(IDFA)가 모두 대문자로 포함됩니다. Android Android 식별자 (ADID)가 모두 소문자로 포함됨 있습니다. 커넥티드 TV 기기의 경우 고유 식별자가 포함됩니다. (예: Roku의 RIDA) BidRequest.device.devicetype- 기기 유형을 지정합니다.
MOBILEHIGHEND_PHONE 또는 TABLET의 더 이상 사용하지 않는 별칭입니다. PERSONAL_COMPUTER데스크톱 및 노트북 기기가 포함됩니다. CONNECTED_TV커넥티드 TV (스마트 TV)와 커넥티드 TV (예: Roku, Apple TV 등) HIGHEND_PHONE고급형 휴대전화 기기 포함 TABLET태블릿 기기를 포함합니다. CONNECTED_DEVICE전용 게임 기기가 포함됩니다. SET_TOP_BOX셋톱 박스 기기가 포함됩니다. OOH_DEVICE옥외 광고 기기 포함 예: 디지털 옥외 광고판 BidRequest.device.make- 기기의 브랜드(예: Nokia 또는 Samsung)를 지정합니다.
BidRequest.device.model- 다음의 경우 기기의 정확한 모델 (예: N70 또는 Galaxy)을 지정합니다. 사용할 수 있으며, 그 밖의 경우에는 'iphone'과 같은 일반 모델이 포함됨 또는 'ipad' 등)입니다.
BidRequest.imp.metric-
Metric.type를completion_rate로 설정하면Metric.value는 [0.0, 1.0] 범위의 분수가 됩니다. 광고에 게재된 동영상 광고의 이전 완료율을 나타냄 있습니다. 기본값-1.0은 이전 완료율 데이터를 사용할 수 없음을 나타냅니다. BidRequest.imp.video.poddur- 모든 슬롯을 포함한 전체 광고 시점의 시간(초) 포드를 구성합니다 이 값은 동영상 게시자가 제공하는 동영상 메타데이터입니다.
동영상 입찰 요청에는 인벤토리에 대한 정보도 포함되어 있습니다. 채널 정보 등의 정보를 수집합니다. 입찰 요청의 다른 모든 기존 필드도 동영상에 적용됩니다.
AdSlot 메시지의 너비 및 높이 필드 동영상 광고 플레이어의 크기에 해당합니다.
BidRequest.imp.ext.allowed_vendor_type- 허용된 공급업체입니다. ID 목록은 기술 문서의 vendors.txt 파일을 참고하세요. 예: 309 = Campaign Manager 동영상 단위
BidRequest.imp.video.mimes- 입찰 요청에 대한 응답으로 게재되는 광고에 지원되는 콘텐츠 MIME 유형을 설명하는 허용 목록입니다(예: 'video/mp4'). 입찰 응답은 허용된 동영상 기술 중 하나 이상에 대한 지원을 나타내야 합니다.
BidRequest.imp.video.protocols-
동영상 광고 요청에 대해 게시자가 지원하는 VAST 버전을 설명합니다.
VAST_2_0,VAST_3_0,VAST_2_0_WRAPPER,VAST_3_0_WRAPPER,VAST_4_0,VAST_4_0_WRAPPER등을 비롯한Protocolenum 값 배열을 포함합니다.
BidRequest.imp.video.companionad-
이 필드에는 이 필드를 나타내는
Banner객체의 배열이 사용할 수 있는 경우 컴패니언 광고를 게재합니다. BidRequest.site.page-
동영상 보기 페이지의 URL 또는 동영상이 삽입된 페이지의 URL입니다. 예를 들면 다음과 같습니다.
http://www.publisher.com/watchpagelink
동영상 요청에 응답할 때 입찰자는 VAST 리디렉션을 반환해야 합니다.
URL 또는 VAST XML을 BidResponse.seatbid.bid.adm 입력란에 입력합니다. 입찰 응답에는 동영상 광고에 대한 올바른 선언도 포함되어야 합니다. 이
다음은 동영상 입찰 응답을 발췌한 것입니다.
id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
bid {
id: "99862J52T2r9f8n6hzY"
impid: "1"
price: 0.2873480215418293
adid: "test_creative_id_958969"
adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
adomain: "google.com"
cid: "80831705186"
crid: "test_creative_id_958969"
w: 480
h: 854
}
seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"
동영상 입찰 응답에서 중요한 필드는 다음과 같습니다.
BidResponse.seatbid.bid.ext.attribute-
이 스니펫에서 게재할 수 있는 광고의 속성입니다. 자세한 내용은
buyer-declarable-creative-attributes.txt
파일을 찾습니다. 이러한 속성이 입찰 요청에서 게시자가 허용하지 않은 속성과 일치하지 않는지 확인합니다.
예를 들어 두 필드 중 하나에
30가 포함되어 있으면 렌더링하기 위해 VPAID 지원이 필요함을 나타냅니다. BidResponse.seatbid.bid.adm-
동영상 광고의 경우 동영상 광고의 VAST 리디렉션 URL입니다. 예를 들어 다음과 같습니다.
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml원시 VAST XML일 수도 있습니다.
입찰 요청 및 응답의 예
동영상 형식
- 구매자가 동영상을 포함할 수 있는 방법
- 모든 동영상 형식에 권장되는 OpenRTB 신호
- 모든 동영상 형식에 권장되는 Authorized Buyers 프로토 신호
- 게시자가 동영상을 허용/차단하는 방법
- 특이 사례
구매자가 동영상을 포함하는 방법
다음 표는 구매자가 광고 소재에 동영상을 포함하고 웹과 모바일 앱에 각각 게재될 수 있는 게재위치
웹
| 동영상 광고 소재 | 인스트림(전체) | 인피드/아티클 광고 | 네이티브 인피드 광고/도움말 | 전면 광고 | 인배너 |
|---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
맞춤 JS |
|
||||
네이티브 + VAST |
|
모바일 앱
| 동영상 광고 소재 | 인스트림(전체) | 인피드/아티클 광고 | 네이티브 인피드 광고/도움말 | 전면 광고 | 인배너 |
|---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
맞춤 JS |
|||||
네이티브 + VAST |
| 키: | 사용할 수 없는 형식/기술 | 이 게재위치에서 동영상 광고 소재가 허용되며, 게시자 차단이 적용됩니다. |
이 게재위치에서 사용할 수 없는 동영상 광고 소재 |
|---|
OpenRTB 권장 신호
다음 표에서는 모든 동영상 형식에 대한 OpenRTB 권장 신호를 데스크톱 및 모바일 웹, 모바일 앱입니다.
데스크톱 및 모바일 웹
| 동영상 형식 | 추천 신호(동영상 관련 신호만 해당) | 관련 신호(동영상 관련 신호만 해당) |
|---|---|---|
인스트림(VPAID) |
VIDEO 객체 있음 & |
|
인스트림(VPAID 없음) |
VIDEO 객체 있음 & |
|
비인스트림 |
VIDEO 객체 있음
|
|
인피드 광고 |
VIDEO 객체가 있음 & |
|
콘텐츠 내 자동 삽입 |
VIDEO 객체가 있음 & |
|
네이티브 |
NATIVE 객체가 있음 및 |
|
인배너 |
동영상 객체 없음 & |
모바일 앱
| 동영상 형식 | 입찰 요청 세부정보 (동영상 관련 세부정보만) | |
|---|---|---|
인스트림 |
VIDEO 객체 있음 & |
|
비인스트림 |
VIDEO 객체 있음
|
|
인피드 광고 |
VIDEO 객체가 있음 & |
|
콘텐츠 내 자동 삽입 |
VIDEO 객체가 있음 & |
|
네이티브 |
NATIVE 객체 존재 및 |
|
전면 광고(VAST) |
VIDEO 객체가 있음 & |
|
전면 광고(VAST 없음) |
VIDEO 객체가 있음 & |
필터링됨 |
인배너 (MRAID) |
동영상 객체 없음 & |
|
인배너 (MRAID 없음) |
동영상 객체 없음 및 |
게시자가 동영상을 허용/허용하지 않는 방법
다음 표는 게시자가 게재위치에서 동영상을 허용/허용하지 않는 방법을 보여줍니다.
| Pub 옵션 | 적용 가능한 형식 | 입찰 요청에서 |
|---|---|---|
인스트림 동영상을 광고 단위로 지정 |
인스트림(전체) |
동영상 객체가 있음 & |
VPAID 선택 |
인스트림 웹 |
동영상 객체가 있고 |
IBV 선택 |
인배너 전면 광고 |
|
을(를) 선택합니다(안내). |
인피드 광고 인아티클 광고 |
동영상 객체가 있음 및 |
인스트림이 아닌 광고 선택(안내) |
네이티브 |
네이티브 객체 있음 |
동영상 전면 광고 차단 |
앱 전면 광고 |
VIDEO 객체가 없음 |
특이 사례
| # | 케이스 설명 | 댓글 | 입찰 요청 |
|---|---|---|---|
1 |
MRAID를 사용한 맞춤 닫기 지연 |
전면 광고의 경우 광고를 닫으면 맞춤 닫기를 사용하지 않은 경우에도 MRAID를 사용하여 구매자에게 알림을 보낼 수 있습니다. 적용된 Authorized Buyers X는 항상 맞춤 닫기(5초 후 맞춤 닫기가 아래에 표시되더라도) |
용어 설명
를 참조하세요. Authorized Buyers 동영상 용어집을 참조하세요.
인스트림 및 비인스트림 형식의 관련 필드
OpenRTB 2.5(47페이지부터 시작)를 참고하세요.
| BidRequest.Video. | |||||
|---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
노출이 선형, 비선형 등이어야 하는지 여부를 나타냅니다. 아무것도 지정하지 않으면 모두 허용된다고 가정합니다.
|
||||
videoad_start_delay
|
|
||||
입찰 요청 값 소스
| OpenRTB 개체 |
필드 | Authorized Buyers /Exchange Bidding Non-instream |
샘플 값 | 누가 결정하나요? /이 값은 어디에서 가져옵니까? |
|---|---|---|---|---|
| 객체 | ||||
| 동영상 | MIME | 예 | ["application/javascript", "video/mp4"]", |
|
| minduration | 아니요 | 게시자 구성됨 | ||
| maxduration | 예 | 게시자 구성됨 | ||
| playbackmet 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 - 인스트림 광고의 경우 => 게시자 건너뛸 수 있는 광고, 건너뛸 수 없는 광고 또는 둘 다를 허용할지 결정합니다. 보상형 광고(항상 건너뛸 수 없음) |
|
| 최소 비트 전송률 | 아니요 | |||
| 최대 비트 전송률 | 아니요 | |||
| pos | 예 | 1 | ||
| 기기 | ||||
| 픽셀 비율 | 예 | 1 | ||
| 노출(수) | ||||
| 보안 | 예 | 1 | Google 기본값은 true 입니다. 광고 태그가 항상 이기 때문입니다. 보안 |