Видеореклама OpenRTB

В этом руководстве изложены требования к интеграции для RTB-покупок с использованием протокола OpenRTB. Это руководство следует использовать вместе с руководством по интеграции OpenRTB , где обсуждаемые здесь поля подробно описаны.

Если вы покупаете приложения для iOS с фрагментами HTML, содержащими теги <video> , вы должны включить атрибут playsinline в тег видео. В противном случае пользователи получают очень плохой опыт, когда видеореклама, которая должна воспроизводиться в креативе, отображается в полноэкранном режиме. Объявления, не соблюдающие это правило, будут заблокированы.

Требования покупателя

Новым покупателям RTB следует разрабатывать свои системы назначения ставок, используя последний буфер протокола и информацию, изложенную в следующих разделах. Чтобы загрузить протокол, см. страницу справочных данных . Информацию о разработке системы торгов см. в разделе «Обработка запроса и построение ответа» .

Поддерживаемые макросы

В видеокреативах In-Stream поддерживаются следующие макросы:

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

Обратите внимание, что замена макроса разрешена в URL-адресе видео, но не в самом XML-файле VAST.

Макросы кликов (например, CLICK_URL_ESC ) не нужны, поскольку авторизованные покупатели включают свои средства отслеживания кликов в оболочку VAST. Поэтому макросы кликов не поддерживаются для видеообъявлений In-Stream. Дополнительные сведения о поддерживаемых макросах см. в разделе «Указание макросов» в разделе «Построение ответа» .

Детали видеообъекта

Протокол OpenRTB использует Video , определенное в файле openrtb-proto.txt, для идентификации видеозапросов и предоставления дополнительной информации о видео, касающейся запроса.

Подробные описания и примеры см. в списке полей видеосообщений в руководстве по интеграции OpenRTB.

Другие поля запроса ставок для видео

Приведенные ниже сигналы не являются уникальными для видеокреативов, но являются ключевыми частями запроса ставки.

Поля объекта Imp

Этот объект описывает размещение или показ объявления, выставленного на аукцион.

banner	Объект Banner; требуется, если показ предлагается в виде баннерной рекламы.
video	Указывает тип предлагаемого показа, в данном случае видео. Обратите внимание, что видео в баннере разрешено, если объект imp включает в себя как banner , так и video .
tagid	Идентификатор конкретного места размещения объявления или рекламного тега, который использовался для инициирования аукциона. Это может быть полезно для устранения каких-либо проблем или для оптимизации покупателем.
bidfloor	Минимальная ставка за этот показ, выраженная в цене за тысячу показов.
bidfloorcur	Единая валюта, полученная из включенного billing_id . billing_id .

Дополнительные сведения см. в разделе «Объект Imp» в руководстве OpenRTB.

Поля объекта устройства

Поля объекта Device предоставляют информацию о целевом устройстве.

ua	Строка пользовательского агента браузера.
ip	IPv4-адрес, ближайший к устройству.
geo	Предполагается, что местоположение устройства — это текущее местоположение пользователя, определенное Geo .
devicetype	Общий тип устройства.
ifa	Идентификатор, разрешенный для использования рекламодателями в открытом виде (например, не хешированный). ifa поддерживается для подключенных телевизионных устройств, таких как Roku, Apple TV, Fire TV, Xbox.

Дополнительные сведения см. в разделе «Объект устройства» в руководстве OpenRTB.

Объект сайта

Поля объекта Site предоставляют информацию о сайте с содержанием, поддерживаемым рекламой.

page	URL страницы, на которой будет показан показ.
publisher	Подробности об объекте Publisher сайта.
content	Подробная информация о Content сайта.

Дополнительные сведения см. в разделе «Объект сайта» в руководстве OpenRTB.

Пользовательский объект

Поля объекта User предоставляют информацию о сайте с контентом, поддерживаемым рекламой.

id	Специфический для Exchange идентификатор пользователя. Рекомендуется хотя бы один из id или buyerid .
data	Подробности об объекте Publisher сайта.

Дополнительные сведения см. в разделе «Объект пользователя» в руководстве OpenRTB.

Поля ресурсов запроса ставок

Запрос ставки для видео также содержит информацию о типах контента и любых указанных сопутствующих объявлениях.

mimes

Разрешенный список поддерживаемых типов контента MIME.

companionad

Массив объектов Banner , если доступны сопутствующие объявления.

Поля ответа на запрос ставки

Ключевые поля в ответе на ставку для видео включают следующее:

id

Идентификатор запроса ставки, на который получен ответ.

seatbid

Массив объектов Seatbid ; один или несколько необходимы, если должна быть сделана ставка.

seat

Объект Seatbid ; Идентификатор места покупателя (например, рекламодателя, агентства), от имени которого делается эта ставка.

bid

Массив из одного или нескольких объектов 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"
}

Глоссарий

См. видео-глоссарий Авторизованных покупателей .