OpenRTB 동영상 광고

이 가이드에서는 OpenRTB 프로토콜을 사용한 RTB 구매의 통합 요구사항을 설명합니다. 이 가이드는 여기서 설명하는 필드가 자세히 설명된 OpenRTB 통합 가이드와 함께 사용해야 합니다.

<video> 태그가 포함된 HTML 스니펫이 있는 iOS 앱에서 구매하는 경우 동영상 태그에 playsinline 속성을 포함해야 합니다. 그러지 않으면 광고 소재 내에서 재생되어야 하는 동영상 광고가 전체 화면에 튀어나오는 등 사용자의 사용 환경이 매우 열악해집니다. 이를 준수하지 않는 광고는 차단됩니다.

구매자 요구사항

신규 RTB 구매자는 최신 프로토콜 버퍼와 다음 섹션에서 설명하는 정보를 사용하여 입찰자를 개발해야 합니다. 프로토콜을 다운로드하려면 참조 데이터 페이지를 확인하세요. 입찰자 개발에 관한 자세한 내용은 요청 처리 및 응답 작성을 참고하세요.

지원되는 매크로

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

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

매크로 대체는 동영상 URL에서는 허용되지만 실제 VAST XML 내에서는 허용되지 않습니다.

Authorized Buyers는 VAST 래퍼에 클릭 추적기를 포함하므로 클릭 매크로 (예: CLICK_URL_ESC)가 필요하지 않습니다. 인스트림 광고에서는 클릭 매크로가 지원되지 않습니다. 지원되는 매크로에 관한 자세한 내용은 응답 빌드에서 매크로 지정을 참고하세요.

동영상 객체 세부정보

OpenRTB 프로토콜은 openrtb-proto.txt 파일에 정의된 Video 메시지를 사용하여 동영상 요청을 식별하고 해당 요청에 대한 추가 동영상 관련 정보를 제공합니다.

자세한 설명과 예시는 OpenRTB 통합 가이드의 동영상 메시지 필드 목록을 참조하세요.

기타 동영상 입찰 요청 필드

아래의 신호는 모두 동영상 광고 소재에만 적용되는 것은 아니지만 입찰 요청의 핵심 요소입니다.

Imp 객체 필드

이 객체는 입찰 중인 광고 게재위치 또는 노출을 설명합니다.

banner	배너 객체로, 노출이 배너 광고 기회로 제공되는 경우 필요합니다.
video	제공되는 노출 유형을 나타냅니다(이 경우 동영상). 인배너 동영상은 imp 객체에 banner 및 video 객체가 모두 포함된 경우 허용됩니다.
tagid	입찰을 시작하는 데 사용된 특정 광고 게재위치 또는 광고 태그의 식별자입니다. 이는 모든 문제를 디버깅하거나 구매자의 최적화에 유용할 수 있습니다.
bidfloor	CPM으로 표시되는 이 노출에 대한 최소 입찰가입니다.
bidfloorcur	포함된 billing_id.에서 가져온 단일 통화

자세한 내용은 OpenRTB 가이드의 노출 객체 섹션을 참조하세요.

기기 객체 필드

Device 객체의 필드는 대상 기기에 관한 정보를 제공합니다.

ua	브라우저 사용자 에이전트 문자열입니다.
ip	기기에서 가장 가까운 IPv4 주소입니다.
geo	Geo 객체로 정의된 사용자의 현재 위치로 추정되는 기기의 위치입니다.
devicetype	일반적인 기기 유형입니다.
ifa	명확한 광고주 사용을 위해 제재된 ID입니다 (예: 해싱되지 않음). ifa는 Roku, Apple TV, Fire TV, Xbox와 같은 커넥티드 TV 기기에서 지원됩니다.

자세한 내용은 OpenRTB 가이드의 기기 객체 섹션을 참조하세요.

사이트 객체

Site 객체의 필드는 광고 지원 콘텐츠가 있는 사이트에 대한 정보를 제공합니다.

page	노출이 표시될 페이지의 URL입니다.
publisher	사이트의 Publisher 객체에 관한 세부정보입니다.
content	사이트 내 Content에 관한 세부정보

자세한 내용은 OpenRTB 가이드의 사이트 객체 섹션을 참조하세요.

사용자 객체

User 객체의 필드는 광고 지원 콘텐츠가 있는 사이트에 대한 정보를 제공합니다.

id	사용자의 Exchange별 ID입니다. id 또는 buyerid 중 적어도 하나가 권장됩니다.
data	사이트의 Publisher 객체에 관한 세부정보입니다.

자세한 내용은 OpenRTB 가이드의 사용자 객체 섹션을 참조하세요.

입찰 요청 인벤토리 필드

동영상 입찰 요청에는 콘텐츠 유형 및 지정된 컴패니언 광고에 관한 정보도 포함됩니다.

mimes

지원되는 콘텐츠 MIME 유형의 허용 목록입니다.

companionad

컴패니언 광고를 사용할 수 있는 경우 Banner 객체의 배열입니다.

입찰 응답 필드

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

id

이 응답이 대상인 입찰 요청의 ID입니다.

seatbid

Seatbid 객체의 배열입니다. 입찰을 하려면 하나 이상이 필요합니다.

seat

Seatbid 객체로, 이 입찰이 이루어지는 구매자 시트의 ID입니다 (예: 광고주, 대행사).

bid

각각 노출과 관련된 하나 이상의 입찰 객체의 배열입니다.

사전 타겟팅

동영상 인벤토리를 수신하려면 OpenRTB 구매자에게 동영상 인벤토리가 포함된 사전 타겟팅 구성이 있어야 합니다.

입찰 요청 및 응답 예

입찰 요청

보기

{
  id: "XIsz9QAHfAYKj3oDMQ3QOg",
  imp: [{
    id: "1",
    banner: {
      w: 300,
      h: 250,
      format:     [{
        w: 300,
        h: 250
      },{
        w: 250,
        h: 250
      }],
      battr:     [5]
    },
    video: {
      mimes:     [video/mp4],
      linearity: 1,
      protocols:     [2,3,5,6],
      w: 300,
      h: 250,
      skip: 1,
      battr:     [5],
      playbackmethod:     [6],
      plcmt: 3
    },
    displaymanager: "GOOGLE",
    tagid: "2111189154",
    bidfloor: 0.01,
    bidfloorcur: "USD",
    secure: 1,
    native: {
      request_native: {
        ver: "1.2",
        assets:       [{
          id: 1,
          required: 1,
          title: {
            len: 25
          }
        },{
          id: 2,
          data: {
            type: 2,
            len: 90
          }
        },{
          id: 3,
          data: {
            type: 12,
            len: 15
          }
        },{
          id: 4,
          data: {
            type: 1,
            len: 25
          }
        },{
          id: 5,
          img: {
            type: 3,
            wmin: 1200,
            hmin: 627
          }
        },{
          id: 6,
          img: {
            type: 2,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 7,
          img: {
            type: 1,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 8,
          data: {
            type: 3,
            len: 5
          }
        },{
          id: 9,
          video: {
            mimes:           [video/mp4]
          }
        }],
        eventtrackers:       [{
          event: 1,
          methods:         [1]
        }],
        adx_ext: {
          style_id: 188961,
          style_height: 250,
          style_width: 300
        }
      },
      ver: "1.2",
      battr:     [5]
    },
    metric:   [{
      type: "click_through_rate",
      value: 0.0006341254338622093,
      vendor: "EXCHANGE"
    },{
      type: "video_completion_rate",
      value: 0.017279919236898422,
      vendor: "EXCHANGE"
    },{
      type: "viewability",
      value: 0.7,
      vendor: "EXCHANGE"
    },{
      type: "session_depth",
      value: 1,
      vendor: "EXCHANGE"
    }],
    adx_ext: {
      billing_id:     [12345567890],
      publisher_settings_list_id:     [5509324247698256194,14109776396365339331],
      allowed_vendor_type:     [3,42,79,4463,4513,4538,4625],
      ampad: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED"
    }
  }],
  site: {
    page: "https:/example.com/school",
    publisher: {
      id: "pub-783270600012345",
      adx_ext: {
        country: "IN"
      }
    },
    content: {
      contentrating: "DV-G",
      language: "en"
    },
    mobile: 1,
    adx_ext: {
      amp: "DIALECT_HTML"
    }
  },
  device: {
    ua: "Mozilla/5.0 (iPad; CPU OS 12_1_4 like Mac OS X) FBOP/5;FBRV/0]",
    ip: "121.222.242.0",
    geo: {
      lat: -26.487831115722656,
      lon: 153.0424346923828,
      country: "AUS",
      region: "AU-QLD",
      zip: "4562",
      utcoffset: 600
    },
    make: "apple",
    model: "ipad",
    os: "iOS",
    osv: "12.1.1",
    w: 768,
    h: 1024,
    pxratio: 2,
    devicetype: 5
  },
  user: {
    id: "CAESEK6jGeddIeo_opp-WrY",
    buyeruid: "anFTbmRJMVF3VXy0",
    customdata: "anFTbmRJMVVXy0",
    data:   [{
      id: "DetectedVerticals",
      name: "DoubleClick",
      segment:     [{
        id: "1263",
        value: "0.5"
      },{
        id: "625",
        value: "0.1"
      }]
    }]
  },
  at: 2,
  tmax: 122,
  cur: [USD],
  bcat: [IAB7-39],
  adx_ext: {
    google_query_id: "ANy-zJFcyG8sUO0_hYbujPqNXbB3bPA"
  }
}

입찰 응답

보기

{
  "id": "AB1abcDEfghijklMno2pqr",
  "seatbid": [
    {
      "seat": "Example Seat",
      "bid": [
        {
          "id": "12345678901234567890",
          "impid": "1",
          "price": 15,
          "adid": "AB1234-1234",
          "adm": "https://example.com/AdX/win?tag=AbcdEfGhIJ0kLMN2OPQ2RST3UVXyZAB2Cde114eF
          "cid": "12345678901",
          "crid": "1234",
          "adomain": [
            "www.example.com"
          ]
        }
      ]
    }
  ],
  "cur": "USD",
  "bidid": "1234567890123456789"
}

용어 설명

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