Reklamy wideo OpenRTB

Ten przewodnik przedstawia wymagania dotyczące integracji związane z zakupami RTB za pomocą protokołu OpenRTB. Tego przewodnika należy używać razem z przewodnikiem po integracji OpenRTB, w którym szczegółowo opisano omówione pola.

Jeśli kupujesz w aplikacjach na iOS, które zawierają fragmenty kodu HTML zawierające tagi <video>, musisz w tagu wideo umieścić atrybut playsinline. W przeciwnym razie użytkownicy będą mieć bardzo słabe wrażenia, ponieważ reklamy wideo, które powinny być odtwarzane w kreacji, wydzielają się do pełnego ekranu. Reklamy, które tego nie przestrzegają, będą blokowane.

Wymagania dotyczące kupujących

Nowi kupujący powinni tworzyć licytujących, korzystając z najnowszego bufora protokołów i informacji podanych w kolejnych sekcjach. Aby pobrać protokół, wejdź na stronę danych referencyjnych. Informacje na temat tworzenia licytującego znajdziesz w artykułach Przetwarzanie żądania i Tworzenie odpowiedzi.

Obsługiwane makra

Kreacje wideo typu In-Stream obsługują te makra:

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

Pamiętaj, że zastępowanie makr jest dozwolone w adresie URL filmu, ale nie w samym pliku XML VAST.

Makra kliknięć (np. CLICK_URL_ESC) nie są konieczne, ponieważ Authorized Buyers umieszcza tagi śledzenia kliknięć w kodzie VAST. Dlatego w przypadku reklam wideo typu In-Stream makra kliknięć nie są obsługiwane. Więcej informacji o obsługiwanych makrach znajdziesz w sekcji Określanie makr w sekcji Tworzenie odpowiedzi.

Szczegóły obiektu wideo

Protokół OpenRTB używa komunikatu Video zdefiniowanego w pliku openrtb-proto.txt do identyfikowania żądań wideo i dostarczania o nich dodatkowych informacji dotyczących wideo.

Szczegółowe opisy i przykłady znajdziesz na liście pól wiadomości wideo w przewodniku po integracji OpenRTB.

Inne pola pytań o stawkę za reklamy wideo

Poniższe sygnały nie są unikalne dla kreacji wideo, ale są kluczowymi częściami pytania o stawkę.

Pola obiektów wyświetleń

Ten obiekt opisuje miejsce docelowe reklamy lub wyświetlenie biorące udział w aukcji.

banner	Obiekt banera (wymagany, jeśli wyświetlenie jest oferowane jako możliwość banera reklamowego).
video	Wskazuje typ oferowanego wyświetlenia, w tym przypadku wideo. Pamiętaj, że wideo banerowe jest dopuszczalne, jeśli obiekt imp zawiera zarówno obiekty banner, jak i video.
tagid	Identyfikator konkretnego miejsca docelowego reklamy lub tagu reklamy użytego do zainicjowania aukcji. Może to być przydatne podczas rozwiązywania problemów lub optymalizacji przez kupującego.
bidfloor	Minimalna stawka za to wyświetlenie wyrażona w CPM.
bidfloorcur	Pojedyncza waluta, uzyskana z uwzględnionej billing_id.

Więcej informacji znajdziesz w sekcji Obiekt im. w przewodniku po OpenRTB.

Pola obiektów urządzenia

Pola w obiekcie Device zawierają informacje o urządzeniu docelowym.

ua	Ciąg znaków klienta użytkownika przeglądarki.
ip	Adres IPv4 znajdujący się najbliżej urządzenia.
geo	Przyjmuje się, że lokalizacja urządzenia jest bieżącą lokalizacją użytkownika zdefiniowaną przez obiekt Geo.
devicetype	Ogólny typ urządzenia.
ifa	Identyfikator objęty sankcjami na potrzeby użycia reklamodawcy w czytelny sposób (np. bez szyfrowania). Usługa ifa jest obsługiwana na urządzeniach CTV, takich jak Roku, Apple TV, Fire TV i Xbox.

Więcej informacji znajdziesz w sekcji Obiekt urządzenia w przewodniku po OpenRTB.

Obiekt witryny

Pola w obiekcie Site zawierają informacje o witrynie zawierającej treści z reklamami.

page	Adres URL strony, na której zostanie wyświetlone wyświetlenie.
publisher	Szczegółowe informacje o obiekcie Publisher witryny.
content	Szczegółowe informacje na temat: Content w witrynie.

Więcej informacji znajdziesz w sekcji dotyczącej obiektów Site w przewodniku po OpenRTB.

Obiekt użytkownika

Pola w obiekcie User zawierają informacje o witrynie zawierającej treści z reklamami.

id	Identyfikator użytkownika właściwy dla giełdy. Zalecamy użycie co najmniej jednej z tych właściwości: id lub buyerid.
data	Szczegółowe informacje o obiekcie Publisher witryny.

Więcej informacji znajdziesz w sekcji Obiekt użytkownika w przewodniku po OpenRTB.

Pola zasobów reklamowych w pytaniu o stawkę

Pytanie o stawkę za wideo zawiera też informacje o typach treści i wszelkich określonych reklamach towarzyszących.

mimes

Lista dozwolonych typów MIME treści.

companionad

Tablica obiektów Banner, jeśli są dostępne reklamy towarzyszące.

Pola odpowiedzi na stawkę

Kluczowe pola odpowiedzi na stawkę wideo obejmują te pola:

id

Identyfikator pytania o stawkę, na które jest odpowiedź.

seatbid

Tablica obiektów Seatbid; co najmniej 1 wymagany do ustalenia stawki.

seat

Obiekt Seatbid – identyfikator stanowiska kupującego (np. reklamodawcy lub agencji), w imieniu którego składasz stawkę.

bid

Tablica z co najmniej jednym obiektem Bid, z którego każdy jest powiązany z wyświetleniem.

Kierowanie wstępne

Aby otrzymywać zasoby reklamowe wideo, kupujący korzystający z OpenRTB muszą mieć konfigurację kierowania wstępnego, która obejmuje zasoby reklamowe wideo.

Przykładowe pytanie o stawkę i odpowiedź

Pytanie o stawkę

Pokaż mi

{
  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"
  }
}

Odpowiedź na stawkę

Pokaż mi

{
  "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"
}

Glosariusz

Zobacz glosariusz wideo dotyczący Authorized Buyers.