동영상 광고

이 가이드에서는 동영상 인벤토리에 입찰할 때 사용할 수 있는 통합 요구사항, 구성, 관련 필드를 설명합니다.

Google은 개별 광고 기회 또는 동적 동영상 광고 모음으로 표시되는 인스트림, 네이티브, 전면 동영상 광고를 지원합니다. 동적 광고 모음은 순서대로 표시되는 동영상 광고 그룹을 설명합니다. 광고 모음의 최대 재생 시간이 길이가 다양한 하나 이상의 동영상으로 나뉩니다. 이러한 형식에 대한 자세한 내용은 네이티브 및 전면 광고 광고 형식 가이드를 참고하세요.

구매자 요구사항

RTB 프로토콜

이 가이드에서는 일반적으로 Protobuf 형식을 참조하지만, 달리 명시되지 않는 한 필드 이름과 경로는 Protobuf 형식과 JSON 형식 간에 동일합니다.

OpenRTB proto 및 Google 전용 OpenRTB 확장 프로그램은 프로토 및 참조 데이터 페이지에서 확인할 수 있습니다. 입찰자 개발에 관한 자세한 내용은 요청 처리 및 응답 빌드를 참고하세요.

광고 소재 검토

Google에서는 광고 소재를 입찰에 사용하기 전에 승인을 위해 제출하는 것이 좋습니다. 실시간 입찰 API의 광고 소재 리소스를 사용하여 검토 프로세스를 시작할 수 있습니다.

사전 타겟팅 구성

동영상 인벤토리를 수신하려면 Authorized Buyers 계정에서 동영상 인벤토리를 포함하는 사전 타겟팅 구성을 만들어야 합니다.

매크로

BidResponse.seatbid.bid.adm에 지정된 동영상 URL 링크 또는 VAST XML에 매크로를 지정할 수 있습니다. 또한 동영상 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

동적 동영상 광고 모음에 게재될 수 있는 최대 광고 수입니다. poddur가 설정되어 있지만 maxseq이 설정되지 않았거나 0인 경우 동영상 광고 모음에 게재할 수 있는 광고 수에 제한이 없습니다. Google은 동적 포드만 지원합니다.

실제로 표시되는 동영상 광고 수는 이 값 이하이지만 이 값을 초과할 수는 없습니다.

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.skip
인 경우 플레이어에서 동영상을 건너뛸 수 있거나 건너뛸 수 있는 광고가 허용됨을 나타냅니다.true 그렇지 않으면 건너뛸 수 있는 광고가 허용되지 않음을 나타냅니다.
BidRequest.imp.video.startdelay

값 0은 프리롤, -1은 미드롤, -2는 포스트롤을 의미합니다.

다른 양수 값은 동영상 시작부터 광고가 표시되는 지점까지의 시간(초)입니다.

BidRequest.imp.video.durfloors 및 BidRequest.imp.audio.durfloors

구매자가 입찰할 수 있는 다양한 길이의 동영상 또는 오디오 광고 소재의 각 가격 하한선을 나타내는 DurFloors 객체의 배열입니다.

다음은 Google에서 지정한 durfloors의 예입니다.

  1. $5에서 (0, 16)초를 나타내는 {"maxdur": 16, "bidfloor": 5}
  2. $10에서 [16, 31)초를 나타내는 {"mindur": 16, "maxdur": 31, "bidfloor": 10}
  3. $20에서 [31, inf)초를 나타내는 {"mindur": 31, "bidfloor": 20}

이러한 신호는 동영상 광고 소재에만 해당하지는 않지만 입찰자가 읽기에 특히 유용합니다.

BidRequest.device.ifa
이 필드는 SSL을 사용하는 경우에만 설정되고 해싱되지 않는 36자 UUID입니다. BidRequest.device.dpidm5의 암호화되지 않은 버전입니다. iOS 기기의 경우 모든 대문자로 된 광고 식별자 (IDFA)가 포함됩니다. Android 기기의 경우 모두 소문자로 된 Android 식별자 (ADID)가 포함됩니다. 커넥티드 TV 기기의 경우 고유 식별자(예: Roku의 RIDA)가 포함됩니다.
BidRequest.device.devicetype
기기 유형을 지정합니다.
MOBILE HIGHEND_PHONE 또는 TABLET의 오래된 별칭입니다.
PERSONAL_COMPUTER 데스크톱 및 노트북 기기가 포함됩니다.
CONNECTED_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 = DFA 동영상 단위입니다.
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 등을 포함하는 Protocol enum 값의 배열을 포함합니다.
BidRequest.imp.video.companionad
이 필드에는 사용 가능한 경우 동반 광고를 나타내는 Banner 객체의 배열이 포함됩니다.
BidRequest.site.page

동영상 보기 페이지의 URL 또는 동영상이 삽입된 페이지의 URL입니다. 예를 들면 다음과 같습니다.

http://www.publisher.com/watchpagelink

동영상 요청에 응답할 때 입찰자는 BidResponse.seatbid.bid.adm 필드에 VAST 리디렉션 URL 또는 VAST XML을 반환해야 합니다. 입찰 응답에는 동영상 광고에 대한 적절한 선언도 포함되어야 합니다. 다음은 적절한 동영상 입찰 응답의 추출물입니다. 

id: "n40G42d551UX18627ao8lt"
seatbid {
  bid {
    id: "17u6BnD62h88r5q7066"
    impid: "1"
    price: 0.797848
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_987914"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 55383762512
      skadn {
        version: "4.0"
        network: "306el65O"
        itunesitem: "832461214"
        sourceapp: "977150768"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
        }
        sourceidentifier: "8396"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 20
}

동영상 입찰 응답의 중요한 필드는 다음과 같습니다.

BidResponse.seatbid.bid.ext.attribute
이 스니펫에서 게재할 수 있는 광고의 속성입니다. ID 목록은 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일 수 있습니다.

입찰 요청 및 응답 예시

동영상 형식

구매자가 동영상을 포함할 수 있는 방법

다음 표는 구매자가 광고 소재에 동영상을 포함할 수 있는 방법과 웹 및 모바일 앱에 게재될 수 있는 게재위치를 각각 보여줍니다.

웹

동영상 광고 소재 인스트림 (전체) 인피드/콘텐츠 내 네이티브 인피드/기사 전면 광고 인배너

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

맞춤 JS

 

네이티브 + VAST

 

모바일 앱

동영상 광고 소재 인스트림 (전체) 인피드/콘텐츠 내 네이티브 인피드/기사 전면 광고 인배너

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

맞춤 JS

네이티브 + VAST

키: 형식/기술을 사용할 수 없음

게시자 차단에 따라 이 게재위치에서 동영상 광고 소재가 허용됨

이 게재위치에서 동영상 광고 소재를 사용할 수 없음

OpenRTB 권장 신호

다음 표는 데스크톱 및 모바일 웹과 모바일 앱의 모든 동영상 형식에 대해 OpenRTB에서 권장하는 신호를 보여줍니다.

데스크톱 및 모바일 웹

동영상 형식 추천 신호 (동영상 관련 신호만 해당) 관련 신호 (동영상 관련 신호만 해당)

인스트림 (VPAID)

VIDEO 객체가 있음   &
video.placement = INSTREAM   &

인스트림 (VPAID 없음)

VIDEO 객체가 있음   &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

비인스트림

VIDEO 객체가 있음

video.linearity: linear
배치는 실제 배치에 따라 달라지며
값은 아래와 같습니다.
Video.startdelay = 0

인피드 광고

VIDEO 객체가 있음   &
video.placement = IN-FEED

인아티클

VIDEO 객체가 있음   &
video.placement = IN-ARTICLE

네이티브

네이티브 객체가 있고

인배너

동영상 객체가 없음 &
banner.battr ≠ 6 인배너 동영상 (자동 재생) &
banner.battr ≠ 7 인배너 동영상 (사용자 시작)

모바일 앱

동영상 형식 입찰 요청 세부정보 (동영상 관련 세부정보만 해당)

인스트림

VIDEO 객체가 있음   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 또는 2: VPAID 2.0

비인스트림

VIDEO 객체가 있음

video.linearity: linear
배치는 실제 배치에 따라 달라지며
값은 아래와 같습니다.
Video.startdelay = 0

인피드 광고

VIDEO 객체가 있음   &
video.placement = IN-FEED

인아티클

VIDEO 객체가 있음   &
video.placement = IN-ARTICLE

네이티브

네이티브 객체가 있고

전면 광고 (VAST)

VIDEO 객체가 있음   &
video.placement = INTERSTITIAL

전면 광고 (VAST 없음)

VIDEO 객체가 있음   &
video.placement = INTERSTITIAL

필터링됨

인배너 (MRAID)

동영상 객체가 없음 &
banner.battr ≠ 6 인배너 동영상 (자동 재생) &
banner.battr ≠ 7 인배너 동영상 (사용자 시작)

인배너

(MRAID 없음)

동영상 객체가 없음 &
banner.battr ≠ 6 인배너 동영상 (자동 재생) &
banner.battr ≠ 7 인배너 동영상 (사용자 시작)

게시자가 동영상을 허용하거나 허용하지 않는 방법

다음 표는 게시자가 게재위치에서 동영상을 허용하거나 허용하지 않는 방법을 보여줍니다.

게시 옵션 적용 가능한 형식 입찰 요청에 다음과 같이 설명되어 있습니다.

인스트림 동영상 광고 단위 지정

인스트림 (전체)

동영상 객체 있음 &
video.placement = INSTREAM

VPAID 선택

인스트림 웹

동영상 객체가 있고
(VPAID 1.0) 또는 2 (VPAID 2.0)이 있습니다.video.api = 1

IBV 선택

인배너

전면 광고

banner.battr ≠ 6 인배너 동영상 (자동 재생) 또는 7 인배너 동영상 (사용자 시작)

선택 (안내)

인피드 광고

인아티클

동영상 객체가 있음 및
video.placement = IN-FEED 또는 IN-ARTICLE

인스트림 외 선택 (안내)

네이티브

네이티브 객체 있음

동영상 전면 광고 차단

전면 광고 앱

VIDEO 객체가 없음

특이 사례

# 케이스 설명 댓글 입찰 요청

1

MRAID를 사용한 지연된 맞춤 닫기

전면 광고의 경우 맞춤 닫기를 사용하지 않았더라도 광고를 닫으면 MRAID를 사용하여 구매자에게 알림이 전송될 수 있습니다.


공인 구매자가 적용한 X는 맞춤 닫기가 5초 후에 아래에 표시되더라도 항상 맞춤 닫기 위에 표시됩니다.

용어 설명

Authorized Buyers 동영상 용어집을 참고하세요.

인스트림 및 비인스트림 형식의 관련 필드

OpenRTB 2.5 (47페이지부터)를 참고하세요.

BidRequest.Video.
Placement
인스트림 mWeb

1: 인스트림
2: 인배너

mApp

1: 인스트림
2: 인배너
비인스트림 mApp Interstitial

5: 전면 광고

Native

3: 인아티클
4: 인피드

Rewarded

rwdd: 부울
linearity

노출이 선형인지, 비선형인지 등을 나타냅니다. 지정된 항목이 없으면 모두 허용되는 것으로 간주합니다.

인스트림 mWeb

1: LINEAR (인스트림)

mApp

1: LINEAR (인스트림)
비인스트림 mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
인스트림 mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
비인스트림 Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

입찰 요청 값 소스

OpenRTB
객체		 필드 Authorized Buyers
/Exchange
입찰
인스트림 외		 샘플 값 누가 결정하나요?
/이 값이 어디에서 파생되었나요?
객체
동영상 mimes 예 ["application/javascript",
"video/mp4"]",		 Google
minduration 아니요 게시자 구성
maxduration 예 게시자 구성
playbackmet
hod		 예 [6] 일반적으로 게시자
구성됨
api (MRAID) 예 [1,2] Google
protocols 예 [2,3,5,6,7,8] Google
선형성 예 [1] Google
게재위치 예 [1] Google
플레이어 너비 예 400,400,300 Google
플레이어 높이 예 225,300,153 Google
시작 지연 예 0 Google, 기본 5초
건너뛰기 예 1 게시자/Google
- 전면 광고 => Google
- 인스트림 => 게시자
건너뛸 수 있는 광고, 건너뛸 수 없는 광고 또는 둘 다를 허용할지 여부를 결정합니다.

보상형 광고(항상 건너뛸 수 없음)
최소 비트 전송률 아니요 Google
최대 비트 전송률 아니요 Google
pos 예 1 Google
기기
픽셀 비율 예 1 Google
노출(수)
보안 예 1 Google은 광고 태그가 항상 보안이 유지되므로
기본적으로 true로 설정됩니다.