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
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
Felder für Gebotsantworten
Zu den wichtigsten Feldern in einer Videogebotsantwort gehören:
Pre-Targeting
OpenRTB-Käufer müssen eine Pre-Targeting-Konfiguration haben, die Videoinventar enthält, um Videoinventar empfangen zu können.