OpenRTB-Videoanzeigen

In diesem Leitfaden werden die Integrationsanforderungen für RTB-Käufe mit dem OpenRTB-Protokoll erläutert. Dieser Leitfaden sollte in Verbindung mit dem OpenRTB-Integrationsleitfaden verwendet werden, in dem die hier beschriebenen Felder im Detail beschrieben werden.

Beim Kauf über iOS-Apps mit HTML-Snippets, die <video>-Tags enthalten, müssen Sie das playsinline-Attribut im Video-Tag angeben. Andernfalls machen die Videoanzeigen, die im Creative abgespielt werden sollten, sehr schlecht erscheinen. Anzeigen, bei denen dies nicht respektiert wird, werden blockiert.

Anforderungen für Käufer

Neue EZG-Käufer sollten ihre Bieter mit dem neuesten Protokollpuffer und den Informationen in den folgenden Abschnitten entwickeln. Informationen zum Herunterladen des Protokolls finden Sie auf der Seite Referenzdaten. Informationen zum Entwickeln einer Gebotsfunktion finden Sie unter Anfrage verarbeiten und Antwort erstellen.

Supported macros

Folgende Makros werden in In-Stream-Video-Creatives unterstützt:

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

Das Ersetzen des Makros ist in der Video-URL zulässig, aber nicht in der eigentlichen VAST-XML.

Klick-Makros wie CLICK_URL_ESC sind nicht erforderlich, da die Klick-Tracker von Authorized Buyers in einem VAST-Wrapper enthalten sind. Daher werden Klick-Makros für In-Stream-Videoanzeigen nicht unterstützt. Weitere Informationen zu unterstützten Makros finden Sie im Abschnitt Makros angeben unter Antwort erstellen.

Details zum Videoobjekt

Das OpenRTB-Protokoll verwendet eine Video-Nachricht, die in der Datei openrtb-proto.txt definiert ist, um Videoanfragen zu identifizieren und zusätzliche videospezifische Informationen zur Anfrage bereitzustellen.

Im OpenRTB-Integrationsleitfaden finden Sie eine Liste der Felder für Videonachrichten sowie detaillierte Beschreibungen und Beispiele.

Andere Felder für Gebotsanfragen für Videos

Die folgenden Signale gelten nicht alle nur für Video-Creatives, sondern sind wichtige Bestandteile der Gebotsanfrage.

Imp-Objektfelder

Dieses Objekt beschreibt ein Anzeigen-Placement oder eine Impression, die versteigert wird.

banner	Ein Bannerobjekt; erforderlich, wenn die Impression als Opportunity-Banneranzeige angeboten wird
video	Gibt die Art der angebotenen Impression an, in diesem Fall Video. In-Banner-Videos sind zulässig, wenn das imp-Objekt sowohl banner- als auch video-Objekte enthält.
tagid	ID für ein bestimmtes Anzeigen-Placement oder Anzeigen-Tag, mit dem die Auktion gestartet wurde. Dies kann bei der Behebung von Problemen oder zur Optimierung durch den Käufer nützlich sein.
bidfloor	Mindestgebot für diese Impression in CPM.
bidfloorcur	Eine einzelne Währung, die aus den enthaltenen billing_id. abgerufen wurde

Weitere Informationen finden Sie im OpenRTB-Leitfaden im Abschnitt Imp-Objekt.

Geräteobjektfelder

Die Felder im Objekt Device liefern Informationen zum Zielgerät.

ua	User-Agent-String des Browsers.
ip	IPv4-Adresse, die dem Gerät am nächsten ist.
geo	Der Standort des Geräts wird als aktueller Standort des Nutzers angenommen, der durch ein Geo-Objekt definiert wird.
devicetype	Der allgemeine Gerätetyp.
ifa	ID, die für die Verwendung durch den Werbetreibenden im Klartext genehmigt wurde (z. B. nicht gehasht). ifa wird für internetfähige Geräte wie Roku, Apple TV, Fire TV und Xbox unterstützt.

Weitere Informationen finden Sie im OpenRTB-Leitfaden im Abschnitt Geräteobjekt.

Websiteobjekt

Die Felder im Site-Objekt liefern Informationen zu der Website mit werbeunterstütztem Content.

page	URL der Seite, auf der die Impression zu sehen ist.
publisher	Details zum Publisher-Objekt der Website
content	Details zu Content auf der Website.

Weitere Informationen erhalten Sie im OpenRTB-Leitfaden im Abschnitt Site-Objekt.

Nutzerobjekt

Die Felder im User-Objekt liefern Informationen zu der Website mit werbeunterstütztem Content.

id	Plattformspezifische ID für den Nutzer. Empfohlen wird mindestens id oder buyerid.
data	Details zum Publisher-Objekt der Website

Weitere Informationen finden Sie im OpenRTB-Leitfaden im Abschnitt Nutzerobjekt.

Inventarfelder für Gebotsanfragen

Die Videogebotsanfrage enthält auch Informationen zu den Inhaltstypen und den festgelegten Companion-Anzeigen.

mimes

Zulassungsliste mit unterstützten Inhalts-MIME-Typen.

companionad

Array von Banner-Objekten, falls Companion-Anzeigen verfügbar sind

Felder für Gebotsantworten

Zu den wichtigsten Feldern in einer Videogebotsantwort gehören:

id

Die ID der Gebotsanfrage, auf die es sich um eine Antwort handelt.

seatbid

Array mit Seatbid-Objekten; eines oder mehrere erforderlich, wenn ein Gebot abgegeben werden soll

seat

Ein Seatbid-Objekt; ID der Nutzerlizenz des Käufers (z. B. Werbetreibender oder Agentur), in deren Namen dieses Gebot abgegeben wird

bid

Array mit einem oder mehreren Bid-Objekten, die jeweils einer Impression zugeordnet sind

Pre-Targeting

OpenRTB-Käufer müssen eine Pre-Targeting-Konfiguration haben, die Videoinventar enthält, um Videoinventar empfangen zu können.

Beispiel für Gebotsanfrage und -antwort

Gebotsanfrage

Einblenden

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

Gebotsantwort

Einblenden

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

Glossar

Weitere Informationen zum Authorized Buyers-Videoglossar