AdX 동영상 통합 가이드

개요

동영상 광고 지원 기능이 출시되면서 AdX 구매자가 Ad Exchange를 통해 인스트림 동영상 인벤토리를 구매할 수 있게 되었습니다. 이 페이지에는 RTB 기반 구매의 통합 요건에 대한 설명이 나와 있습니다.

RTB 구매자에 대한 요건

신규 RTB 구매자는 최신 프로토콜 버퍼와 아래 섹션에 설명된 정보를 이용해 자체 입찰자를 개발해야 합니다. 프로토콜을 다운로드하려면 실시간 입찰 다운로드 페이지를 참조하세요. 입찰자 개발에 대해 자세히 알아보려면 입찰 요청 처리입찰 응답 만들기를 참조하세요.

지원되는 매크로

인스트림 동영상 광고 소재에서 지원되는 매크로는 다음과 같습니다.

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

AdX에서 VAST 래퍼에 클릭 추적 도구가 포함되어 있으므로 클릭 매크로(예: CLICK_URL_ESC)는 필요하지 않습니다. 따라서 인스트림 동영상 광고에 대해서는 클릭 매크로가 지원되지 않습니다. 지원되는 매크로에 대해 자세히 알아보려면 입찰 응답 만들기에서 매크로 지정하기를 참조하세요.

RTB 콜아웃에 대한 세부정보

실시간 입찰 프로토콜은 real-time-bidding-proto.txt 에 정의된 동영상 메시지를 이용해 인스트림 동영상 요청을 확인하고 해당 동영상 요청에 대한 추가 정보를 제공합니다.

아래의 표에는 중첩된 동영상 메시지의 각 필드에 대한 세부 설명과 예가 나와 있습니다.

필드 이름 설명
videoad_start_delay

광고가 게재될 때 동영상 시작 시점으로부터의 시간(밀리초). 0은 프리롤이라는 뜻이고, -1은 포스트롤이라는 뜻입니다.그 외의 양수값은 슬롯이 동영상 중간에 있다는 뜻입니다.

이 매개변수가 설정된 경우에만 유효한 값입니다.매개변수가 설정되지 않으면 표시 위치를 알 수 없습니다.

0 = 프리롤
x = 미드롤
-1 = 포스트롤
min_ad_duration 반환해야 하는 최소 광고 시간(밀리초)입니다. 이 값이 설정되지 않거나 0 이하의 값이면 최소 시간이 없습니다. 5000
max_ad_duration

반환되는 광고의 최대 허용 시간(밀리초)입니다.이 필드가 0으로 설정되면 최대 시간이 없다는 뜻입니다.

참고: YouTube에서는 10%의 버퍼를 허용 시간에 자동으로 추가합니다.
16500
inventory_type

요청을 전송하는 인벤토리의 유형을 지정합니다.

  • WEB_VIDEO = 0;
  • GAMES = 1;
  • MOBILE_INTERSTITIAL = 2;
1
video_ad_skippable

SkippableBidRequestType의 값이고 다음 값 중 하나를 포함합니다.

  • ALLOW_SKIPPABLE = 0;
  • REQUIRE_SKIPPABLE = 1;
  • BLOCK_SKIPPABLE = 2;

이 필드가 설정되지 않으면 기본값에 따라 건너뛸 수 있는 광고를 허용합니다.

0
skippable_max_ad_duration 반환해야 하는 광고의 최대 시간(밀리초)입니다. 이 광고가 건너뛸 수 있는 광고인 경우. 일반적으로 건너뛸 수 없는 광고에 대해 허용되는 최대 시간과는 다릅니다. 이 필드가 설정되지 않거나 0 이하의 값을 가지면 모든 시간이 허용됩니다. 0

또한 동영상 입찰 요청에는 카테고리, 허용된 업체, 채널 정보와 같은 인벤토리 관련 정보가 포함됩니다. 아래 표에는 동영상 요청 파싱에 대해 유용한 필드가 나와 있습니다. 입찰 요청에 있는 다른 기존의 필드(예: detected_vertical)는 동영상에도 적용됩니다.

또한 동영상 요청의 AdSlot 메시지에 있는 폭과 높이 필드는 동영상 플레이어의 크기와 일치합니다.

필드 이름 설명
allowed_video_format 이 요청에 대한 응답에서 게재되는 광고에 대해 허용된 동영상 기술을 설명합니다.응답은 허용된 동영상 기술 중 하나 이상에 대한 지원을 나타내야 합니다. 이와 같이 반복되는 필드에 대한 값은 아래와 같은 VideoFormat 계산에서 나옵니다.
VIDEO_FLASH = 0;
VIDEO_HTML5 = 1;
1
companion_slot

companion_slot 필드는 다음 필드를 포함하는 CompanionSlot 메시지를 나타냅니다.

높이
이 슬롯에서 사용할 수 있는 높이
너비
이 슬롯에서 사용할 수 있는 너비
CreativeFormat
광고 소재 형식은 이 컴패니언 슬롯에서 가능한 광고 소재 형식을 나타냅니다.
url 동영상 보기 페이지의 URL 또는 동영상을 삽입한 페이지의 URL입니다. 예를 들어 이 주소는 동영상의 YouTube 주소나 동영상을 삽입한 페이지의 주소를 가리킬 수 있습니다. youtube.com/video/<userid>
allowed_vendor_type 허용된 업체입니다. ID 목록을 보려면 기술 문서에 있는 vendors.txt 파일을 참조하세요.

309

vendors.txt 파일에서 309 = DFA 동영상 단위

targetable_channel

이 광고 슬롯이 속한 채널의 집합. 채널은 사이트에 있는 광고 슬롯의 집합입니다. 채널(예: '스포츠 섹션', '모든 상위 배너')을 타겟팅하여 광고 게재위치를 더욱 정교하게 조절할 수 있습니다. 채널 이름은 게시자가 제공합니다.

인벤토리는 YouTube 또는 Google 동영상 네트워크(GVN)의 동영상에서 제공되며 targetable_channel 필드 중 하나에 게시자 이름( afv_user_username)이 포함됩니다.

shortform - 엔터테인먼트

afv_user_nickosbabyfood

detected_content_labels 동영상 인벤토리의 콘텐츠 라벨은 적합한 잠재고객(전체, 14세 이상, 성인용)이나 동영상 콘텐츠가 등급 평가를 받았다는 것을 보여줍니다. 또한 YouTube 콘텐츠 라벨과 함께 하나 이상의 일반 콘텐츠 라벨이 표시될 수 있습니다. YouTube용 사용자 인터페이스 광고 캠페인이 있는 구매자는 필터를 적용하여 광고가 하나 이상의 콘텐츠 카테고리에 게재되는 것을 제한할 수 있습니다. 콘텐츠 라벨의 목록을 보려면 content-labels.txt( 다운로드 페이지)를 참조하세요.

39

content-labels.txt 파일에서 30 = 동영상 콘텐츠 등급 DV-G

동영상 요청에 응답할 때 입찰자는 video_url 필드에서 VAST 리디렉션 URL을 반환해야 합니다. 또한 입찰 응답에는 동영상 광고에 해당하는 명시가 있어야 합니다.다음은 동영상 입찰 응답에서 추출한 내용입니다.

attribute: 22
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 목록에 대한 기술 문서에서 creative-attributes.txt를 참조하세요. Google이 입찰 요청에 있는 excluded_attribute 목록에 이러한 속성이 전혀 없도록 확인합니다. HTML 스니펫이나 동영상 광고가 반환되는 경우에는 이 필드만 설정하세요.

22

creative_attributes.txt에서 22 = VASTVideo. 이는 광고를 인스트림 광고로 명시합니다.

video_url 동영상 광고의 VAST 리디렉션 URL입니다. http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

동영상 인벤토리를 수신하려는 RTB 구매자는 동영상 인벤토리를 포함하는 RTB에 대해 pre-targeting campaign을 가지고 있어야 합니다.

경고: 동일한 AdGroup에서 동영상 광고 소재와 동영상 이외의 광고 소재를 혼용하지 마세요.

다음에 대한 의견 보내기...

DoubleClick Ad Exchange Real-Time Bidding Protocol