OpenRTB-Integration

In diesem Leitfaden wird die Einbindung von OpenRTB 2.5 (einschließlich Makros) und nativen Anzeigen in Authorized Buyers behandelt. Außerdem werden die einzelnen Felder im Protokoll für OpenRTB-Erweiterungen in Authorized Buyers beschrieben.

Weitere Informationen zu OpenRTB-Protokollen finden Sie in der OpenRTB-Protokolldatei. Informationen zu Authorized Buyers-Erweiterungen finden Sie in der Protokolldatei zu OpenRTB-Erweiterungen.

Die OpenRTB-Implementierung in Authorized Buyers ist in zwei ähnlichen Formaten verfügbar.

• JSON
• Protobuf: .proto-Definitionsdatei kann zum Decodieren von Nachrichten referenziert werden.

Diese Seite dient als Referenz für die Implementierung von OpenRTB durch Google und basiert auf dem Protokoll Protobuf. Wir empfehlen, dass OpenRTB-JSON-Nutzer auch in der offiziellen OpenRTB-Spezifikation nachlesen, wie diese Felder im JSON-Protokoll ausgefüllt werden.

Hinweise zur Integration

Sie sollten diesen Abschnitt vollständig lesen, bevor Sie Integrationstests starten.

Struktur dieses Dokuments

Die folgenden Tabellen enthalten Definitionen von Objekten, einschließlich des Namens des Objekts, der Angabe in der Gebotsanfrage oder Gebotsantwort, der Entsprechung in unserem Protokoll für Echtzeitgebote in Authorized Buyers sowie einigen Implementierungsdetails.

Beachten Sie auch Folgendes:

• Das Feld cid stellt die Abrechnungs-ID dar, die Sie in der Pre-Targeting-Einrichtung angegeben haben. Mit diesem Feld wird das Gebot mit einer billing_id verknüpft, die in der Gebotsanfrage gesendet wurde. Wenn die Anfrage mehr als einen cid/billing_id-Wert enthält oder aktive untergeordnete Nutzerlizenzen hat, musst du die beabsichtigte cid in deiner Antwort angeben. Wenn die Anfrage nur eine solche enthält und keine aktiven untergeordneten Lizenzen vorhanden ist, wird dieser Wert in der Antwort angenommen.
• Der Einfachheit halber wird die OpenRTB-Implementierung in den folgenden Abschnitten beschrieben.
• Sofern verfügbar, werden alle Felder in der Anfrage ausgefüllt. Wir geben niemals Nullwerte oder leere Strings weiter.
• Typen und Beschreibungen aus OpenRTB sind nicht in den Tabellen unten enthalten. Weitere Informationen findest du in der OpenRTB-Protokolldatei.
• In JSON-codierten Gebotsanfragen werden alle unten eingegebenen Felder vom Typ „t64“ oder „fix64“ als Strings gesendet, um den Verlust von Genauigkeit für 64-Bit-Integralwerte zu verhindern.
• Das OpenRTB JSON-Protokoll stellt alle bool-Felder als Ganzzahlen in der Anfrage dar, wobei 0 für false und 1 für true steht. Dies ist in der OpenRTB-Spezifikation erforderlich.

Impressionen zählen und Makros verwenden

Zur Vermeidung von Abweichungen empfehlen wir, das Feld BidResponse.seatbid[].bid[].ext.impression_tracking_url für das gesamte Inventar zu verwenden, auch für native Anzeigen.

Käufer sollten Impressions-Tracking-Pixel aus dem Creative (Anzeigen-Markup) entfernen und stattdessen das Feld impression_tracking_url (Stringarray) in die Gebotsantwort aufnehmen. In OpenRTB 2.5 kann auch BidResponse.seatbid[].bid[].burl verwendet werden. impression_tracking_url wird ausgelöst, wenn die Impression als abrechenbar gilt. Dies bietet eine höhere Genauigkeit als Tracking-Pixel, mit denen Impressionen erfasst werden können, die von der App abgerufen, aber nicht gerendert wurden, da sie vorab abgerufen wurden. Verwenden Sie für dieses Feld das verschlüsselte Makro %%WINNING_PRICE%% oder das Makro ${AUCTION_PRICE}.

Dies ist die Liste der Makros, die von impression_tracking_url und burl unterstützt werden:

• ${AUCTION_ID}: ID der Gebotsanfrage aus dem Attribut BidRequest.id.
• ${AUCTION_BID_ID}: ID des Gebots; aus dem Attribut BidResponse.bidid.
• ${AUCTION_IMP_ID}: ID der gerade gewonnenen Impression aus dem Attribut BidRequest.imp[].id.
• ${AUCTION_SEAT_ID}: ID des Bietersitzes, für den das Gebot abgegeben wurde; vom Attribut BidResponse.seatbid[].seat.
• ${AUCTION_AD_ID}: ID des Anzeigen-Markups, das der Bieter bereitstellen möchte; Aus dem Attribut BidResponse.seatbid[].bid[].adid.
• ${AUCTION_PRICE} – Preis wird mit der gleichen Währung und den gleichen Einheiten wie das Gebot gelöscht. Dieses Makro wird in AMP-Anzeigen derzeit nicht unterstützt.

Die OpenRTB-Implementierung von Google verschlüsselt AUCTION_PRICE auf sichere Weise mit dem WINNING_PRICE-Makro des Authorized Buyers-Protokolls. Weitere Informationen zum Entschlüsseln des Preises finden Sie unter Preisbestätigung entschlüsseln.

Migration zu Protobuf

Die Protobuf-Codierung ist in Bezug auf Bandbreite und Verarbeitung viel effizienter und wird daher empfohlen. Die Migration zu Protobuf ist unkompliziert, da beide Formate übereinstimmende Felder haben.

Achten Sie bei der Migration von JSON zu Protobuf darauf, dass das Feld cid als String in der Gebotsantwort eingerichtet ist. Wir verwenden dieses Feld, um das Gebot mit Ihrem billing_id in Ihrem Pre-Targeting zu verknüpfen. Ist das Gebot nicht lesbar, wird es nicht akzeptiert.

VAST- und Videounterstützung

Für VAST-Anzeigen werden standardmäßig SSL-URLs anstelle des vollständigen XML-Codes unterstützt. Anzeigenplattform-Bieter können jedoch Inline-VAST-Daten zurückgeben. Sie können diese Funktion für alle Konten aktivieren, indem Sie sich an Ihr Kontosupportteam wenden.

In OpenRTB 2.4 und höher können Käufer, wenn sie video.skip=1, mit nicht überspringbaren oder überspringbaren Video-Creatives bieten. Wir empfehlen, bei der Kontoeinrichtung die Option Korrektur überspringen zu aktivieren, da in OpenRTB zwischen ALLOW_SKIPPABLE und REQUIRE_SKIPPABLE nicht unterschieden wird.

Nicht unterstützte Felder

Das Nurl-Feld wird derzeit nicht unterstützt, aber impression_tracking_url wird unterstützt, ebenso wie Bid.burl in OpenRTB 2.5: Weitere Informationen finden Sie in den Kommentaren oben.

Kein Gebot

Wenn der Kunde keine Gebote abgeben möchte, sollte er mit einem 204-Code antworten.

Enums

Alle Aufzählungen finden Sie in der offiziellen Dokumentation für OpenRTB 2.5 und native Anzeigen.

MRAID-1 ist eine Teilmenge von MRAID-2. In OpenRTB 2.1 und niedriger war der Wert 3 auf MRAID. Allerdings verstehen nicht alle MRAID-fähigen APIs MRAID-2-Funktionen. Daher ist der einzige sichere Wert von 3 der Wert MRAID-1. In OpenRTB 2.2 wurde dies explizit festgelegt und MRAID-2 wurde als Wert 5 hinzugefügt.

OpenRTB-Version prüfen

OpenRTB/JSON

x-openrtb-version ist vorhanden und enthält 2.2, 2.3, 2.4 oder 2.5. Content-Type ist application/json. charset=utf-8.

OpenRTB/Protokollzwischenspeicher

x-openrtb-version ist vorhanden und enthält 2.3, 2.4 oder 2.5. Content-Type ist application/octet-stream.

Variablen und Definitionen für Gebotsanfragen

Halten Sie für die Beratung auf dieser Seite das OpenRTB 2.5-Spezifikationsleitfaden bereit. Die Spezifikation enthält Informationen und Aspekte, die für die Authorized Buyers-Implementierung spezifisch sind. Halte dich auch an die Richtlinien in OpenRTB, falls du dies nicht ändern möchtest.

Gebotsanfrage

Das Objekt der Gebotsanfrage auf oberster Ebene enthält eine global eindeutige Gebotsanfrage- oder Auktions-ID. Dieses ID-Attribut ist erforderlich, da mindestens ein Imp-Objekt (Impression) erforderlich ist. Mit anderen Attributen in diesem Objekt der obersten Ebene werden Regeln und Einschränkungen für alle angebotenen Impressionen festgelegt.

Es gibt auch mehrere untergeordnete Objekte, die potenziellen Käufern detaillierte Daten liefern. Dazu gehören unter anderem die Objekte Site und App, mit denen die Art der veröffentlichten Medien beschrieben wird, in denen die Impressionen erscheinen. Diese Objekte werden dringend empfohlen, gelten aber nur für eine bestimmte Gebotsanfrage, je nachdem, ob es sich bei den Medien um browserbasierte Webinhalte oder eine Nicht-Browser-Anwendung handelt.

Hinweis: Das OpenRTB-JSON-Protokoll stellt in der Anfrage alle bool-Felder als Ganzzahlen dar, wobei 0 für false und 1 für true steht. Dies ist in der OpenRTB-Spezifikation erforderlich.

Attribut	Immer bestanden	Typ	Autorisierte Käufer äquivalent	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Ja	String	BidRequest.id	2 2,4 2,5		Eindeutige ID der Gebotsanfrage, die von der Anzeigenplattform bereitgestellt wird OpenRTB ist websicher Base64 (kein Abstand).
imp	Ja	Array mit Imp-Objekten	„BidRequest.AdSlot“	2 2,4 2,5		Darstellung der angebotenen Impressionen Mindestens 1 Imp-Objekt ist erforderlich.
site	Nein	Site Objekt	Angebotsanfrage	2 2,4 2,5		Details zur Publisher-Website. Nur anwendbar und wird für Websites empfohlen. Einmalig mit app.
app	Nein	App Objekt	BidRequest BidRequest.Mobile	2 2,4 2,5		Details zur App des Publishers (keine Browser-Anwendungen) Nur anwendbar und für Apps empfohlen. Einmalig mit site.
device	Nein	Device Objekt	„BidRequest.Mobile“, „BidRequest.Device“	2 2,4 2,5		Details zum Gerät des Nutzers, auf dem die Impression erfolgt
regs	Nein	Regs Objekt		2 2,4 2,5		Gibt alle Branchen-, Rechts- oder behördlichen Bestimmungen an, die für dieses Ersuchen in Kraft sind.
user	Nein	User Objekt	Angebotsanfrage	2 2,4 2,5		Details zum menschlichen Nutzer des Geräts; die Zielgruppe der Werbung
at	Nein	AuctionType Objekt	BidRequest.auction_type	2 2,4 2,5		1 = Erster Preis, 2 = Zweiter Preis Plus. Anzeigenplattformspezifische Auktionstypen können mit Werten von über 500 definiert werden. Standard = SECOND_PRICE.
tmax	Nein	int32	80 bis 1.000 ms	2 2,4 2,5		Maximale Dauer in Millisekunden, um ein Gebot zu senden und so Zeitüberschreitungen zu vermeiden. Dieser Wert wird in der Regel offline kommuniziert.
wseat	Nein	String	Nicht unterstützt	2 2,4 2,5		Zulassungsliste von Käufersitzen (z. B. Werbetreibende, Agenturen), die auf diese Impression bieten dürfen. Die IDs der Sitze und die Kenntnis der Kunden des Käufers, auf die sie verweisen, müssen zwischen Bietern und der Anzeigenplattform vorab koordiniert werden. Die Omission bedeutet, dass keine Sitzbeschränkungen gelten.
allimps	Nein	bool	Nicht unterstützt	2 2,4 2,5		Option, mit der angegeben wird, ob in Exchange ermittelt werden kann, dass die angebotenen Impressionen alle im Kontext verfügbaren Impressionen repräsentieren (z. B. alle auf der Webseite, alle Videospots wie Pre-Mid/Post-Rolls), um Roadblocking zu unterstützen 0 = nein oder unbekannt, 1 = ja, die angebotenen Impressionen entsprechen allen verfügbaren.
cur	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array zulässiger Währungen für Gebote in dieser Gebotsanfrage mit ISO-4217-Alphacodes Nur empfohlen, wenn die Anzeigenplattform mehrere Währungen akzeptiert.
bcat	Nein	String-Array	BidRequest.AdSlot. excluded_sensitive _category, BidRequest.AdSlot. excluded_product _category	2 2,4 2,5		Blockierte Werbetreibendenkategorien, die die IAB-Inhaltskategorien verwenden. Weitere Informationen finden Sie in der Aufzählung „ContentCategory“.
badv	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Liste der Werbetreibenden nach ihren Domains blockieren, z. B. „addomain.com“
bapp	Nein	String-Array	BidRequest.AdSlot.excluded_app_ids	2,4 2,5		Liste der Anwendungen anhand ihrer plattformspezifischen, plattformunabhängigen Anwendungskennungen blockieren. Auf Android-Geräten müssen sie die Sets oder Paketnamen sein (z. B. com.foo.mygame). Unter iOS sind dies die numerischen IDs.
test	Nein	bool	BidRequest.is_test.	2 2,4 2,5		Indikator für den Testmodus, bei dem Auktionen nicht abgerechnet werden, wobei 0 = Live-Modus, 1 = Testmodus. Standard : 1
bseat	Nein	String	Nicht unterstützt	4,0		Liste der Käuferlizenzen (z. B. Werbetreibende und Agenturen), die keine Gebote für diese Impression abgeben können, blockieren. Die IDs der Sitze und die Kenntnis der Kunden des Käufers, auf die sie verweisen, müssen zwischen Bietern und der Anzeigenplattform vorab koordiniert werden. Höchstens eine wseat und bseat sollte in einer Anfrage verwendet werden. Das Auslassen beider Elemente bedeutet, dass keine Sitzplatzbeschränkungen gelten.
wlang	Nein	String	BidRequest .AdSlot .allowed _languages	4,0		Zulassungsliste der Sprachen für Creatives mit ISO-639-1-alpha-2. Auslassung bedeutet nicht, dass es Einschränkungen gibt, aber Käufer sollten das Sprachattribut im Gerät und/oder in den Inhaltsobjekten berücksichtigen, sofern verfügbar.
source	Nein	Source Objekt	Nur für Erweiterungen	4,0		Ein Source-Objekt, das Daten über die Inventarquelle und die Entität gibt, die die endgültige Entscheidung trifft.
ext	Nein	BidRequestExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.bid_request] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff mit dem Feld ext in der BidRequest-Nachricht.

BidRequestExt

Weitere Informationen finden Sie unter Feedback in Echtzeit.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
bid_feedback	Nein	Array mit BidFeedback-Objekten	BidRequest.bid_response_feedback	Feedback zu Geboten, die in vorherigen Antworten gesendet wurden Dies wird nur festgelegt, wenn Echtzeit-Feedback für die Gebotsfunktion aktiviert ist. Wenden Sie sich an Ihren Account Manager, wenn Sie Feedback in Echtzeit aktivieren möchten.
google_query_id	Nein	String	BidRequest.google_Suchanfrage-ID	Eine eindeutige ID für die Abfrage insgesamt. Wenn eine Abfrage mehrere Callouts enthält, enthalten alle Callout-Anfragen für diese Abfrage dieselbe google_query_id.
fcap_scope	Ja	FrequencyCappingScope Aufzählung	BidRequest.AdSlot.FrequencyCappingScope	Die Testfunktion kann sich ändern. Weitere Informationen finden Sie unter Von Google gehostetes Frequency Capping für RTB-Gebote festlegen . Beschreibt den Umfang der Erzwingung von Frequency Capping für diese Anfrage. Das für ein Gebot zu erzwingende Frequency Capping kann im Feld „Bid.ext.fcap“ angegeben werden. FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0; Standardwert, der nicht verwendet werden sollte oder darauf hindeuten kann, dass der Umfang des Frequency Cappings nicht zuverlässig ermittelt werden konnte FREQUENCY_CAPPING_SCOPE_NONE = 1; Frequency Capping, das auf Spezifikationen für Gebotsantworten basiert, ist für diese Anfrage nicht verfügbar. Ein Gebot mit Frequency Capping für eine Gebotsanfrage, für die kein Frequency Capping verfügbar ist, wird vor der Auktion herausgefiltert. FREQUENCY_CAPPING_SCOPE_BROWSER = 2: Die Erzwingung von Frequency Capping ist innerhalb desselben Browsers auf mehreren Websites verfügbar. FREQUENCY_CAPPING_SCOPE_DEVICE = 3: Die Erzwingung von Frequency Capping ist auf mehreren Websites auf dem Gerät verfügbar, außer in Browsern. FREQUENCY_CAPPING_SCOPE_APP = 4: Erzwingung von Frequency Capping ist innerhalb einer einzelnen App verfügbar. FREQUENCY_CAPPING_SCOPE_SITE = 5: Erzwingung von Frequency Capping ist innerhalb einer einzelnen Website verfügbar.
privacy_treatments	Nein	PrivacyTreatments-Objekt	BidRequest.privacy_treatments	Datenschutzmaßnahmen. Einige Felder in der Gebotsanfrage können aus Datenschutzgründen verzerrt oder entfernt werden. Diese Nachricht enthält Informationen zu Datenschutzmaßnahmen, die für eine über diese Anfrage angebotene Werbemöglichkeit gelten.

Gebotsfeedback

Feedback zu Geboten, die in vorherigen Antworten gesendet wurden Dieser Wert wird nur festgelegt, wenn Echtzeit-Feedback für die Gebotsfunktion aktiviert ist. Wenden Sie sich an Ihren Account Manager, wenn Sie Feedback in Echtzeit aktivieren möchten.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
request_id	Nein	String	BidRequest.BidResponseFeedback.request_id	Die eindeutige ID aus BidRequest.id.
creative_status_code	Nein	int32	BidRequest.BidResponseFeedback.creative_status_Code	Der Statuscode der Anzeige. Eine Liste der IDs finden Sie in den Creative-Statuscodes auf der Seite Protos & Referenzdaten.
price	Nein	Doppelwert	Angebotsanfrage.BidResponseFeedback.cpm_micros	Wenn das Gebot die Auktion gewonnen hat, ist dies der Preis, der in Ihrer Kontowährung gezahlt wurde. Wenn das Gebot an der Auktion teilgenommen hat, aber nicht im Gebot enthalten war, ist dies der CPM, der überschritten werden sollte, um den Zuschlag zu erhalten. Diese Option ist nicht verfügbar, wenn das Gebot vor der Auktion herausgefiltert wurde, der Publisher oder der erfolgreiche Bieter das Preisfeedback deaktiviert hat oder wenn in Ihrem Konto die erfolgreichen Preise nicht für andere Bieter freigegeben wurden. Bei Erstpreisauktionen wird anstelle dieses Felds „minimum_bid_to_win“ angegeben.
minimum_bid_to_win	Nein	Doppelwert	BidRequest.BidResponseFeedback.minimum_bid_to_win	Der Mindestgebot, der erforderlich ist, um die Auktion zu gewinnen, in Ihrer Kontowährung Wenn Ihr Gebot die Auktion gewonnen hat, ist dies das zweithöchste Gebot, das nicht gefiltert wurde (einschließlich des Mindestpreises). Falls Ihr Gebot die Auktion nicht gewonnen hat, ist dies das Gebot des erfolgreichen Kandidaten. Dieses Feld wird nur ausgefüllt, wenn Ihr Gebot an einer Erstpreisauktion teilgenommen hat. Es wird nicht ausgefüllt, wenn Ihr Gebot vor der Auktion herausgefiltert wurde.
sampled_mediation_cpm_ahead_of_auction_winner	Nein	Doppelwert	BidRequest.BidResponseFeedback.sampled_mediation_cpm_ahead_of_auction_winner	Wenn ein Publisher eine RTB-Auktion und eine abfolgebasierte SDK-Vermittlung für dieselbe Abfrage verwendet, muss der Gewinner der Echtzeitauktion ebenfalls an einer Vermittlungsabfolge teilnehmen, die nach Preis sortiert ist, um die Impression zu erzielen. Wenn das Gebot an der Auktion teilgenommen hat und es keine Vermittlungsabfolge gab, ist der Wert dieses Felds 0. Wenn das Gebot an der Auktion teilgenommen hat und es einen Wasserfall gab, ist der Wert dieses Felds ein Preisbeispiel für ein geeignetes Vermittlungsnetzwerk, das höher als der Auktionsgewinner war, gewichtet nach erwarteter Ausführungsrate. Dieses Feld kann in Verbindung mit „minimum_bid_to_win“ zum Trainieren von Gebotsmodellen verwendet werden. Der CPM wird in der Währung Ihres Kontos angegeben.
event_notification_token	Nein	EventNotificationToken Objekt	Angebotsanfrage.BidResponseFeedback.event_notification_token	Das Token im entsprechenden Gebot.
buyer_creative_id	Nein	String	BidRequest.BidResponseFeedback.buyer_creative_id	Die Creative-ID, die im entsprechenden Gebot enthalten ist

Ereignisbenachrichtigungs-Token

Das Token im entsprechenden Gebot.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
event_notification_token.payload	Nein	String	Angebotsanfrage.BidResponseFeedback.event_notification_token	Der Inhalt des Tokens.

PrivacyTreatment-Objekt

Mutter/Vater

Datenschutzmaßnahmen. Einige Felder in der Gebotsanfrage können aus Datenschutzgründen verzerrt oder entfernt werden. Diese Nachricht enthält Informationen zu Datenschutzmaßnahmen, die für eine über diese Anfrage angebotene Werbemöglichkeit gelten.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
non_personalized_ads_reason	Nein	NonPersonalizedAdsReason Aufzählung	BidRequest.privacy_treatments.non_personal_ads_Reason	Gibt an, warum Anzeigen, die als Antwort auf diese Anfrage zurückgegeben wurden, nicht personalisiert werden sollen. UNKNOWN = 0; Grund unbekannt. PUBLISHER_DECLARED_NPA = 1: Der Publisher hat angegeben, dass diese Anfrage unabhängig von anderen Signalen nicht personalisierte Anzeigen ausliefern soll. RESTRICT_DATA_PROCESSING= 2: Der Publisher hat die eingeschränkte Datenverarbeitung für diese Anfrage angefordert. USER_OPT_OUT = 3: Der Nutzer hat personalisierte Werbung deaktiviert.
allow_user_data_collection	Nein	bool	BidRequest.privacy_treatments.allow_user_data_collection	Dieser Wert ist „true“, wenn der Publisher die Berechtigung erteilt, der Gebotsfunktion die Verwendung von Gebotsanfragendaten zum Erstellen von Nutzerprofilen für Zwecke wie interessenbezogene Werbung und Remarketing zu erlauben. Damit diese Daten zur Erstellung von Nutzerprofilen verwendet werden können, muss ein Bieter auch eine bestimmte Impression gewinnen. Weitere Informationen finden Sie unter Steuerelemente für die Datenerhebung.

Quelle

Dieses Objekt beschreibt die Art und das Verhalten der Entität, die die Quelle der Gebotsanfrage vor der Anzeigenplattform ist. Der Hauptzweck dieses Objekts besteht darin, eine Entscheidung nach der Auktion oder Upstream zu definieren, wenn die Anzeigenplattform nicht die endgültige Entscheidung beeinflusst. Ein gängiges Beispiel hierfür sind Header Bidding, aber auch für vorgelagerte Serverentitäten wie eine andere RTB-Plattform, eine Vermittlungsplattform oder einen Ad-Server ist möglich, die direkte Kampagnen bei der Entscheidungsfindung durch Drittanbieter kombinieren.

Attribut	Immer bestanden	Typ	Autorisierte Käufer äquivalent	Unterstützt		Implementierungsdetails
				in Version	von Google
fd	Nein	boolean	Nicht unterstützt	4,0		Die Entität, die für die endgültige Entscheidung über den Verkauf von Impressionen verantwortlich ist, wobei 0 = Anzeigenplattform, 1 = vorgelagerte Quelle ist. EMPFOHLEN durch die OpenRTB-Spezifikation.
tid	Nein	String	Nicht unterstützt	4,0		Transaktions-ID, die allen Teilnehmern dieser Gebotsanfrage gleich sein muss (z. B. mehrere Anzeigenplattformen). EMPFOHLEN durch die OpenRTB-Spezifikation.
pchain	Nein	String	Nicht unterstützt	4,0		Zahlungs-ID-Kettenstring mit eingebetteter Syntax, wie im TAG Payment ID-Protokoll, Version 1.0, beschrieben. EMPFOHLEN durch die OpenRTB-Spezifikation.
ext	Nein	SourceExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.source] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Für OpenRTB/JSON erfolgt der Zugriff mit dem Feld ext in der Quellnachricht.
schain	Nein	SupplyChain Objekt	BidRequest.supply_chain	2 2,4 2,5		OpenRTB SupplyChain-Objekt. Weitere Informationen finden Sie in diesem Artikel.

SourceExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
omidpn	Nein	String	BidRequest.AdSlot.omidpn	ID der OM SDK-Integration. Weitere Informationen finden Sie in den Hinweisen zum OpenRTB-Analysetool für OpenRTB.
omidpv	Nein	String	BidRequest.AdSlot.omidpv	Version der OM SDK-Integration. Weitere Informationen finden Sie in den Hinweisen zum OpenRTB-Analysetool für OpenRTB.
schain	Nein	SupplyChain Objekt	BidRequest.supply_chain	Dieses Feld wurde zugunsten der „BidRequest.source.schain“ eingestellt und wird im Dezember 2023 entfernt. Dieses Feld enthält das OpenRTB SupplyChain-Objekt. Weitere Informationen finden Sie in diesem Artikel.

SupplyChain

OpenRTB SupplyChain-Objekt. Weitere Informationen finden Sie in diesem Artikel.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
complete	Nein	int32	BidRequest.supply_chain.complete	Option, die angibt, ob die Kette alle Knoten enthält, die an der Transaktion beteiligt sind und zurück zum Inhaber der Website, der App oder des anderen Mediums des Inventars führen, wobei 0 = nein, 1 = ja.
nodes	Nein	Array mit SupplyChainNode-Objekten	BidRequest.supply_chain.nodes	Array von SupplyChainNode-Objekten in der Reihenfolge der Kette. In einer vollständigen Lieferkette stellt der erste Knoten das erste Werbesystem und die Verkäufer-ID dar, die an der Transaktion beteiligt sind, z. B. der Inhaber der Website, der App oder eines anderen Mediums. In einer unvollständigen Lieferkette stellt er den ersten bekannten Knoten dar. Der letzte Knoten stellt die Entität dar, die diese Gebotsanfrage sendet.
ver	Nein	String	BidRequest.supply_chain.version	Version der verwendeten Spezifikation der Lieferkette im Format „major.minor“. Für Version 1.0 der Spezifikation verwenden Sie beispielsweise den String „1.0“.

SupplyChainNode (SuppChainNode)

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
asi	Nein	String	BidRequest.supply_chain.nodes.advertising_system_identifier	Der kanonische Domainname des SSP-, Exchange-, Header-Wrapper-Systems usw., mit dem Bieter eine Verbindung herstellen. Dies kann die operative Domain des Systems sein, wenn diese von der übergeordneten Unternehmensdomain abweicht, um WHOIS- und umgekehrte IP-Lookups zu vereinfachen und so die Inhaberschaft des Bevollmächtigtensystems klar zu definieren. Es sollte derselbe Wert sein, mit dem Verkäufer in einer ads.txt-Datei identifiziert werden, falls vorhanden.
sid	Nein	String	BidRequest.supply_chain.nodes.seller_identifier	Die ID, die mit dem Verkäufer- oder Reseller-Konto im Werbesystem verknüpft ist. Er muss denselben Wert für Transaktionen wie OpenRTB-Gebotsanfragen in dem Feld enthalten, das von der SSP/Anzeigenplattform angegeben wird. In OpenRTB ist dies normalerweise „publisher.id“. Bei OpenDirect ist es normalerweise die Organisations-ID des Publishers. Sollte auf 64 Zeichen begrenzt sein.
rid	Nein	String	Nicht unterstützt	Die OpenRTB-Anfrage-ID der Anfrage, die von diesem Verkäufer ausgestellt wurde.
name	Nein	String	Nicht unterstützt	Der Name des Unternehmens (die juristische Person), das für Inventar bezahlt wird, das unter der angegebenen sellers_id abgewickelt wird. Dieser Wert ist optional und sollte NICHT enthalten sein, wenn er in der sellers.json-Datei des Werbesystems vorhanden ist.
domain	Nein	String	Nicht unterstützt	Der Name der Unternehmensdomain der Entität, die durch diesen Knoten dargestellt wird. Dieser Wert ist optional und sollte NICHT enthalten sein, wenn er in der sellers.json-Datei des Werbesystems vorhanden ist.
hp	Nein	int32	BidRequest.supply_chain.nodes.handles_payment	Gibt an, ob dieser Knoten am Zahlungsablauf für das Inventar beteiligt ist. Wenn der Wert im Feld „1“ auf 1 gesetzt ist, bezahlt der Anbieter im Feld „asi“ den Verkäufer im Feld „sid“, der für die Zahlung des vorherigen Knotens in der Kette verantwortlich ist. Wenn dieser Wert auf 0 gesetzt ist, ist dieser Knoten nicht an der Zahlung für das Inventar beteiligt. Für Version 1.0 von SupplyChain sollte diese Property immer 1 sein. Es muss explizit angegeben werden, da zukünftige Versionen der Spezifikation Knoten für die Zahlungsabwicklung einführen. Implementierungen sollten dafür sorgen, dass sie dieses Feld unterstützen, und sie bei der Erstellung von SupplyChain-Objekten in Gebotsanfragen an ein nachgelagertes Werbesystem weitergeben.

Teufelchen

Mit diesem Objekt wird ein Anzeigen-Placement oder eine Auktion beschrieben, die versteigert wird. Eine einzelne Gebotsanfrage kann mehrere Imp-Objekte enthalten. Das ist ein Anwendungsfall, bei dem eine Anzeigenplattform alle Anzeigenpositionen auf einer Seite unterstützen kann. Jedes Imp-Objekt hat eine erforderliche ID, damit Gebote einzeln darauf verweisen können.

Das Vorhandensein von Objekten Banner, Video oder Native, die dem Objekt Imp untergeordnet sind, gibt die Art der angebotenen Impression an. Der Verlag oder Webpublisher kann einen dieser Art auswählen, was typisch ist, oder die beiden nach eigenem Ermessen mischen. Jedes Gebot für die Impression muss einem der angebotenen Typen entsprechen.

Attribut	Immer bestanden	Typ	ÄquivalentKäufer	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Ja	String	BidRequest .Adslot.id	2 2,4 2,5		Eine eindeutige Kennung für diese Impression im Kontext der Gebotsanfrage. Normalerweise beginnt der Wert mit „1“ und erhöht sich bei n Impressionen bis zu n.
banner	Nein	Banner Objekt	Angebotsanfrage .Anzeigenfläche	2 2,4 2,5		Ein Banner-Objekt; erforderlich, wenn diese Impression als Empfehlung für eine Banneranzeige angeboten wird.
video	Nein	Video Objekt	BidRequest .AdSlot BidRequest .Video	2 2,4 2,5		Erforderlich, wenn diese Impression als Videoanzeigenmöglichkeit angeboten wird.
audio	Nein	Audio Objekt	BidRequest .AdSlot BidRequest .Video	2 2,4 2,5		Erforderlich, wenn diese Impression als Audioanzeige angeboten wird.
displaymanager	Nein	String	BidRequest .AdSlot .renderer	2 2,4 2,5		Name des Anzeigenvermittlungspartners, der SDK-Technologie oder des Players, der die Anzeige rendert (in der Regel ein Video oder ein Mobilgerät). Wird von einigen Ad-Servern verwendet, um den Anzeigencode nach Partner anzupassen. Für Videos und/oder Apps empfohlen Beispielstrings: UNKNOWN_RENDERER GOOGLE PUBLISHER
displaymanagerver	Nein	String	Nicht unterstützt	2 2,4 2,5		Version des Anzeigenvermittlungspartners, der SDK-Technologie oder des Players, der für das Rendern der Anzeige verantwortlich ist (normalerweise Video oder Mobilgerät). Wird von einigen Ad-Servern verwendet, um den Anzeigencode nach Partner anzupassen. Für Videos und/oder Apps empfohlen
instl	Nein	bool	BidRequest .AdSlot .Mobile. is_interstitial _request	2 2,4 2,5		1 = Anzeige ist Interstitial oder Vollbild, 0 = Interstitial.
tagid	Nein	String	BidRequest .AdSlot .ad_block_key	2 2,4 2,5		Kennung für ein bestimmtes Anzeigen-Placement oder Anzeigen-Tag, mit dem die Auktion initiiert wurde. Dies kann bei der Fehlerbehebung oder bei der Optimierung durch den Käufer hilfreich sein.
bidfloor	Nein	Doppelwert	min(BidRequest .AdSlot. matching _ad_data .minimum_cpm _micros) * 1.000.000	2 2,4 2,5		Das Mindestgebot für diese Impression, ausgedrückt in CPM.
bidfloorcur	Nein	String	Unterstützt bezogen von Abrechnungs-ID	2 2,4 2,5		Die Währung wird mit ISO-4217-Alphacodes angegeben. Dies kann von der vom Bieter zurückgegebenen Währung abweichen, wenn dies von der Anzeigenplattform zugelassen wird. Eine einzelne Währung, abgerufen aus dem enthaltenen billing_id.
clickbrowser	Nein	bool	Nicht unterstützt	2,4 2,5		Gibt den Browsertyp an, der beim Klicken auf das Creative in einer App geöffnet wird, wobei 0 = eingebettet, 1 = nativ. Der Safari View Controller gilt für Geräte mit iOS 9.x als nativer Browser.
secure	Nein	bool	BidRequest .ad_slot .excluded_attribute 48:RichMedia fähigFSSL	2 2,4 2,5		Option, die angibt, ob für die Impression sichere HTTPS-URL-Creative-Assets und -Markup erforderlich sind, wobei 0 = nicht sicher, 1 = sicher ist. Wenn dieser Wert weggelassen wird, ist der sichere Status unbekannt, aber es kann von einer nicht sicheren HTTP-Unterstützung ausgegangen werden.
iframebuster	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array mit plattformspezifischen Namen unterstützter iFrame-Buster.
pmp	Nein	Pmp Objekt	BidRequest .AdSlot .MatchingAdData	2 2,4 2,5		Ein Pmp-Objekt, das alle privaten Marktplatzangebote enthält, die für diese Impression gelten.
native	Nein	Nativ	BidRequest .AdSlot .NativeAdTemplate	2 2,4 2,5		Ein Native-Objekt; erforderlich, wenn diese Impression als Umsatzchancen in einer nativen Anzeige angeboten wird.
exp	Nein	int32	BidRequest .AdSlot .impression_expiration _seconds	2,4 2,5		Hinweis zur Anzahl von Sekunden zwischen der Auktion und der tatsächlichen Impression.
metric	Nein	Array mit Metric-Objekten	BidRequest .AdSlot .viewability BidRequest .AdSlot .click_through _rate BidRequest .AdSlot .video_complete _rate BidRequest .AdSlot .session_depth	4,0		Ein Array mit Metric-Objekten. AdX stellt folgende Messwerte für dieses Feld bereit: click_through_rate, viewability, completion_rate und session_depth. Der Messwert viewability ist ein Anteil von 0,00 bis 1,00 im OpenRTB-Messwert, wird im AdX-Protokoll jedoch als Prozentsatz [0–100] ausgedrückt. Beschreibungen dieser Messwerte finden Sie in der Tabelle „AdSlot-Objekte“ im Leitfaden zu Echtzeitgeboten. Hinweis: session_depth ist ein ganzzahliger Wert.
ext	Nein	ImpExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.imp] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der Impressionsmeldung.
rwdd	Nein	bool	BidRequest.AdSlot.is_rewarded	2.6		Gibt an, ob der Nutzer eine Prämie für die Wiedergabe der Anzeige erhält. Bei Videoanzeigen können Nutzer in der Regel einen zusätzlichen Nachrichtenartikel kostenlos lesen, ein zusätzliches Leben in einem Spiel erhalten oder eine gesponserte Musiksitzung ohne Werbeanzeigen erleben. Die Prämie wird normalerweise nach Abschluss der Videoanzeige vergeben.

Impr.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
billing_id	Ja	Array von int64	BidRequest.AdSlot.MatchingAdData.billing_id	Die Abrechnungs-IDs, die den übereinstimmenden Pre-Targeting-Konfigurationen entsprechen.
publisher_settings_list_id	Ja	Array von fix64	BidRequest.publisher_settings_list_id BidRequest.AdSlot.publisher_settings_list_id	Die ID der Liste mit den Publisher-Einstellungen, die für diese Seite gilt. Weitere Informationen findest du im Leitfaden zu RTB-Publisher-Einstellungen.
allowed_vendor_type	Nein	Array von int32	BidRequest.AdSlot.allowed_vendor_type	Die zulässigen Anbietertypen. Eine Liste der IDs finden Sie in der Datei vendors.txt.
excluded_creatives	Nein	Array mit ExcludedCreative-Objekten	BidRequest.AdSlot.Ausgeschlossene Creatives	Creatives, die für die Impression nicht zugelassen sind. Wenn Sie ein Gebot für eines der Creatives in dieser Liste senden, wird dieses Gebot vor der Auktion herausgefiltert. Wenden Sie sich an Ihren Account Manager, wenn Sie dieses Feature aktivieren möchten.
publisher_parameter	Nein	String-Array	BidRequest.AdSlot.ExchangeBidding.publisher_Parameter	UTF8-Strings, die der Publisher optional im Rahmen der entsprechenden Ertragsgruppenkonfigurationen auf der Ad Manager-UI zur Verfügung stellt. Das Format ist beliebig und sollte zwischen dem Publisher und dem Authorized Buyers-Bieter vereinbart werden.
dfp_ad_unit_code	Nein	String	BidRequest.AdSlot.dfp_ad_unit_code	Code für den Ad Manager-Anzeigenblock Diese Einstellung wird derzeit nur für Open Bidding-Anfragen festgelegt.
is_rewarded_inventory	Nein	bool	BidRequest.AdSlot.ist_Prämie	Dieses Feld wurde zugunsten der „BidRequest.imp.rwdd“ eingestellt und wird im Juli 2023 entfernt. Dieses Feld gibt an, ob der Nutzer eine Prämie für das Ansehen der Anzeige erhält. Bei Videoanzeigen können Nutzer in der Regel einen zusätzlichen Nachrichtenartikel kostenlos lesen, ein zusätzliches Leben in einem Spiel erhalten oder eine gesponserte Musiksitzung ohne Werbeanzeigen erleben. Die Prämie wird normalerweise nach Abschluss der Videoanzeige vergeben.
is_app_open_ad	Nein	bool	„BidRequest.Mobile“is_app_open_ad	Gibt an, ob eine Gebotsanfrage für eine mobile App für eine App-Start-Anzeige vorgesehen ist. Weitere Informationen finden Sie im Leitfaden zu App-Start-Anzeigen.
ampad	Nein	Enum „AmpAdRequirementType“	BidRequest.AdSlot.amp_ad_request_type	Mögliche Typen von AMP-Anzeigen UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 1; (Standard) AMP-Anzeigenanforderungen sind unbekannt. AMP_AD_NOT_ALLOWED = 2; AMP-Anzeigen sind nicht zulässig. AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 3; AMP-Anzeigen oder Nicht-AMP-Anzeigen sind zulässig, AMP-Anzeigen werden jedoch nicht früh gerendert. AMP_AD_ALLOWED_AND_EARLY_RENDERED = 4 : Entweder sind AMP-Anzeigen oder Nicht-AMP-Anzeigen zulässig, AMP-Anzeigen werden frühzeitig gerendert. AMP_AD_REQUIRED = 5; AMP-Anzeigen sind erforderlich. Nicht-AMP-Anzeigen werden unter Umständen vom Publisher abgelehnt.
buyer_generated_request_data	Nein	Array mit BuyerGeneratedRequestData-Objekten	BidRequest.AdSlot.sichere_Signale	Vom Publisher übergebene sichere Signale
billable_event_rate_adjustment	Nein	Doppelwert	BidRequest.AdSlot.billable_event_rate_adjustment	Bei Anzeigen, die nur mit einem benutzerdefinierten SDK gerendert werden: Multiplikator, der auf das Gebot in der Auktion angewendet wird Die Anpassung spiegelt die Wahrscheinlichkeit wider, mit der Ihr Gebot ein abrechnungsfähiges Ereignis generieren könnte (z. B. wenn die Anzeige erfolgreich gerendert wird), wenn die Auktion erfolgreich war, im Verhältnis zur Wahrscheinlichkeit, dass andere Gebote ein abrechnungsfähiges Ereignis generieren, wenn sie die Auktion gewonnen haben. Diese Anpassung kann größer oder kleiner als 1 sein. Dies wirkt sich nur auf das endgültige Ranking in der Auktion aus, insbesondere nicht auf den Multiplikator. Standard = 1.0.
open_bidding	Nein	OpenBidding-Objekt	BidRequest.AdSlot.open_Bidding	Parameter für Open Bidding.
ad_unit_mapping	Nein	AdUnitMapping Objekt	BidRequest.AdSlot.ad_unit_mapping	Anzeigenblockzuordnungen, die der angegebenen Anzeigenfläche entsprechen.
allowed_restricted_category	Nein	int32	BidRequest.AdSlot.allowed_restricted__category	Die zulässigen eingeschränkten Anzeigenkategorien. Eine Liste der IDs finden Sie in der Datei ad-restricted-categories.txt.
skadn	Nein	SKAdNetworkRequest-Objekt	BidRequest.Mobile.	SKAdNetwork-Informationen des Publishers zur Unterstützung der Attribution von App-Installationen für iOS 14 und höher. Mit der SKAdNetwork API von Apple können Werbetreibende die Installation werbebasierter Apps messen. Dazu wird nach einer erfolgreichen Installation ein Postback an das Werbenetzwerk gesendet. Publisher müssen unterstützte Werbenetzwerke in der Property-Liste ihrer App (Info.plist) konfigurieren, damit eine Installation der Anzeigenimpression zugeordnet werden kann. Weitere Informationen finden Sie in der Dokumentation von Apple.
Ausgeschlossenes Creative
buyer_creative_id	Nein	String	BidRequest.AdSlot.Ausgeschlossenes Creative.buyer_creative_id	Creative-ID des Käufers des unzulässigen Creatives.
KäufergeneriertenDatenanfragen
data	Nein	String	BidRequest.AdSlot.SecureSignal.data	Das sichere Signal
source_app	Nein	Quell-App	BidRequest.AdSlot.SecureSignal.Quelle	Die Quelle der Daten.
Quell-App
id	Nein	String	BidRequest.AdSlot.SecureSignal.Quelle	Kennung des SDK, das diese Daten generiert hat. Sie stimmt mit der ID in BidRequest.AppExt.InstalledSdk.id überein.
OpenBidding
is_open_bidding	Nein	bool	BidRequest.AdSlot.OpenBidding.is_open_Bidding	Das Feld ist auf „true“ gesetzt, wenn der Publisher eine Ertragsgruppe oder eine Vermittlungsgruppe eingerichtet hat, die auf diese Anzeigenfläche und diesen Bieter ausgerichtet ist. Weitere Informationen zu Open Bidding und den damit verbundenen Auswirkungen auf Open Bidding finden Sie in der Google Ads-Hilfe.
Anzeigenblockzuordnung
Keyval	Nein	Keyval Objekt	BidRequest.AdSlot.AdUnitMapping.Schlüsselwert	Schlüssel/Wert-Paar, mit dem die Inventareinheit im Namespace des Bieters angegeben wird.
FormatType	Nein	enum	BidRequest.AdSlot.AdUnitMapping.format_type	Mögliche Formate für Anzeigenblöcke, die für die Zuordnung verwendet werden können. Entspricht dem Adapter, der im SDK verwendet wird. Mögliche Werte: FORMAT_UNKNOWN = 0; Banneranzeigen im Web oder in Apps schalten Das kann beispielsweise ein Leaderboard-Slot von 320 x 50 sein. Das gilt auch für Out-Stream-Videos. FORMAT_BANNER = 1; Eine Vollbildanzeige, die in einer mobilen App eingeblendet wird FORMAT_INTERSTITIAL = 2; Benutzerdefinierte Display- oder Videoanzeigen für das Web oder für mobile Apps, die der Website oder App entsprechen, auf der sie platziert sind. FORMAT_NATIVE = 3; Videoanzeigen, die vor, während oder nach einem Videocontent-Stream eingeblendet werden FORMAT_VIDEO_VAST = 4; Videoanzeigen für mobile Apps, bei denen Nutzer sich für das Ansehen einer Anzeige entscheiden können, um eine In-App-Prämie zu erhalten FORMAT_REWARDED = 5; Interstitial-Anzeigen, bei denen sich die Nutzer eine Anzeige ansehen und dafür eine In-App-Prämie erhalten. Kein Opt-in erforderlich. https://support.google.com/admanager/answer/7386053 FORMAT_REWARDED_INTERSTITIAL = 6; App-Start-Anzeigen werden auf dem Ladebildschirm der App eingeblendet. App-Start-Anzeigen können jederzeit geschlossen werden. Sie werden ausgeliefert, wenn der Nutzer die App in den Vordergrund holt. FORMAT_APP_OPEN = 7;
SKAdNetwork-Anfrage
versions	Nein	Stringarray	BidRequest.Mobile.skadn.versions	Liste aller von der Anfrage unterstützten SKAdNetwork-Versionen, je nach Betriebssystem- und SDK-Version.
sourceapp	Nein	String	BidRequest.Mobile.skadn.sourceapp .	ID der Publisher-App im App Store von Apple.
skadnetids	Nein	String-Array	BidRequest.Mobile.skadn.skadnetids	SKAdNetworkIdentifier-Einträge in der Info.plist der Publisher App.
fidelities	Nein	Array mit SKAdNetworkFidelityType-Objekten	BidRequest.Mobile.skadn.supported_fidelity_types	Liste der unterstützten Fidelity-Typen, je nach SKAdNetwork-API-Version, die vom Betriebssystem und SDK unterstützt wird, sowie an den Anzeigenflächeneigenschaften.
skoverlay	Nein	bool	BidRequest.Mobile.skadn.skoverlay	Gibt an, ob diese Anfrage die SKOverlay-Funktion für Videoanzeigen unterstützt.

Keyval-Objekt

Mutter/Vater

Es können mehrere Schlüssel/Wert-Paare angegeben werden, um Bieter zu unterstützen, deren Speicherplatz für Inventareinheiten hierarchisch ist und mehrere IDs hat. Die Schlüssel/Wert-Paare für das ausgewählte AdUnitMapping sollten in der Gebotsantwort als BidResponse.seatbid.ext.sdk_rendered_ad.sdk_params zurückgegeben werden. Diese wird an das SDK des Bieters übergeben.

Attribut	Typ	Immer bestanden	Authorized Buyers-Entsprechung	Implementierungsdetails
key	String	Nein	BidRequest.AdSlot.AdUnitMapping.keyval.Schlüssel	Der Schlüssel ist der Name der Inventareinheits-ID des Bieters für das SDK.
value	String	Nein	BidRequest.AdSlot.AdUnitMapping.keyval.Wert	Der Wert der ID der Inventareinheit des Bieters für das angegebene Format.

Messwert

Dieses Objekt wird einer Impression als Array von Messwerten zugeordnet. Diese Messwerte liefern Einblicke in die Impression, um Ihnen bei Entscheidungen zu helfen, z. B. die durchschnittliche aktuelle Sichtbarkeit und die Klickrate (Click-through-Rate, CTR). Jeder Messwert wird durch seinen Typ identifiziert, meldet den Wert des Messwerts und optional die Quelle oder den Anbieter, der den Wert misst.

Attribut	Immer bestanden	Typ	Autorisierte Käufer äquivalent	Unterstützt		Implementierungsdetails
				in Version	von Google
type	Nein	String	Eine der folgenden Optionen: BidRequest .AdSlot .viewability BidRequest .AdSlot .click_ through_rate BidRequest .AdSlot .video_ complete_rate BidRequest .AdSlot .session_depth	4,0		Messwerttyp, der mit von Exchange zusammengestellten Stringnamen präsentiert wird, die Bietern vorrangig veröffentlicht werden sollten. Erforderlich gemäß der OpenRTB-Spezifikation. Folgende Typen werden unterstützt: click_through_rate, viewability, completion_rate und session_depth.
value	Nein	Doppelwert	Wert zwischen 0 und 1.	4,0		Zahl, die den Wert des Messwerts darstellt Wahrscheinlichkeiten müssen zwischen 0,00 und 1,00 liegen. Erforderlich gemäß der OpenRTB-Spezifikation. Der Messwert viewability ist ein Anteil von 0,00 bis 1,00 im OpenRTB-Messwert, wird im AdX-Protokoll jedoch als Prozentsatz [0–100] ausgedrückt.
vendor	Nein	String	UMTAUSCH	4,0		Quelle des Werts unter Verwendung von kuratierten Stringnamen, die für Bieter vorrangig veröffentlicht werden sollten. Wenn die Anzeigenplattform selbst die Quelle im Vergleich zu einem Drittanbieter ist, wird „EXCHANGE“ empfohlen. EMPFOHLEN durch die OpenRTB-Spezifikation.

Banner

Dieses Objekt stellt die allgemeinste Art der Impression dar. Auch wenn der Begriff „Banner“ in anderen Kontexten eine sehr spezifische Bedeutung hat, kann er hier viele Aspekte umfassen, z. B. ein einfaches statisches Bild, einen Expandable-Anzeigenblock oder sogar ein In-Banner-Video. Weitere Details zu den Anzeigenblöcken für allgemeinere und vollständigere Funktionen finden Sie im Video-Objekt. Im Video kann auch ein Array mit Banner-Objekten zur Beschreibung optionaler Companion-Anzeigen eingeblendet werden, die in der VAST-Spezifikation definiert sind.

Das Vorhandensein eines Banner als untergeordnetes Element des Imp-Objekts bedeutet, dass diese Impression als Bannertyp-Impression angeboten wird. Auf Verlag des Publishers kann dieselbe Impression auch als Video- und/oder native Anzeige angeboten werden. Dies schließt auch ein, wenn Imp die Video- und/oder Native-Objekte untergeordnet ist. Jedes Gebot für die Impression muss jedoch einem der angebotenen Typen entsprechen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
w	Nein	int32	BidRequest.AdSlot.width[0]	2 2,4 2,5		Breite in geräteunabhängigen Pixeln (DIPS). Wenn keine Format-Objekte angegeben sind, ist dies eine genaue Breiteanforderung. Andernfalls ist es eine bevorzugte Breite.
h	Nein	int32	BidRequest.AdSlot.height[0]	2,3 2,4 2,5		Höhe in geräteunabhängigen Pixeln (DIPS). Wenn keine Format-Objekte angegeben sind, ist die Höhe genau erforderlich. Andernfalls ist sie die bevorzugte Höhe.
format	Nein	Array mit Format-Objekten	Nicht unterstützt	2,4 2,5		Array mit Format-Objekten für die Bannergröße, die zulässig sind. Wenn keiner angegeben ist, wird die Verwendung der Attribute h und w dringend empfohlen.
id	Nein	String	BidRequest.AdSlot.id	2,3 2,4 2,5		Eindeutige Kennung für dieses Banner-Objekt. Empfohlen, wenn Banner-Objekte mit einem Video-Objekt verwendet werden, um ein Array von Companion-Anzeigen darzustellen. Die Werte beginnen in der Regel bei 1 und erhöhen sich mit jedem Objekt. Sie müssen innerhalb einer Impression eindeutig sein.
pos	Nein	Aufzählung „AdPosition“	BidRequest.AdSlot.slot_sichtbarkeit BidRequest.StickySettings	2,3 2,4 2,5		Die Werte in dieser OpenRTB-Tabelle stammen aus den IAB-Qualitätssicherungsrichtlinien (QA Assurance Guidelines, QAG). Experten sollten die in IAB.net veröffentlichten QAG-Werte immer im Blick behalten. Die Werte „4“ bis „7“ gelten für alle Apps in den Ergänzungen zu QAG ab Version 1.5. Banner.pos unterstützt nur einen Wert. Wenn is_sticky, wird Banner.pos mit Wiederkehrrate gefüllt. Wenn unknown_stickiness, wird slot_visibility verwendet. „Fixiert“ bedeutet, dass das Banner immer auf dem Bildschirm zu sehen ist. Die Sichtbarkeit „above the fold“ (ohne Scrollen sichtbar) oder „below the fold“ (mit Scrollen sichtbar) kann sich durch Scrollen ändern. Kann einer der folgenden Werte sein: ABOVE_THE_FOLD = 1; BELOW_THE_FOLD = 3; HEADER = 4; Entspricht sticky_settings.top_horizontal_stickiness im RTB-Protokoll von Authorized Buyers. FOOTER = 5; Entspricht sticky_settings.bottom_horizontal_stickiness im RTB-Protokoll von Authorized Buyers. SIDEBAR = 6; Entspricht sticky_settings.vertical_stickiness im RTB-Protokoll von Authorized Buyers.
btype	Nein	Array mit Aufzählung „BannerAdType“	Nicht unterstützt	4,0		Blockierte Banneranzeigentypen Beispiele: XHTML_TEXT_AD = 1; // "In der Regel mobil" XHTML_BANNER_AD = 2; // "In der Regel mobil" JAVASCRIPT_AD = 3; // JavaScript muss gültig sein xhtml iframe = 4; // iFrame
battr	Nein	Array von CreativeAttribute-Enum	BidRequest.AdSlot.excluded_attribute	2,3 2,4 2,5		Blockierte Creative-Attribute. Beispiele: AUDIO_AUTO_PLAY = 1; AUDIO_USER_INITIATED = 2;
mimes	Nein	String-Array	Nur für BidRequest.Video.companionad: BidRequest.Video.companionad.creative_format BidRequest.AdSlot.excluded_attribute / VPAID zugeordnet	2,3 2,4 2,5		Zulassungsliste mit unterstützten MIME-Typen für Inhalte. Zu den beliebten MIME-Typen gehören unter anderem „image/jpg“, „image/gif“ und „application/x-shockwave-Flash“.
topframe	Nein	bool	BidRequest.AdSlot.iframe_state NO_iframe: false SAME_DOMAIN_iframe, CROSS_DOMAIN_iframe: true	2,3 2,4 2,5		Geben Sie an, ob das Banner im oberen Frame (true) oder in einem iFrame (false) ausgeliefert werden soll.
expdir	Nein	Array mit ExpandableDirection Enum	BidRequest.AdSlot.excluded_Expandable / Expandable	2,3 2,4 2,5		Richtungen, in die das Banner maximiert werden kann
api	Nein	Array mit APIFramework-Objekten	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,3 2,4 2,5		Liste der unterstützten API-Frameworks für diese Impression. Ist eine API nicht explizit aufgeführt, wird sie nicht unterstützt.
vcm	Nein	bool	BidRequest.Video.end_cap_support	4,0		Gilt nur für Bannerobjekte, die mit einem Videoobjekt in einem Array von Companion-Anzeigen verwendet werden. Gibt den Renderingmodus des Companion-Banners relativ zum verknüpften Video an, wobei 0 = gleichzeitig, 1 = Endbild. Momentan werden Endbilder nur bei Video-Interstitials in mobilen Apps unterstützt.
wmax	Nein	int32	BidRequest.AdSlot.flexible_ad_slot_settings.max_width	2,3 2,4 2,5		Maximale Breite der Impression in Pixeln.
hmax	Nein	int32	BidRequest.AdSlot.flexible_ad_slot_settings.max_height	2,3 2,4 2,5		Maximale Höhe der Impression in Pixeln.
wmin	Nein	int32	BidRequest.AdSlot.flexible_ad_slot_settings.min_width	2,3 2,4 2,5		Mindestbreite der Impression in Pixeln.
hmin	Nein	int32	BidRequest.AdSlot.flexible_ad_slot_settings.min_height	2,3 2,4 2,5		Mindesthöhe der Impression in Pixeln.

Format

Dieses Objekt stellt eine zulässige Größe (Kombination aus Höhe und Breite) für eine Bannerimpression dar. Sie werden in der Regel in einem Array für eine Impression verwendet, bei der mehrere Größen zulässig sind.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
w	Nein	int32	BidRequest.AdSlot.width	2,4 2,5		Breite in geräteunabhängigen Pixeln (DIPS).
h	Nein	int32	BidRequest.AdSlot.height	2,4 2,5		Höhe in geräteunabhängigen Pixeln (DIPS).
wratio	Nein	int32	Nicht unterstützt	4,0		Relative Breite, wenn die Größe als Verhältnis ausgedrückt wird.
hratio	Nein	int32	Nicht unterstützt	4,0		Relative Höhe, wenn die Größe als Verhältnis ausgedrückt wird.
wmin	Nein	int32	Nicht unterstützt	4,0		Die minimale Breite in Geräten, in denen die Anzeige unabhängig vom Bildschirm ist (DIPS), bei der die Anzeige ausgeliefert wird, wenn die Größe als Verhältnis ausgedrückt wird.

Video

Dieses Objekt steht für eine In-Stream-Video-Impression. Viele der Felder sind für minimal tragbare Transaktionen nicht unerlässlich, werden jedoch eingebunden, um bei Bedarf eine genaue Kontrolle zu ermöglichen. Bei Videos in OpenRTB wird im Allgemeinen die Einhaltung des VAST-Standards vorausgesetzt. Daher wird das Konzept von Companion-Anzeigen dadurch unterstützt, dass optional ein Array von Banner-Objekten eingeschlossen wird, die diese Companion-Anzeigen definieren.

Das Vorhandensein eines Video als untergeordnetes Element des Imp-Objekts zeigt an, dass diese Impression als Videoimpression angeboten wird. Diese Impression kann im Ermessen des Publishers auch als Banner und/oder native Anzeige angeboten werden. Hierzu muss Imp auch die Objekte Banner und/oder Native untergeordnet sein. Jedes Gebot für die Impression muss jedoch einem der angebotenen Typen entsprechen.

Weitere Informationen finden Sie im Leitfaden zu OpenRTB-Videoanzeigen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Version	Von Google unterstützt	Implementierungsdetails
mimes	Ja	String-Array	BidRequest.Video.allowed_video_formats, BidRequest.AdSlot.excluded_attribute / VPAID	2 2,4 2,5		Zulassungsliste mit unterstützten MIME-Typen für Inhalte. Zu den beliebten MIME-Typen gehören unter anderem „image/jpg“, „image/gif“ und „application/x-shockwave-Flash“. Erforderlich gemäß der OpenRTB-Spezifikation: mindestens ein Element
linearity	Nein	int32		2 2,4 2,5		Gibt an, ob die Impression linear oder nicht linear sein muss. Wenn keine angegeben ist, nehmen Sie an, dass alle zulässig sind. LINEAR = 1: Linear/In-Stream NON_LINEAR = 2: Nicht linear/Overlay
minduration	Nein	int32	BidRequest.Video.min_ad_Dauer	2 2,4 2,5		Mindestdauer der Videoanzeige in Sekunden. EMPFOHLEN durch die OpenRTB-Spezifikation.
maxduration	Nein	int32	BidRequest.Video.max_ad_duration	2 2,4 2,5		Maximale Dauer der Videoanzeige in Sekunden. EMPFOHLEN durch die OpenRTB-Spezifikation.
protocols	Nein	Array mit Protocol-Objekten	BidRequest.Video.Protokolle	2 2,4 2,5		Array mit unterstützten Gebotsprotokollen für Videos Es muss mindestens ein unterstütztes Protokoll angegeben werden. Beispiele: VAST_1_0 = 1; VAST_2_0 = 2; VAST_3_0 = 3;
w	Nein	int32	BidRequest.AdSlot.width[0]	2 2,4 2,5		Breite des Videoplayers in geräteunabhängigen Pixeln (DIPS). EMPFOHLEN durch die OpenRTB-Spezifikation.
h	Nein	int32	BidRequest.AdSlot.height[0]	2 2,4 2,5		Höhe des Videoplayers in geräteunabhängigen Pixeln (DIPS). EMPFOHLEN durch die OpenRTB-Spezifikation.
startdelay	Nein	int32	BidRequest.Video.videoad_start_delay >0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL Andere Werte: videoad_start_delay / 1.000	2 2,4 2,5		Damit wird die Startverzögerung in Sekunden für Pre-Roll-, Mid-Roll- oder Post-Roll-Anzeigen-Placements angegeben. Allgemeine Werte findest du in der Aufzählung StartDelay. EMPFOHLEN durch die OpenRTB-Spezifikation.
skip	Nein	bool	BidRequest.Video.video_ad_überspringbar	2,4 2,5		Gibt an, ob der Player erlaubt, das Video zu überspringen, wobei 0 = nein, 1 = ja. Wenn ein Bieter Markup oder Creative sendet, das selbst überspringbar ist, sollte das Bid-Objekt das JWT-Array mit einem Element von 16 enthalten, das ein überspringbares Video angibt.
skipmin	Nein	int32	Nicht unterstützt	2,4 2,5		Videos mit einer Gesamtdauer von mehr als dieser Sekunden können überspringbar sein; nur wenn die Anzeige überspringbar ist.
skipafter	Nein	int32	Nicht unterstützt	2,4 2,5		Anzahl der Sekunden, die ein Video wiedergegeben werden muss, bevor das Überspringen aktiviert ist; nur wenn die Anzeige überspringbar ist.
sequence	Nein	int32	Nicht unterstützt	2 2,4 2,5		Wenn in einer Gebotsanfrage mehrere Anzeigenimpressionen angeboten werden, ermöglicht die Sequenznummer die koordinierte Auslieferung mehrerer Creatives.[default = 1];
battr	Nein	Array für Creative-Attribut	BidRequest.AdSlot.excluded_attribute	2 2,4 2,5		Blockierte Creative-Attribute.
maxextended	Nein	int32	Nicht unterstützt	2 2,4 2,5		Maximale Dauer von erweiterten Videoanzeigen, wenn die Erweiterung zulässig ist Wenn das Feld leer oder auf 0 gesetzt ist, ist die Erweiterung nicht zulässig. Wenn „-1“ angegeben ist, ist die Erweiterung zulässig und es gibt kein Zeitlimit. Wenn sie größer als 0 ist, entspricht der Wert der Anzahl der Sekunden erweiterter Wiedergabe, die über den Wert für die maximale Dauer hinaus unterstützt wird.
minbitrate	Nein	int32	Nicht unterstützt	2 2,4 2,5		Minimale Bitrate in Kbit/s
maxbitrate	Nein	int32	Nicht unterstützt	2 2,4 2,5		Maximale Bitrate in Kbit/s.
boxingallowed	Nein	bool	Nicht unterstützt	2 2,4 2,5		Gibt an, ob Letterbox-Bild in 4:3-Inhalten in einem 16:9-Fenster zulässig ist, wobei 0 = nein, 1 = ja. default = true
playbackmethod	Nein	Array für Wiedergabemethode	BidRequest.Video.playback_method AdX: VideoPlaybackMethod.AUTO_PLAY_SOUND_ON VideoPlaybackMethod.AUTO_PLAY_SOUND_OFF VideoPlaybackMethod.CLICK_TO_PLAY VideoPlaybackMethod.MOUSE_OVER VideoPlaybackMethod.ENTER_SOUND_ON VideoPlaybackMethod.ENTER_SOUND_OFF	2 2,4 2,5		Mögliche Wiedergabemethoden. Wenn keine angegeben sind, kann eine beliebige Methode verwendet werden. In der Praxis wird in der Regel nur eine Methode verwendet. Deshalb kann das Array in einer zukünftigen Version der Spezifikation in eine Ganzzahl konvertiert werden. Es wird dringend empfohlen, nur das erste Element dieses Arrays zur Vorbereitung auf diese Änderung zu verwenden. AUTO_PLAY_SOUND_ON = 1: Initiiert beim Laden der Seite mit aktiviertem Ton. AUTO_PLAY_SOUND_OFF = 2: Initiiert beim Laden der Seite mit standardmäßig ausgeschaltetem Ton. CLICK_TO_PLAY = 3: Initiiert bei Klick mit eingeschaltetem Ton. MOUSE_OVER = 4: Initiiert bei Mouseover mit eingeschaltetem Ton. ENTER_SOUND_ON = 5: Initiiert beim Betreten des Darstellungsbereichs mit eingeschaltetem Ton. ENTER_SOUND_OFF = 6: Initiiert die Aktivierung des Darstellungsbereichs mit standardmäßig deaktiviertem Ton.
delivery	Nein	Array mit ContentDelivery Method	Nicht unterstützt	2 2,4 2,5		Unterstützte Liefermethoden (z. B. Streaming, progressiv). Wenn keine angegeben ist, wird davon ausgegangen, dass alle unterstützt werden. STREAMING = 1; Progressive = 2;
pos	Nein	AdPosition	BidRequest.AdSlot.slot_sichtbarkeit	2 2,4 2,5		Anzeigenposition auf dem Bildschirm
companionad	Nein	Array mit Banner-Objekten	BidRequest.Video.companion_slot	2 2,4 2,5		Array mit Banner-Objekten, wenn Companion-Anzeigen verfügbar sind.
api	Nein	Array mit APIFramework-Objekten	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2 2,4 2,5		Liste der unterstützten API-Frameworks für diese Impression. Wenn eine API nicht explizit aufgeführt ist, wird angenommen, dass sie nicht unterstützt wird.
companiontype	Nein	Array mit CompanionType-Objekten	BidRequest.Video.companion_slot.creative_format	2 2,4 2,5		Unterstützte VAST-Companion-Anzeigentypen Empfohlen, wenn Banner-Companion-Objekte über das Array companionad eingeschlossen sind.
placement	Nein	VideoPlacementType	BidRequest.Video.Placement INSTREAM -> IN_STREAM_PLACEMENT INTERSTITIAL -> FLOATING_PLACEMENT IN_FEED -> IN_FEED_PLACEMENT IN_ARTICLE -> IN_ARTICLE_PLACEMENT UNKNOWN_PLACEMENT -> UNDEFINED_VIDEO_PLACEMENT AUDIO -> UNDEFINED_VIDEO_PLACEMENT (nicht festgelegt) -> IN_BANNER_PLACEMENT	4,0		Der Placement-Typ für die Impression. UNDEFINED_VIDEO_PLACEMENT: Das Video-Placement ist nicht definiert. Standardwert. IN_STREAM_PLACEMENT: Wird vor, während oder nach dem Videoinhalt abgespielt, den der Nutzer angefordert hat. Zum Beispiel Pre-Roll, Mid-Roll, Post-Roll. IN_BANNER_PLACEMENT: In einem Web-Banner, das den Bannerbereich nutzt, um Videos bereitstellen zu können – im Gegensatz zu anderen statischen oder Rich Media-Formaten. Bei diesem Format muss auf der Seite Inventar für Displayanzeigen vorhanden sein. IN_ARTICLE_PLACEMENT: Lädt und wird dynamisch zwischen zwei Absätzen mit redaktionellem Inhalt abgespielt; es entsteht eine eigenständige Markenbotschaft. IN_FEED_PLACEMENT: In-Feed – in Content-, sozialen oder Produktfeeds enthalten. FLOATING_PLACEMENT: Interstitial/Schieberegler/Unverankert. Deckt den gesamten Bildschirmbereich oder einen Teil davon ab, ist aber während der Anzeige immer auf dem Bildschirm zu sehen (z. B. kann nicht aus dem Sichtfeld gescrollt werden). Ein Vollbild-Interstitial (z. B. auf Mobilgeräten) kann durch das Feld „p.instl.“ von einer schwimmenden/Schiebereglereinheit unterschieden werden.
playbackend	Nein	PlaybackCessationMode	Nicht unterstützt	4,0		Das Ereignis, durch das die Wiedergabe beendet wird.

Audio

Dieses Objekt stellt eine Audiotyp-Impression dar. Viele der Felder sind für minimal tragbare Transaktionen nicht unerlässlich, bieten aber bei Bedarf eine genaue Kontrolle. Bei Audio in OpenRTB wird im Allgemeinen die Einhaltung des DAAST-Standards vorausgesetzt. Daher wird das Konzept von Companion-Anzeigen unterstützt, indem optional ein Array mit Banner-Objekten eingeschlossen wird, die diese Companion-Anzeigen definieren. Das Vorhandensein eines Audio-Objekts als untergeordnetes Element des Imp-Objekts bedeutet, dass diese Impression als Audiotyp-Impression angeboten wird. Nach Ermessen des Publishers kann diese Impression auch als Banner, Video und/oder native Anzeige angeboten werden, indem auch Imp dieser Objekte untergeordnet wird. Jedes Gebot für die Impression muss jedoch einem der angebotenen Typen entsprechen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
mimes	Nein	String-Array	BidRequest.Video.allowed_video_formats, BidRequest.AdSlot.excluded_attribute / VPAID	2,4 2,5		Unterstützte Inhalts-MIME-Typen (z. B. „audio/mp4“) Erforderlich gemäß der OpenRTB-Spezifikation: mindestens ein Element
minduration	Nein	int32	BidRequest.Video.min_ad_Dauer	2,4 2,5		Mindestdauer der Videoanzeige in Sekunden. EMPFOHLEN durch die OpenRTB-Spezifikation.
maxduration	Nein	int32	BidRequest.Video.max_ad_duration	2,4 2,5		Maximale Dauer der Videoanzeige in Sekunden. EMPFOHLEN durch die OpenRTB-Spezifikation.
protocols	Nein	Array mit Protocol-Objekten	BidRequest.Video.Protokolle	2,4 2,5		Array mit unterstützten Gebotsprotokollen für Videos Es muss mindestens ein unterstütztes Protokoll angegeben werden. Beispiele: DAAST_1_0 = 9; DAAST_1_0_WRAPPER = 10;
startdelay	Nein	int32	BidRequest.Video.videoad_start_delay >0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL Andere Werte: videoad_start_delay / 1.000	2,4 2,5		Damit wird die Startverzögerung in Sekunden für Pre-Roll-, Mid-Roll- oder Post-Roll-Anzeigen-Placements angegeben. Allgemeine Werte findest du in der Aufzählung StartDelay. EMPFOHLEN durch die OpenRTB-Spezifikation.
sequence	Nein	int32	Nicht unterstützt	2,4 2,5		Wenn in einer Gebotsanfrage mehrere Anzeigenimpressionen angeboten werden, ermöglicht die Sequenznummer die koordinierte Auslieferung mehrerer Creatives.[default = 1];
battr	Nein	Array mit CreativeAttribute-Objekten	BidRequest.AdSlot.excluded_attribute	2,4 2,5		Blockierte Creative-Attribute.
maxextended	Nein	int32	Nicht unterstützt	2,4 2,5		Maximale Dauer von erweiterten Videoanzeigen, wenn die Erweiterung zulässig ist Wenn das Feld leer oder auf 0 gesetzt ist, ist die Erweiterung nicht zulässig. Wenn „-1“ angegeben ist, ist die Erweiterung zulässig und es gibt kein Zeitlimit. Wenn sie größer als 0 ist, steht der Wert für die Anzahl der Sekunden der erweiterten Wiedergabe, die über den Wert von maxduration hinaus unterstützt wird.
minbitrate	Nein	int32	Nicht unterstützt	2,4 2,5		Minimale Bitrate in Kbit/s
maxbitrate	Nein	int32	Nicht unterstützt	2,4 2,5		Maximale Bitrate in Kbit/s.
delivery	Nein	Array mit ContentDeliveryMethod-Objekten	Nicht unterstützt	2,4 2,5		Unterstützte Liefermethoden (z. B. Streaming, progressiv). Wenn keine angegeben ist, wird davon ausgegangen, dass alle unterstützt werden. STREAMING = 1; Progressive = 2;
companionad	Nein	Array mit Banner-Objekten	BidRequest.Video.companion_Anzeigenfläche	2,4 2,5		Array mit Banner-Objekten, wenn Companion-Anzeigen verfügbar sind.
api	Nein	Array mit APIFramework-Objekten	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,4 2,5		Liste der unterstützten API-Frameworks für diese Impression. Wenn eine API nicht explizit aufgeführt ist, wird angenommen, dass sie nicht unterstützt wird.
companiontype	Nein	Array mit CompanionType-Objekten	BidRequest.Video.companion_slot.creative_format	2,4 2,5		Unterstützte Anzeigentypen für die DAAST-Companion-Anzeige
maxseq	Nein	int32	Nicht unterstützt	2,4 2,5		Die maximale Anzahl von Anzeigen, die in einem Anzeigen-Pod wiedergegeben werden können.
feed	Nein	Feedtyp	Nicht unterstützt	2,4 2,5		Typ des Audiofeeds.
stitched	Nein	bool	Nicht unterstützt	2,4 2,5		Gibt an, ob die Anzeige mit Audioinhalten kombiniert wurde oder unabhängig ausgeliefert wird, wobei 0 = nein, 1 = ja.
nvol	Nein	VolumeNormalizationMode	Nicht unterstützt	2,4 2,5		Modus zur Volume-Normalisierung

Nativ

Dieses Objekt stellt eine native Typ-Impression dar. Native Anzeigenblöcke lassen sich nahtlos in den umgebenden Content einfügen, z. B. in eine gesponserte Anzeige auf Twitter oder Facebook. Daher muss die Antwort gut strukturiert sein, damit der Publisher das Rendering genau steuern kann.

Beachten Sie, dass Native 1.1 in OpenRTB 2.4 und OpenRTB 2.5 unterstützt wird.

Das native Subcommittee entwickelte eine Companion-Spezifikation für OpenRTB, die Spezifikation für native Anzeigen. Damit werden die Anfrageparameter und die Markup-Struktur von nativen Anzeigenblöcken definiert.

Dieses Objekt bietet die Möglichkeit, Anfrageparameter als undurchsichtigen String zu übertragen, sodass die spezifischen Parameter gemäß der Spezifikation für native Anzeigen separat weiterentwickelt werden können. In gleicher Weise wird das bereitgestellte Anzeigen-Markup gemäß dieser Spezifikation strukturiert. Das Vorhandensein eines Native als untergeordnetes Element des Imp-Objekts zeigt an, dass diese Impression als native native Impression angeboten wird. Auf Verlag des Publishers kann dieselbe Impression auch als Banner und/oder Video angeboten werden. Dies schließt auch ein, wenn Imp die Banner- und/oder Video-Objekte untergeordnet ist. Jedes Gebot für die Impression muss jedoch einem der angebotenen Typen entsprechen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
request	Nein	String	BidRequest.AdSlot.NativeAdVorlage	2 2,4 2,5		Fordern Sie die Nutzlast an, die der Spezifikation für native Anzeigen entspricht. Genau eines von {request, request_native} sollte verwendet werden.
request_native	Nein	Native Anfrage	BidRequest.AdSlot.NativeAdVorlage	2 2,4 2,5		Fordern Sie die Nutzlast an, die der Spezifikation für native Anzeigen entspricht. Genau eines der {request, request_native} sollte verwendet werden. Dieses Feld wird für die Protobuf-Serialisierung bevorzugt.
ver	Nein	String	EMPFOHLEN durch die OpenRTB-Spezifikation.	2 2,4 2,5		Die Version der Spezifikation für native Anzeigen, der die Anfrage entspricht. EMPFOHLEN durch die OpenRTB-Spezifikation.
api		Array mit APIFramework-Objekten	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2 2,4 2,5		Liste der unterstützten API-Frameworks für diese Impression. Wenn eine API nicht explizit aufgeführt ist, wird angenommen, dass sie nicht unterstützt wird.
battr		Array mit CreativeAttribute-Objekten	BidRequest.AdSlot.excluded_attribute	2 2,4 2,5		Blockierte Creative-Attribute.

Kraftstoffverbrauch

Dieses Objekt ist der private Marktplatzcontainer für Direct Deals zwischen Käufern und Verkäufern, die unter Umständen für diese Impression relevant sind. Die tatsächlichen Deals werden als Sammlung von Deal-Objekten dargestellt.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
private_auction	Nein	bool	BidRequest.AdSlot.only_deal_bids_accepted	2 2,4 2,5		Indikator für die Eignung von Auktionen für Plätze, die im Objekt „Direct Deals“ genannt sind, wobei 0 = alle Gebote akzeptiert werden, 1 = Gebote auf die angegebenen Deals und die zugehörigen Bedingungen beschränkt sind.
deals	Nein	Array mit Deal-Objekten	BidRequest.AdSlot.MatchingAdData.DirectDeal	2 2,4 2,5		Array mit Deal-Objekten, die die spezifischen Deals vermitteln, die für diese Impression gelten.

Deal

Dieses Objekt stellt einen bestimmten Deal dar, der zwischen Käufer und Verkäufer priorisiert wurde. Wenn eine Impression mit der Erhebung erfasst wird, bedeutet dies, dass diese Impression gemäß den Bedingungen dieses Deals verfügbar ist.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Ja	String	BidRequest.AdSlotMatchingAdData.DirectDeal.direct_deal_id	2 2,4 2,5		Eine eindeutige Kennung für den Direct Deal. Erforderlich gemäß der OpenRTB-Spezifikation.
bidfloor	Nein	Doppelwert	BidRequest.AdSlot.MatchingAdData.DirectDeal.fixed_cpm _micros *1.000.000	2 2,4 2,5		Das Mindestgebot für diese Impression, ausgedrückt in CPM.
bidfloorcur	Nein	String	Einzelne Währung, abgerufen aus dem enthaltenen billing_id	2 2,4 2,5		Die Währung wird mit ISO-4217-Alphacodes angegeben. Diese kann von der vom Bieter zurückgegebenen Währung abweichen, wenn das von der Anzeigenplattform zulässig ist (Standardeinstellung).
wseat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Zulassungsliste von Käufersitzen (z. B. Werbetreibende, Agenturen), die für diesen Deal Gebote abgeben dürfen. IDs der Sitze und Kenntnis der Kunden, auf die sie verweisen, müssen sich zwischen Bietern und Anzeigenplattform koordinieren. Die Omission bedeutet, dass keine Sitzbeschränkungen gelten.
wadomain	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array von Werbetreibendendomains, z. B. Werbetreibender.de, die für diesen Deal Gebote abgeben dürfen Auslassung bedeutet, dass es keine Einschränkungen für Werbetreibende gibt.
at	Nein	Auktionstyp	BidRequest.auction_type	2 2,4 2,5		Optionale Überschreibung des gesamten Auktionstyps der Gebotsanfrage, wobei 1 = Erster Preis, 2 = Zweiter Preis plus, 3 = der in der Gebotsabgabe übergebene Wert dem vereinbarten Dealpreis entspricht. Zusätzliche Auktionstypen können von der Anzeigenplattform definiert werden.
ext	Nein	DealExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.deal] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Für OpenRTB/JSON steht Ihnen das Feld ext in der Deal-Nachricht zur Verfügung.

DealExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
deal_type	Nein	DealType (Aufzählung)	BidRequest.AdSlot.MatchingAdData.DirectDeal.deal_type	Der Typ des Deals. Die Authorized Buyers-Richtlinienüberschreibungen gelten für alle programmatisch garantierten und Preferred Deal-Gebote, nicht für Gebote für andere Dealtypen. UNKNOWN_DEAL_TYPE = 0; Standard PREFERRED_DEAL = 1; Gebote werden vor der offenen Auktion zum Festpreis berechnet und ausgewertet. Bieter müssen nicht mit Preferred Deals bieten, wenn sie in der Gebotsanfrage vorhanden sind. Weitere Informationen finden Sie in diesem Artikel. PRIVATE_AUCTION = 2; Gebote nehmen an einer privaten Auktion mit einer ausgewählten Liste von Käufern mit bestimmten Mindestpreisen teil. Weitere Informationen finden Sie in diesem Artikel. PROGRAMMATIC_GUARANTEED = 3; Gebote werden vor der offenen Auktion zum Festpreis berechnet und ausgewertet. Bieter müssen immer auf programmatisch garantierte Deals bieten, sobald sie in einer Gebotsanfrage vorhanden sind. Das Feld „must_bid“ muss auf „true“ gesetzt sein, damit die für einen bestimmten Deal vereinbarte Anzahl von Impressionen erzielt wird. Weitere Informationen finden Sie in diesem Artikel. AUCTION_PACKAGE = 4; Die Deal-ID ist eine Kennung für eine Sammlung von Inventar in offenen Auktionen, das mit bestimmten Targeting-Kriterien übereinstimmt. Weitere Informationen finden Sie in diesem Artikel. MARKETPLACE_PACKAGE = 5; die Deal-ID für vom Publisher zusammengestellte Inventarpakete. Diese Deal-IDs werden automatisch an alle berechtigten Käufer des Pakets gesendet. Weitere Informationen finden Sie in diesem Artikel.
must_bid	Nein	bool	BidRequest.AdSlot.MatchingAdData.DirectDeal.must_bid	Dieses Feld gilt nur für programmatisch garantierte Deals. Der Käufer darf Gebote für die Impression überspringen, wenn dieses Feld falsch ist. Ist dies der Fall, muss der Käufer auf diesen Deal bieten, damit er eine Impression erzielen kann. Dieses Feld wird beim JSON-Wirkformat immer explizit ausgefüllt. Die Standardeinstellung ist „true“.
publisher_blocks_overridden	Nein	bool	BidRequest.AdSlot.MatchingAdData.DirectDeal.publisher_blocks_overridden	Gibt an, ob der Publisher diesen Deal von konfigurierten Blockierungen ausgenommen hat. Diese Einstellung hat keinen Einfluss auf Authorized Buyers-Richtlinien oder Entscheidungen im Überprüfungszentrum für Anzeigen. Weitere Informationen finden Sie in diesem Artikel.
creative_source	Nein	Enum CreativeSourceType	BidRequest.AdSlot.MatchingAdData.DirectDeal.creative_source	Experimentelles Feld. Änderungen vorbehalten. Eine Aufzählung, in der der Host des Creatives deklariert wird. Sie wird nur für programmatisch garantierte Deals ausgefüllt. Derzeit sollte dieses Feld nur auf CREATIVE_SOURCE_ADVERTISER festgelegt werden. CREATIVE_SOURCE_UNKNOWN = 0; CREATIVE_SOURCE_ADVERTISER = 1; (Standardeinstellung) Das Creative wird vom Werbetreibenden gehostet. Der Bieter muss also ein Creative in der Gebotsantwort angeben. CREATIVE_SOURCE_PUBLISHER = 2; Das Creative wird vom Publisher gehostet, sodass der Bieter kein Creative in die Gebotsantwort aufnehmen muss. Weitere Informationen zu vom Publisher gehosteten Creatives finden Sie unter https://support.google.com/admanager/answer/9243220. Diese Funktion wird derzeit für RTB-Bieter nicht unterstützt.

Website

Dieses Objekt sollte enthalten sein, wenn es sich bei dem werbeunterstützten Inhalt um eine Website handelt, die einer Nicht-Browser-Anwendung gegenübersteht. Eine Gebotsanfrage darf nicht sowohl ein Site- als auch ein App-Objekt enthalten. Es ist sinnvoll, mindestens eine Website-ID oder Seiten-URL anzugeben. Dies ist aber nicht unbedingt erforderlich.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Nein	String	Nicht unterstützt	2 2,4 2,5		Die ID der Anzeigenplattform in der Anzeigenplattform EMPFOHLEN durch die OpenRTB-Spezifikation.
name	Nein	String	Nicht unterstützt	2 2,4 2,5		Websitename (kann auf Anfrage des Publishers maskiert werden)
domain	Nein	String	Nicht unterstützt	2 2,4 2,5		Domain der Website, die für die Blockierung auf Werbetreibendenebene verwendet wird. Beispiel: „foo.com“.
cat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array mit IAB-Inhaltskategorien der Website. Siehe Aufzählung ContentCategory.
sectioncat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array mit IAB-Inhaltskategorien, die den aktuellen Bereich der Website beschreiben. Siehe Aufzählung ContentCategory.
pagecat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array von IAB-Inhaltskategorien, die die aktuelle Seite oder den aktuellen Aufruf der Website beschreiben. Siehe Aufzählung ContentCategory.
page	Nein	String	BidRequest.URL	2 2,4 2,5		URL der Seite, auf der die Impression erzielt wird
privacypolicy	Nein	bool	Nicht unterstützt	2 2,4 2,5		Gibt an, ob die Website eine Datenschutzerklärung enthält, wobei 0 = nein, 1 = ja.
ref	Nein	String	Nicht unterstützt	2 2,4 2,5		Verweis-URL, die zur aktuellen Seite geführt hat.
search	Nein	String	Nicht unterstützt	2 2,4 2,5		Suchstring, durch den die Navigation zur aktuellen Seite ausgelöst wurde.
publisher	Nein	Publisher Objekt	Angebotsanfrage	2 2,4 2,5		Details zum Publisher-Objekt der Website.
content	Nein	Content Objekt	Angebotsanfrage	2 2,4 2,5		Details zum Content innerhalb der Website.
keywords	Nein	String	Nicht unterstützt	2 2,4 2,5		Durch Kommas getrennte Liste mit Keywords zu dieser Website. Hinweis: In OpenRTB 2.2 war eine Reihe von Strings als alternative Implementierung zulässig, aber in 2.3 und höher wurde dieser Fehler behoben und es handelt sich definitiv um einen einzelnen String mit CSV-Inhalten. Die Kompatibilität mit einigen OpenRTB 2.2-Anzeigenplattformen, die die alternative Darstellung übernommen haben, erfordert möglicherweise eine benutzerdefinierte Verarbeitung der JSON-Datei.
mobile	Nein	bool	BidRequest.Mobile.is_mobile_web_optimize	2 2,4 2,5		Gibt an, ob die Website zur Optimierung des Layouts programmiert wurde, wenn sie auf Mobilgeräten angesehen wird, wobei 0 = nein, 1 = ja.
ext	Nein	SiteExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.site] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der Websitenachricht.

SiteExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
amp	Nein	Enum-AmpPage	BidRequest.AdSlot .is_amp_page	Gibt an, ob es eine AMP-Seite ist oder nicht. Ausgelassen, falls unbekannt. DIALECT_HTML = 0; Dies ist keine AMP-Seite. DIALECT_HTML_AMP = 1; Dies ist eine AMP-Seite.
page_visibility	Nein	Sichtbarkeitsstatus von Aufzählungswerten	BidRequest.page_sichtbarkeit	Der Sichtbarkeitsstatus der Webseite, die die Anzeigenfläche enthält. Weitere Informationen finden Sie unter www.w3.org/TR/page-sichtbarkeit/. VISIBILITY_STATE_UNKNOWN = 0 VISIBILITY_STATE_VISIBLE = 1; Die Seite ist mindestens teilweise sichtbar. Das kann beispielsweise auf dem Tab „Front“ eines nicht minimierten Fensters der Fall sein. VISIBILITY_STATE_hidden = 2; Die Seite ist für Nutzer nicht sichtbar. Das ist beispielsweise der Fall, wenn sich die Seite auf einem Tab im Hintergrund oder in einem minimierten Fenster befindet.
is_semi_transparent_request	Nein	bool	BidRequest.is_semi_transparent_Anfrage	Gibt an, dass für die Anfrage ein halbtransparentes Branding verwendet wird. Das bedeutet, dass nur eine gekürzte Version der Anfrage-URL bereitgestellt wird. Diese Entscheidung wird vom Publisher getroffen, siehe support.google.com/admanager/answer/4584891.
inventorypartnerdomain	Nein	String	BidRequest.inventorypartnerdomain	Die Domain des Partners (des App-Inhabers) mit einem Teil des Anzeigeninventars in der App. Hier wird die ads.txt- oder app-ads.txt-Datei des Partners gehostet. Weitere Informationen finden Sie unter http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf.

App

Dieses Objekt sollte enthalten sein, wenn es sich bei dem werbeunterstützten Inhalt um eine nicht browserbasierte Anwendung (normalerweise in der mobilen Version) und nicht um eine Website handelt. Eine Gebotsanfrage darf nicht sowohl ein App- als auch ein Site-Objekt enthalten. Es ist sinnvoll, mindestens eine App-ID oder ein Bundle anzugeben. Dies ist aber nicht unbedingt erforderlich.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Nein	String	Nicht unterstützt	2 2,4 2,5		Anwendungs-ID auf der Anzeigenplattform EMPFOHLEN durch die OpenRTB-Spezifikation.
name	Nein	String	BidRequest.Mobilgerät.app_name	2 2,4 2,5		Name der Anwendung (kann auf Anfrage des Publishers zugeordnet werden)
domain	Nein	String	Nicht unterstützt	2 2,4 2,5		Domain der Anwendung, die für die Blockierung auf Werbetreibendenebene verwendet wird. Beispiel: „meinspiel.foo.com“.
cat	Nein	String-Array	BidRequest.Mobile.app_category_IDs	2 2,4 2,5		Hinweis:Die Werte für dieses Feld werden jetzt entfernt. Array mit IAB-Inhaltskategorien der App. Weitere Informationen findest du in der Aufzählung ContentCategory.
sectioncat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array von IAB-Inhaltskategorien, die den aktuellen Abschnitt der App beschreiben. Weitere Informationen findest du in der Aufzählung ContentCategory.
pagecat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array mit IAB-Inhaltskategorien, die die aktuelle Seite oder den aktuellen Aufruf der App beschreiben. Weitere Informationen findest du in der Aufzählung ContentCategory.
ver	Nein	String	Nicht unterstützt	2 2,4 2,5		Anwendungsversion.
bundle	Nein	String	BidRequest.Mobilgerät.app_id	2 2,4 2,5		Eine plattformspezifische Anwendungs-ID, die eindeutig der App zugeordnet ist und unabhängig von der Anzeigenplattform ist. Unter Android sollte dies ein Bundle- oder Paketname sein (z. B. com.foo.mygame). Unter iOS ist es eine numerische ID.
privacypolicy	Nein	bool	Nicht unterstützt	2 2,4 2,5		Gibt an, ob die Website eine Datenschutzerklärung enthält, wobei 0 = nein, 1 = ja.
paid	Nein	bool	Nicht unterstützt	2 2,4 2,5		0 = Die App ist kostenlos, 1 = Die App ist eine kostenpflichtige Version.
publisher	Nein	Publisher Objekt	Angebotsanfrage	2 2,4 2,5		Details zum Publisher-Objekt der App.
content	Nein	Content Objekt	Angebotsanfrage	2 2,4 2,5		Details zum Content in der App.
keywords	Nein	String	Nicht unterstützt	2 2,4 2,5		Durch Kommas getrennte Liste mit Keywords zu dieser App. Hinweis: In OpenRTB 2.2 war ein Array mit Strings als alternative Implementierung zulässig. Dies wurde jedoch in Version 2.3 und höher behoben. Es ist definitiv ein einzelner String mit CSV-Inhalten. Die Kompatibilität mit einigen OpenRTB 2.2-Anzeigenplattformen, die die alternative Darstellung übernommen haben, erfordert möglicherweise eine benutzerdefinierte Verarbeitung der JSON-Datei.
storeurl	Nein	String	BidRequest.URL	2 2,4 2,5		App Store-URL einer installierten App.
ext	Nein	AppExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.app] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der App-Nachricht.

AppExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
installed_sdk	Nein	Installiert SDD	BidRequest.Mobile.installed_sdk	Identifizierung und Informationen zu einem SDK, das in der App des Publishers installiert ist, auf den der Bieter Zugriff hat – in der Regel, weil es das SDK des Bieters ist
inventorypartnerdomain	Nein	String	BidRequest.inventorypartnerdomain	Die Domain des Partners (des App-Inhabers) mit einem Teil des Anzeigeninventars in der App. Hier wird die ads.txt- oder app-ads.txt-Datei des Partners gehostet. Weitere Informationen finden Sie unter http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf.
Installiert SDD
id	Ja	String	BidRequest.Mobile.InstalliertSdk.id	Kennung für das installierte SDK.
sdk_version	Ja	Version	BidRequest.Mobile.InstalliertSdk.sdk_version	Die Version des installierten SDKs.
adapter_version	Ja	Version	BidRequest.Mobile.InstalliertSdk.adapter_version	Die Version des Adapters, der mit dem installierten SDK kommuniziert.
Version
major	Nein	int32	Nicht unterstützt	Standard = -1.
minor	Nein	int32	Nicht unterstützt	Standard = -1.
micro	Nein	int32	Nicht unterstützt	Standard = -1.

Publisher

Mit diesem Objekt wird der Publisher des Mediums beschrieben, in dem die Anzeige ausgeliefert wird. Der Publisher ist normalerweise der Verkäufer einer OpenRTB-Transaktion.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Nein	String	BidRequest.publisher_id	2 2,4 2,5		Plattformspezifische Publisher-ID, die durch das Publisher-Code-Suffix des Web-Property-Codes definiert wird. pub-123 ist beispielsweise der Publisher-Code des Web-Property-Codes ca-pub-123.
name	Nein	String	Nicht unterstützt	2 2,4 2,5		Publisher-Name (kann auf Anfrage des Publishers Alias erhalten)
cat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array mit IAB-Inhaltskategorien der App. Weitere Informationen finden Sie in der Aufzählung ContentCategory.
domain	Nein	String	Nicht unterstützt	2 2,4 2,5		Domain der obersten Ebene des Publishers, z. B. „publisher.com“
ext	Nein	PublisherExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.publisher] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der Nachricht des Publishers.

PublisherExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
country	Nein	String	Angebotsanfrage .publisher_country	Das Land der Rechnungsadresse des Publishers Dies kann vom erkannten Land des Nutzers in der geo_criteria_id oder vom Hostingland der Website abweichen. Weitere Informationen findest du in der vollständigen Liste der Ländercodes.
host_publisher_id	Nein	String	BidRequest.host_publisher_id	Die ID des Host-Publishers. Wenn er angegeben wird, bedeutet das, dass der Host-Publisher an der Umsatzbeteiligung teilgenommen hat. Die ID kann außerdem zum Autorisieren von ads.txt-Dateien verwendet werden.

Inhalte

Mit diesem Objekt wird der Content beschrieben, in dem die Impression erscheint. Das kann syndizierter oder nicht syndizierter Inhalt sein. Dieses Objekt kann nützlich sein, wenn syndizierter Inhalt Impressionen enthält und nicht unbedingt mit den allgemeinen Inhalten des Publishers übereinstimmt. Die Anzeigenplattform hat möglicherweise aufgrund der Syndikationsmethode keine Kenntnis über die Seite, auf der der Inhalt ausgeführt wird. Ein Beispiel hierfür ist eine Video-Impression, die in einem iFrame auf einer unbekannten Web-Property oder einem unbekannten Gerät eingebettet ist.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Nein	String	Nicht unterstützt	2 2,4 2,5		ID, die den Inhalt eindeutig identifiziert
episode	Nein	int32	Nicht unterstützt	2 2,4 2,5		Nummer der Inhaltsfolge (gilt in der Regel für Videoinhalte)
title	Nein	String	Nicht unterstützt	2 2,4 2,5		Titel des Inhalts Videobeispiele: „Search Committee“ (Fernsehen), „Eine neue Hoffnung“ (Film) oder „Endspiel“ (für das Web). Beispiel für kein Video: „Warum ein Antarktis-Gletscher so schnell schmilzt“ (Zeitmagazinartikel).
series	Nein	String	Nicht unterstützt	2 2,4 2,5		Content-Serie. Videobeispiele: „The Office“ (Fernsehen), „Star Wars“ (Film) oder „Arby 'N' The Chief“ (für das Web). Beispiel für ein Nicht-Video-Video: „Ecocentral“ (Time Magazine-Blog)
season	Nein	String	Nicht unterstützt	2 2,4 2,5		Content Staffel; in der Regel für Videoinhalte (z. B. „Staffel 3“).
artist	Nein	String	Nicht unterstützt	2 2,4 2,5		Mitwirkender mit den Inhalten
genre	Nein	String	Nicht unterstützt	2 2,4 2,5		Genre, das den Inhalt am besten beschreibt (z. B. Rock, Pop usw.)
album	Nein	String	Nicht unterstützt	2 2,4 2,5		Album, zu dem der Inhalt gehört, in der Regel für Audioinhalte.
isrc	Nein	String	Nicht unterstützt	2 2,4 2,5		Internationaler Standard-Aufnahmecode, der ISO-3901 entspricht.
url	Nein	String	(Nur App.content) BidRequest.url	2 2,4 2,5		URL des Inhalts zur kontextbezogenen Kontextualisierung oder Überprüfung.
cat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array mit IAB-Inhaltskategorien, die die Inhalte beschreiben Weitere Informationen findest du in der Aufzählung ContentCategory.
prodq	Nein	Produktionsqualität	Nicht unterstützt	2,4 2,5		Produktionsqualität:
keywords	Nein		Nicht unterstützt	2 2,4 2,5		Durch Kommas getrennte Liste mit Keywords, die den Inhalt beschreiben. Hinweis: In OpenRTB 2.2 war eine Reihe von Strings als alternative Implementierung zulässig, aber in 2.3 und höher wurde dieser Fehler behoben und es handelt sich definitiv um einen einzelnen String mit CSV-Inhalten. Die Kompatibilität mit einigen OpenRTB 2.2-Anzeigenplattformen, die die alternative Darstellung übernommen haben, erfordert möglicherweise eine benutzerdefinierte Verarbeitung der JSON-Datei.
contentrating	Nein	String	BidRequest.detected_content_label 39: „DV_G“, 40: „DV_PG“, 41: „DV_T“, 42: „DV_MA“, 43: „DV_UNRATED“	2 2,4 2,5		Hinweis:Die Werte für dieses Feld werden jetzt entfernt. Altersfreigabe (z. B. MPAA)
userrating	Nein	String	(Nur App.content) BidRequest.Mobilgerät.app_rating	2 2,4 2,5		Nutzerbewertung des Inhalts (z. B. Anzahl der Sterne, „Gefällt mir“-Angaben usw.)
context	Nein	Inhaltskontext	Nicht unterstützt	2 2,4 2,5		Inhaltstyp (Spiel, Video, Text usw.)
context_22	Nein	String	Nicht unterstützt	2 2,4 2,5		OpenRTB <= 2.2, Kompatibilität: Verwende Kontext für 2.3 oder höher.
livestream	Nein	bool	BidRequest.Video.is_livestream	2 2,4 2,5		0 = nicht live, 1 = Inhalte sind live (z. B. Stream oder Liveblog)
sourcerelationship	Nein	bool	Nicht unterstützt	2 2,4 2,5		0 = indirekt, 1 = direkt
producer	Nein	String	BidRequest.Video	2 2,4 2,5		Details zum Ersteller von Inhalten.
len	Nein	int32	BidRequest.Video.ContentAttribute.duration_seconds	2 2,4 2,5		Contentlänge in Sekunden; geeignet für Video- oder Audiocontent.
qagmediarating	Nein	Qualitätssicherung (QAGMediaRating)	Nicht unterstützt	2 2,4 2,5		Media-Bewertung gemäß QAG-Richtlinien
embeddable	Nein	bool	Nicht unterstützt	2 2,4 2,5		Indikator dafür, ob der Inhalt eingebettet werden kann (z. B. ein Videoplayer), wobei 0 = nein, 1 = ja.
language	Nein	String	BidRequest.detected_language	2 2,4 2,5		Inhaltssprache mit ISO-639-1-alpha-2

Ersteller

Mit diesem Objekt wird der Ersteller des Inhalts definiert, in dem die Anzeige eingeblendet wird. Dies ist besonders hilfreich, wenn der Inhalt syndiziert und über verschiedene Publisher verteilt wird und Ersteller und Publisher also nicht unbedingt dieselbe Entität sind.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Nein	String	Nicht unterstützt	2 2,4 2,5		ID des Erstellers oder Urhebers Nützlich, wenn Inhalte syndiziert und auf Websites mit eingebetteten Tags veröffentlicht werden können.
name	Nein	String	Nicht unterstützt	2 2,4 2,5		Name des Erstellers der Inhalte oder des Erstellers (z. B. „Warner Bros“).
cat	Nein	String-Array	Nicht unterstützt	2 2,4 2,5		Array mit IAB-Inhaltskategorien, die den Ersteller der Inhalte beschreiben Weitere Informationen findest du in der Aufzählung ContentCategory.
domain	Nein	String	BidRequest.Video.description_url	2 2,4 2,5		Domain der obersten Ebene des Inhaltserstellers (z. B. „Producer.com“).

Geräte

Dieses Objekt liefert Informationen zum Gerät, über das der Nutzer interagiert. Die Geräteinformationen umfassen die Hardware, die Plattform, den Standort und die Daten des Mobilfunkanbieters. Das Gerät kann sich auf ein Mobilgerät, einen Computer, eine Set-Top-Box oder ein anderes digitales Gerät beziehen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
dnt	Nein	bool	Nicht unterstützt. Weitere Informationen finden Sie im Cookie Guide, google_error=1:	2 2,4 2,5		Die vom Browser festgelegte Standardoption „Do Not Track“ (nicht verfolgen), wobei 0 = Tracking uneingeschränkt ist, 1 = nicht tracken. EMPFOHLEN durch die OpenRTB-Spezifikation.
ua	Nein	String	Angebotsanfrage.user_agent	2 2,4 2,5		User-Agent-String des Browsers. EMPFOHLEN durch die OpenRTB-Spezifikation.
ip	Nein	String	BidRequest.ip (AdX kürzt die ersten drei Oktettes; OpenRTB ist "X.X.X.0")	2 2,4 2,5		IPv4-Adresse, die dem Gerät am nächsten ist. EMPFOHLEN durch die OpenRTB-Spezifikation
geo	Nein	Geo Objekt	Angebotsanfrage	2 2,4 2,5		Standort des Geräts, der der aktuelle Standort des Nutzers ist, der durch ein Geo-Objekt definiert wird. EMPFOHLEN durch die OpenRTB-Spezifikation.
didsha1	Nein	String	Nicht unterstützt	2 2,4 2,5		ID des Hardwaregeräts (z. B. IMEI); gehasht über SHA1
didmd5	Nein	String	Nicht unterstützt	2 2,4 2,5		Hardware-Geräte-ID (z. B. IMEI); gehasht über MD5.
dpidsha1	Nein	String	Nicht unterstützt	2 2,4 2,5		Plattform-Geräte-ID (z. B. Android-ID); gehasht über SHA1
dpidmd5	Nein	String	BidRequest.Mobile.hashed_idfa – AdX ist binär, OpenRTB ist base16 (Hexadezimalwert) Dies ist die gehashte Version von ifa. Entspricht dpidmd5 oder ist je nach SDK-Version für Mobilgeräte verfügbar.	2 2,4 2,5		Geräte-ID der Plattform (z. B. Android-ID); gehasht über MD5.
ipv6	Nein	String	BidRequest.ip – AdX kürzt die ersten sechs Oktetts. OpenRTB ist „X:X:X::::“	2 2,4 2,5		IPv6-Adresse, die dem Gerät am nächsten ist.
carrier	Nein	String	Die IDs.Device.carrier_id sind die gleichen Kriteriums-IDs wie im Authorized Buyers-Protokoll. Weitere Informationen finden Sie in der Liste der Mobilfunkanbieter.	2 2,4 2,5		Dies ist ein Mobilfunkanbieter oder ISP (z. B. „VERIZON“), der zusammengestellte Stringnamen enthält, die den Bietern vorrangig veröffentlicht werden sollten.
language	Nein	String	Nicht unterstützt	2 2,4 2,5		Browsersprache im Format ISO-639-1-alpha-2
make	Nein	String	BidRequest.Gerät.marke	2 2,4 2,5		Marke des Geräts, z. B. „Apple“
model	Nein	String	BidRequest.Gerät.Modell	2 2,4 2,5		Gerätemodell (z. B. „iPhone“)
os	Nein	String	Angebotsanfrage.Gerät.Plattform	2 2,4 2,5		Betriebssystem des Geräts, z. B. „iOS“
osv	Nein	String	Angebotsanfrage.Gerät.os_version	2 2,4 2,5		Betriebssystemversion des Geräts
hwv	Nein	String	BidRequest.Gerät.hardware_version	2 2,4 2,5		Hardwareversion des Geräts, z. B. „5S“ für iPhone 5S
w	Nein	int32	BidRequest.Gerät.screen_width	2 2,4 2,5		Physische Breite des Bildschirms in Pixeln.
h	Nein	int32	Angebotsanfrage.Gerät.screen_height	2 2,4 2,5		Physische Höhe des Bildschirms in Pixeln.
ppi	Nein	int32	Nicht unterstützt	2 2,4 2,5		Bildschirmgröße als Pixel pro linearem Zoll
pxratio	Nein	Doppelwert	BidRequest.Gerät.screen_pixel_ratio_millis / 1.000	2 2,4 2,5		Das Verhältnis physischer Pixel zu geräteunabhängigen Pixeln.
js	Nein	bool	Nicht unterstützt	2 2,4 2,5		Unterstützung von JavaScript, wobei 0 = nein, 1 = ja.
geofetch	Nein	bool	Nicht unterstützt	2,4 2,5		Gibt an, ob die Geolocation API für JavaScript-Code verfügbar ist, der im Banner ausgeführt wird. Dabei gilt: 0 = nein, 1 = ja.
connectiontype	Nein	Verbindungstyp	Nicht unterstützt	2 2,4 2,5		Typ der Netzwerkverbindung
devicetype	Nein	DeviceType	BidRequest.Gerät.device_type	2 2,4 2,5		Der allgemeine Gerätetyp.
flashver	Nein	String	Nicht unterstützt	2 2,4 2,5		Flash-Version, die vom Browser unterstützt wird.
ifa	Nein	String	BidRequest.Mobile.advertising_id – AdX ist binär, OpenRTB ist eine 36-Zeichen-UUID (Android-ID: vollständig kleingeschrieben, IDFA: nur großbuchstaben). ifa ist entweder die Android-ID oder IDFA von Apple und entweder dpidmd5 oder ifa ist je nach Mobile SDK-Version verfügbar.	2 2,4 2,5		ID, die für die Verwendung des Werbetreibenden in der Klarheit (z. B. nicht gehasht) sanktioniert wurde.
macsha1	Nein	String	Nicht unterstützt	2 2,4 2,5		MAC-Adresse des Geräts; gehasht über SHA1
macmd5	Nein	String	Nicht unterstützt	2 2,4 2,5		MAC-Adresse des Geräts; gehasht über MD5
lmt	Nein	bool	BidRequest.Gerät.limit_ad_tracking	2 2,4 2,5		„Anzeigen-Tracking einschränken“ ist ein kommerziell empfohlenes Signal auf Grundlage der Betriebssystem- oder Geräteeinstellungen, wobei false darauf hinweist, dass das Tracking nicht eingeschränkt ist, und true, dass das Tracking gemäß den kommerziellen Richtlinien eingeschränkt werden muss. Dieses Signal spiegelt die Entscheidungen von Nutzern auf Plattformen wie App-Tracking-Transparenz von iOS wider. Weitere Informationen finden Sie in den Richtlinien für die Transparenz von App-Tracking und App-Tracking sowie in der Android-Werbe-ID.
mccmnc	Nein	String	Nicht unterstützt	4,0		Der Mobilfunkanbieter als verketteter Kundencenter-MNC-Code (z. B. „310-005“ identifiziert Verizon Wireless CDMA in den USA). Weitere Beispiele findest du unter https://en.wikipedia.org/wiki/Mobile_country_code. Der Bindestrich zwischen dem MCC und dem MNC ist erforderlich, um Parsing-Unklarheiten zu vermeiden.
ext	Nein	DeviceExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.device] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der Gerätenachricht.

DeviceExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
session_id	Nein	String	BidRequest.session_id	Eine kurzlebige Nutzersitzung auf CTV-/OTT-Geräten mit einer maximalen Sitzungsdauer von 6 Stunden. Die Verwendung von „session_id“ ist für personalisierte Anzeigen nie zulässig. session_id darf nur für Frequency Capping, Konkurrenzausschlüsse oder ähnliche Zwecke verwendet werden. Dieses Feld wird mit websicherem Alphabet für Base64 ausgefüllt.
atts	Nein	int32	BidRequest.Gerät.app_tracking_authorization_status	(Nur iOS) Eine Ganzzahl, die für den App-Tracking-Autorisierungsstatus der App übergeben wird, wobei 0 = nicht bestimmt 1 = eingeschränkt 2 = abgelehnt 3 = autorisiert. Dieser Wert wird von ATTrackingManager abgerufen und unverändert bereitgestellt. Weitere Informationen zum App-Tracking-Autorisierungsstatus von iOS finden Sie in diesem Artikel.
user_agent_data	Nein	UserAgent Objekt	BidRequest.user_agent_data	Informationen zum User-Agent.

User-Agent

Informationen zum User-Agent. Sie wird mit Informationen zum User-Agent ausgefüllt, die aus dem User-Agent-Header oder aus den Sec-CH-UA-Headern extrahiert wurden.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
browser	Nein	BrandVersion Objekt	BidRequest.user_agent_data.Browser	Identifiziert den Browser
platform	Nein	BrandVersion Objekt	BidRequest.user_agent_data.platform	Kennzeichnet die Plattform.
mobile	Nein	bool	BidRequest.user_agent_data.mobile	„True“, wenn der Agent „für Mobilgeräte optimierte Inhalte“ bevorzugt. Weitere Informationen zum Gerät finden Sie im Feld „BidRequest.device“. Diese Informationen können mit diesem Feld übereinstimmen, z. B. kann der Browser eines Smartphones „Desktop site“ anfordern.
architecture	Nein	String	BidRequest.user_agent_data.architecture	Gerätearchitektur, z. B. „x86“ oder „Arm“.
bitness	Nein	String	BidRequest.user_agent_data.bitness	Bit-Nummer des Geräts, z. B. „64“ für eine 64-Bit-Architektur
model	Nein	String	BidRequest.user_agent_data.model	Gerätemodell

BrandVersion-Objekt

Ein Semikolon von (Marke, Version) für den Browser oder die Plattform.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
brand	Nein	String	BidRequest.user_agent_data.brand	Markenkennzeichnung, z. B. „Chrome“ oder „Windows“.
version	Nein	String	BidRequest.user_agent_data.version	Version, bei Bedarf in Komponenten aufteilen, z. B. {"85", "1"} = v85.1.

Geo

Dieses Objekt enthält verschiedene Methoden zum Angeben eines geografischen Standorts. Wenn er einem Device-Objekt untergeordnet ist, gibt es den Standort des Geräts an, das auch als aktueller Standort des Nutzers interpretiert werden kann. Ist er einem User-Objekt untergeordnet, wird der Standort der Basis des Nutzers angegeben (z. B. nicht unbedingt der aktuelle Standort). Die Attribute lat/lon sollten nur übergeben werden, wenn sie der im Typattribut dargestellten Genauigkeit entsprechen. Der Schwerpunkt einer geografischen Region wie einer Postleitzahl sollte beispielsweise nicht übergeben werden.

Bei der Implementierung von Google für OpenRTB werden ungefähre Standortinformationen anhand der IP-Adresse des Geräts geschätzt, von dem die Anzeigenanfrage stammt. Diese Informationen sind in der Regel, aber nicht immer, in der Gebotsanfrage enthalten. lat/lon steht für den Mittelpunkt eines Kreises, wobei accuracy der Radius ist. Weitere Informationen zur Standortbestimmung finden Sie in der Anleitung zur geografischen Ausrichtung.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
lat	Nein	Doppelwert	BidRequest.[encrypted_]hyperlocal_set. center_point.Breitengrad	2 2,4 2,5		Breitengrad von -90,0 bis +90,0, wobei negativ Süd ist
lon	Nein	Doppelwert	BidRequest.[encrypted_]hyperlocal_set.center_point.Längengrad	2 2,4 2,5		Längengrad von -180.0 bis +180.0, wobei negativ West ist.
country	Nein	String	BidRequest.geo_Criteria_id durch geo-table.csv	2 2,4 2,5		Land mit ISO-3166-1 Alpha-3.
region	Nein	String	BidRequest.geo_Criteria_id durch geo-table.csv	2 2,4 2,5		Regionscode mit ISO-3166-2; aus zwei Buchstaben bestehender Bundesstaat, wenn USA.
regionfips104	Nein	String		2 2,4 2,5		Region eines Landes mit der FIPS-10-4-Notation. Obwohl OpenRTB dieses Attribut unterstützt, wurde es 2008 von NIST zurückgezogen.
metro	Nein	String	BidRequest.geo_Criteria_id durch geo-table.csv, City-dma-regions.csv	2 2,4 2,5		Google-Großraumcode, ähnelt den Nielsen-DMAs, aber nicht genau davon Auf der Seite Geografisches Targeting finden Sie einen Link zu den Codes.
city	Nein	String	BidRequest.geo_Criteria_id durch geo-table.csv	2 2,4 2,5		Ort mit dem UN-Code für Handels- und Transportstandorte im Format "city": "San Antonio".Einen Link zu den Codes finden Sie in Anhang A.
zip	Nein	String	Angebotsnummer.postal_code BidRequest.postal_code_prefix	2 2,4 2,5		Postleitzahl.
type	Nein	LocationType		2 2,4 2,5		Quelle der Standortdaten; empfohlen, wenn Breiten- und Längengrad übergeben werden.
accuracy	Nein	int32	Nicht unterstützt	2,4 2,5		Geschätzte Standortgenauigkeit in Metern; empfohlen, wenn Breiten- und Längengrad angegeben und von den Standortdiensten eines Geräts abgeleitet werden (z. B. Typ = 1). Beachten Sie, dass es sich hierbei um die vom Gerät gemeldete Genauigkeit handelt. Eine genaue Interpretation finden Sie in der Dokumentation zum Betriebssystem (z. B. Android oder iOS). Google: Der Radius des Kreises, der den ungefähren Standort eines Geräts angibt. Der Mittelpunkt wird durch Breiten- und Längengrad definiert. Dieses Feld wird basierend auf der groben IP-basierten Standortbestimmung ausgefüllt.
lastfix	Nein	int32	Nicht unterstützt	2,4 2,5		Anzahl der Sekunden, seit diese Standortbestimmung erfolgt ist. Beachten Sie, dass Geräte Daten zu mehreren Abrufen abrufen können. Idealerweise sollte der Wert ab dem Zeitpunkt der tatsächlichen Korrektur liegen.
ipservice	Nein	Standortservice	Nicht unterstützt	2,4 2,5		Dienst oder Anbieter, der gegebenenfalls den Standort anhand der IP-Adresse ermittelt (z. B. Typ = 2).
utcoffset	Nein	int32	BidRequest.timezone_offset	2 2,4 2,5		Ortszeit als Anzahl +/- von Minuten ab UTC

Nutzer

Dieses Objekt enthält Informationen, die über den menschlichen Nutzer des Geräts bekannt oder abgeleitet sind (z. B. die Zielgruppe für Werbung). Die Nutzer-ID ist ein Austauschartefakt und kann einer Rotation oder anderen Datenschutzrichtlinien unterliegen. Diese Nutzer-ID muss aber lang genug sein, um als Grundlage für Frequency Capping und Retargeting zu dienen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Nein	String	BidRequest.[restricted_usage_]google_user_id –	2 2,4 2,5		Plattformspezifische ID für den Nutzer. Mindestens einer der Werte id oder buyerid wird empfohlen
buyeruid	Nein	String	BidRequest.[restricted_usage_]hosted_match_data – AdX ist binär, OpenRTB ist websicher Base64 (kein Abstand)	2 2,4 2,5		Käuferspezifische ID für den Nutzer, die von der Anzeigenplattform für den Käufer zugeordnet wird Mindestens einer der Werte buyerid oder id wird empfohlen.
gender	Nein	String	Nicht unterstützt	2 2,4 2,5		Geschlecht als „M“ männlich, „F“ weiblich, „O“ Sonstiges (Null bedeutet unbekannt)
keywords	Nein	String	Nicht unterstützt	2 2,4 2,5		Durch Kommas getrennte Liste von Keywords, Interessen oder Absichten. Hinweis: In OpenRTB 2.2 war eine Reihe von Strings als alternative Implementierung zulässig, aber in 2.3 und höher wurde dieser Fehler behoben und es handelt sich definitiv um einen einzelnen String mit CSV-Inhalten. Die Kompatibilität mit einigen OpenRTB 2.2-Anzeigenplattformen, die die alternative Darstellung übernommen haben, erfordert möglicherweise eine benutzerdefinierte Verarbeitung der JSON-Datei.
customdata	Nein	String	BidRequest.[restricted_usage_]hosted_match_data – AdX ist binär, OpenRTB ist websicher Base64 (kein Abstand)	2 2,4 2,5		Optionale Funktion zur Übergabe von Datensätzen, die im Cookie der Anzeigenplattform gespeichert wurden. Der String muss in base85-Cookie-sicheren Zeichen vorliegen und in einem beliebigen Format vorliegen. Die richtige JSON-Codierung muss mit Anführungszeichen in der Escape-Datei verwendet werden.
geo	Nein	Geo Objekt	Nicht unterstützt	2 2,4 2,5		Standort der Basis des Nutzers, definiert durch ein Geo-Objekt. Es handelt sich dabei nicht unbedingt um den aktuellen Standort.
data	Nein	Array mit Data-Objekten	BidRequest.detected_Vertical	2 2,4 2,5		Hinweis:Die Werte für dieses Feld werden jetzt entfernt. Zusätzliche Kontextdaten. Jedes Data-Objekt steht für eine andere Datenquelle. segment.id verweist auf die von der Anzeigenplattform erkannte Branche der Seite. segment.value entspricht der Gewichtung der erkannten Branche. Eine höhere Gewichtung deutet darauf hin, dass die Seite für die erkannte Branche relevanter ist.
ext	Nein	UserExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.user] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der Nutzernachricht.

Nutzerext

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
consented_providers_settings	Nein	ConsentedProvidersSettings Objekt	BidRequest.AdSlot.consented_providers_settings	Informationen zu den Anzeigentechnologie-Anbietern, für die der Publisher Google mitgeteilt hat, dass ein Nutzer im EWR gemäß der EU-Richtlinie zur Nutzereinwilligung der Verwendung seiner personenbezogenen Daten für personalisierte Anzeigen zugestimmt hat Dieses Feld wird nur ausgefüllt, wenn „RegsExt.gdpr“ wahr ist.
consent	Nein	String	BidRequest.AdSlot.ConsentedProvidersSettings.tcf_consent_strings	Der websichere, mit base64 codierte IAB Transparency and Consent Framework (TCF) v2-Consent-String, der von der IAB Consent Management Platform (CMP) des Publishers abgerufen wird. Die Struktur des Strings wird durch Version 2 des IAB TCF definiert. Dieses Feld wird ausgefüllt, wenn der Publisher eine CMP für TCF 2 eingebunden hat und diese angibt, dass die DSGVO auf diese Anzeigenanfrage anwendbar ist, und einen gültigen Einwilligungsstring enthält. Weitere Informationen zur Einbindung von Google TCF 2 finden Sie in diesem Artikel. In der Global Vendor List von IAB unter vendor-list.consensu.org/v2/vendor-list.json finden Sie Informationen zu den Anbietern, die im String für die Einwilligung aufgeführt sind.
eids	Nein	Array mit ExtendedId-Objekten	BidRequest.AdSlot.secure_signals.	Standarderweiterung, die verwendet wird, um vom Publisher ausgewählte sichere Signale zu übergeben.

ConsentedProviderSettings (Einstellungen für den Anbieteranbieter)

Informationen zu den Anzeigentechnologie-Anbietern, für die der Publisher Google mitgeteilt hat, dass ein Nutzer im EWR gemäß der Richtlinie zur EU-Nutzereinwilligung der Verwendung seiner personenbezogenen Daten für personalisierte Anzeigen zugestimmt hat Dieses Feld wird nur ausgefüllt, wenn „RegsExt.gdpr“ wahr ist.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
consented_providers	Nein	Array von int64	BidRequest.AdSlot.consented_providers	Eine Reihe von IDs, die den Anzeigentechnologie-Anbietern entsprechen, für die der Publisher Google mitgeteilt hat, dass seine Nutzer im EWR eine rechtsgültige Einwilligung für Folgendes gegeben haben: 1) Verwendung von Cookies oder anderen Formen der lokalen Speicherung, falls die Einholung der Einwilligung dafür gesetzlich vorgeschrieben ist, und 2) Erhebung, Weitergabe und Nutzung personenbezogener Daten zur Personalisierung von Anzeigen durch einen Anbieter von Anzeigen gemäß der EU-Nutzereinwilligungsrichtlinie von Google. Wenn ein Publisher Version 2 des IAB Transparency and Consent Framework (TCF) verwendet, um die Nutzereinwilligung zu verwalten, handelt es sich um die Gruppe von ATPs, die über den String für die zusätzliche Einwilligung eingeholt wurden. Weitere Informationen zum Modus für zusätzliche Einwilligung finden Sie in diesem Artikel. Anzeigentechnologie-Anbieter, die über den Einwilligungsstring von TCF 2 eingewilligt haben, werden im Feld „UserExt.consent“ dargestellt. Eine Zuordnung der ATP-ID zum ATP-Namen wird unter provider.csv veröffentlicht.

ExtendedId (Erweiterte ID)

Vom Publisher übergebene sichere Signale

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
source	Nein	String	BidRequest.AdSlot.SecureSignal.source	Die Quelle (Signalanbieter) des Signals.
uids	Nein	Array mit einem ExtendedIdUid-Objekt	–	Das sichere Signal

Verlängerte ID – ID

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
id	Nein	String	BidRequest.AdSlot.SecureSignal.data.	Das sichere Signal

Daten

Für die data- und segment-Objekte können zusätzliche Kontextdaten angegeben werden. Diese Daten können aus mehreren Quellen stammen, ob von der Anzeigenplattform selbst oder von Drittanbietern, wie im Feld id angegeben. In einer Gebotsanfrage können Datenobjekte von mehreren Anbietern kombiniert werden. Die verwendeten Datenanbieter sollten von der Anzeigenplattform a priorisiert werden.

Damit werden erkannte Branchen an den Käufer gesendet. Bei Open Bidding werden damit auch Schlüssel/Wert-Paare vom Publisher an den Käufer gesendet.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Nein	String	Unterstützt	2 2,4 2,5		Plattformspezifische ID für den Datenanbieter
name	Nein	String	Unterstützt	2 2,4 2,5		Plattformspezifischer Name für den Datenanbieter.
segment		Array mit Segment-Objekten	Unterstützt	2 2,4 2,5		Array mit Segment-Objekten, die die tatsächlichen Datenwerte enthalten.

Segment

Für die data- und segment-Objekte können zusätzliche Kontextdaten angegeben werden. Diese Daten können aus mehreren Quellen stammen, ob von der Anzeigenplattform selbst oder von Drittanbietern, wie im Feld id angegeben. In einer Gebotsanfrage können Data-Objekte von mehreren Anbietern kombiniert werden. Die jeweiligen Datenanbieter sollten von der Anzeigenplattform a Priorität für die Bieter veröffentlicht werden.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Nein	String	Unterstützt	2 2,4 2,5		ID des Datensegments, das für den Datenanbieter spezifisch ist.
name	Nein	String	Unterstützt	2 2,4 2,5		Name des spezifischen Datensegments für den Datenanbieter.
value		String	Unterstützt	2 2,4 2,5		Stringdarstellung des Werts für das Datensegment.

Reg

Dieses Objekt enthält alle rechtlichen, behördlichen oder branchenspezifischen Vorschriften, die für das Ersuchen gelten. Mit der Option coppa wird angegeben, ob die Anfrage unter die Bestimmungen der Federal Trade Commission der USA für das US-Gesetz zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act, COPPA) fällt. Weitere Informationen finden Sie in Abschnitt 7.1.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
coppa	Nein	String	BidRequest.user_data_treatment / TAG_FOR_CHILD_DIRECTED_TREATMENT	2,3 2,4 2,5		Option, die angibt, ob dieser Antrag den COPPA-Bestimmungen der US FTC unterliegt, wobei 0 = nein, 1 = ja.
ext	Nein	RegsExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.regs] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Für OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der Regex-Nachricht.

Regulärer Ausdruck

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
gdpr	Nein	bool	BidRequest.AdSlot.regs_gdpr	Dieses Feld wird in einem der beiden folgenden Fälle auf „true“ gesetzt: Google erhält einen gültigen Transparency & Consent Framework 2-Einwilligungsstring (IAB Transparency and Consent Framework) und die Consent Management Platform gibt an, dass die DSGVO auf diese Anzeigenanfrage angewendet wird. Google erhält keinen IAB-TCF-Einwilligungsstring. Basierend auf den Google zur Verfügung stehenden Informationen wird diese Impression für einen Nutzer im EWR ausgeliefert. Dies ist kein rechtlicher Leitfaden zur DSGVO.
lgpd	Nein	bool	BidRequest.AdSlot.regs_lgpd	Dieses Feld wird auf „true“ gesetzt, wenn die Impression basierend auf den für Google verfügbaren Informationen für einen Nutzer in Brasilien ausgeliefert wird. Unter https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv finden Sie eine Liste der Anzeigentechnologie-Anbieter, die bei Anfragen mit LGPD erzwungen werden dürfen. Weitere Informationen zum LGPD

Variablen und Definitionen für Gebotsantworten

In diesem Abschnitt werden die Variablen und Definitionen für Gebotsantworten beschrieben.

Gebotsantwort

Dieses Objekt ist das Gebotsantwortobjekt der obersten Ebene (z. B. das unbenannte JSON-Objekt). Das Attribut id gibt die Gebotsanfragen-ID zu Logging-Zwecken wieder. Ebenso ist bidid eine optionale Antwort-Tracking-ID für Bieter. Wenn angegeben, kann sie in den nachfolgenden Aufruf zur Gewinnbenachrichtigung aufgenommen werden, wenn der Bieter gewinnt. Mindestens ein seatbid-Objekt ist erforderlich, das mindestens ein Gebot für eine Impression enthält. Andere Attribute sind optional. Damit „kein Gebot“ ausgedrückt wird, geben Sie eine leere Antwort mit HTTP 204 zurück. Wenn der Bieter der Anzeigenplattform auch einen Grund dafür geben möchte, keine Gebote abzugeben, wird nur ein BidResponse-Objekt mit einem Ursachencode im Attribut nbr zurückgegeben.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Ja	String	Keinem Feld zugeordnet, aber mit BidRequest.id abgeglichen.	2,3 2,4 2,5		ID der Gebotsanfrage, auf die diese Antwort zurückgegeben wird Erforderlich gemäß der OpenRTB-Spezifikation.
seatbid	Nein	Array mit Seatbid-Objekten	BidResponse.Ad	2,3 2,4 2,5		Array mit Seatbid-Objekten. Mehr als 1 erforderlich, wenn ein Gebot abgegeben werden soll.
bidid	Nein	String	Gebotsantwort.debug_string	2,3 2,4 2,5		Die vom Bieter generierte Antwort-ID hilft beim Logging/Tracking.
cur	Nein	String	BidResponse.Ad.AdSlot.currency	2,3 2,4 2,5		Verwenden Sie Gebotswährungen gemäß den ISO-4217-Alphacodes. Wenn dieses Feld ausgefüllt ist, wird die angegebene Währung verwendet, um das Gebot zu interpretieren. Andernfalls wird die Standardgebotwährung verwendet, die in der folgenden Priorität bestimmt wird: Die Währung auf Bieterebene, falls in den Einstellungen für Echtzeitgebote konfiguriert. Die Währung auf Käuferebene. Der Käufer wird anhand der Abrechnungs-ID bestimmt, die im Feld BidResponse.seatbid.bid.ext.billing_id der Erweiterung angegeben ist. Andernfalls basiert er auf der einzigen Abrechnungs-ID, die in der Gebotsanfrage gesendet wurde. Die Währung eines Käuferkontos wird bei der Kontoerstellung festgelegt und kann durch einen Technical Account Manager überprüft werden.
customdata	Nein	String	Nicht unterstützt	2,3 2,4 2,5		Optionale Funktion, mit der ein Bieter Daten im Cookie der Anzeigenplattform festlegen kann. Der String muss in base85-Cookie-sicheren Zeichen vorliegen und in einem beliebigen Format vorliegen. Die richtige JSON-Codierung muss mit Anführungszeichen in der Escape-Datei verwendet werden.
nbr	Nein	NoBidReason	Nicht unterstützt	2,3 2,4 2,5		Grund für die fehlende Gebotsabgabe
ext	Nein	BidResponseExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.bid_response] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der BidResponse-Nachricht.

Gebotsantwort für Anzeigen

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
processing_time_ms	Nein	int32	Gebotsantwort.processing_time_ms	Setzen Sie diesen Wert auf die Verarbeitungszeit in Millisekunden vom Eingang der Anfrage bis zur Rückgabe der Antwort.

Sitzplatz

Eine Gebotsantwort kann mehrere SeatBid-Objekte enthalten, die jeweils im Namen einer anderen Bieterposition und jeweils ein oder mehrere einzelne Gebote enthalten. Wenn in der Anfrage mehrere Impressionen enthalten sind, kann über das Gruppenattribut angegeben werden, ob ein Nutzer bereit ist, alle Impressionen zu akzeptieren, die er gewinnen kann (Standard) oder ob er nur gewinnen möchte, wenn er alle als Gruppe gewinnen kann.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
bid	Nein	Array mit Bid-Objekten	BidResponse-Anzeige	2,3 2,4 2,5		Array mit über 1 Bid-Objekt, das jeweils mit einer Impression in Zusammenhang steht Mehrere Gebote können sich auf dieselbe Impression beziehen.
seat	Nein	String	BidResponse.Ad. AdSlot.buyer_reporting_id	2,3 2,4 2,5		ID des Käufersitzes (z. B. Werbetreibender, Agentur), in dessen Namen dieses Gebot abgegeben wird
group	Nein	bool	Nicht unterstützt	2,3 2,4 2,5		0 = Impressionen können einzeln gewonnen werden; 1 = Impressionen müssen als Gruppe gewonnen oder verloren werden. Standard = falsch

Gebot

Ein SeatBid-Objekt enthält ein oder mehrere Bid-Objekte, die jeweils mit einer bestimmten Impression in der Gebotsanfrage über das Attribut impid zusammenhängen und ein Angebot zum Kauf dieser Impression zu einem bestimmten Preis darstellen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Unterstützt		Implementierungsdetails
				in Version	von Google
id	Ja	String	Keinem Feld zugeordnet, aber mit BidRequest.id abgeglichen.	2,3 2,4 2,5		ID der Gebotsanfrage, auf die diese Antwort zurückgegeben wird Erforderlich gemäß der OpenRTB-Spezifikation.
impid	Ja	String	BidResponse.Ad.AdSlot.id	2,3 2,4 2,5		ID des Imp-Objekts in der zugehörigen Gebotsanfrage. Erforderlich gemäß der OpenRTB-Spezifikation.
price	Ja	Doppelwert	BidResponse.Ad.AdSlot.max_cpm_micros * 1.000.000	2,3 2,4 2,5		Der Gebotspreis wird als CPM ausgedrückt, obwohl die tatsächliche Transaktion nur für eine Impressionseinheit pro Einheit gilt. Obwohl der Typ „Gleitkommazahl“ angibt, wird bei der Verarbeitung von Währungen die Berechnung von Ganzzahlen dringend empfohlen (z. B. BigDecimal in Java). von der OpenRTB-Spezifikation erforderlich.
adid	Nein	String	Nicht unterstützt	2,3 2,4 2,5		ID einer vorab geladenen Anzeige, die ausgeliefert wird, wenn das Gebot erfolgreich ist
nurl	Nein	String	Nicht unterstützt	2,3 2,4 2,5		Gewinnbenachrichtigungs-URL, die von der Anzeigenplattform aufgerufen wird, wenn das Gebot erfolgreich ist; optional, um Anzeigen-Markup bereitzustellen. DoubleClick unterstützt keine Gewinnbenachrichtigungen. Verwenden Sie in der Impressions-URL des Snippets %%WINNING_PRICE%% oder ${AUCTION_PRICE}.
adm	Nein	String	BidResponse.Ad.html_snippet, BidResponse.Ad.video_url, BidResponse.Ad.video_vast_xml oder BidResponse.Ad.native_ad	2,3 2,4 2,5		Optionale Methode zur Übermittlung von Anzeigen-Markup für den Fall, dass das Gebot den Zuschlag erhält; wenn die Auszeichnung enthalten ist, wird die Gewinnbenachrichtigung ersetzt. Bei nativen Anzeigengeboten sollte genau eines von {adm, adm_native} verwendet werden. Das ist das OpenRTB-konforme Feld für die JSON-Serialisierung.
adm_native	Nein	Native Antwort	BidResponse.Ad.native_ad	2,3 2,4 2,5		Native Anzeigenantwort. Für native Anzeigengebote sollte genau eines von {adm, adm_native} verwendet werden. Das ist das Feld, das für die Protobuf-Serialisierung verwendet wird.
adomain	Nein	String-Array	Gebotsantwort.Anzeigenklick_through_url	2,3 2,4 2,5		Werbetreibendendomain für die Prüfung der Sperrliste (z. B. „addomain.com“). Dies kann ein Array für die Rotation von Creatives sein. Anzeigenplattformen können festlegen, dass nur eine Domain zulässig ist. In der OpenRTB-Spezifikation sind nur Domainnamen in adomain zulässig. Authorized Buyers unterstützen auch vollständige URLs. Es muss eine gecrawlte Domain oder URL sein. Für native Anzeigen empfehlen wir BidResponse.seatbid[].bid[].adm_native.link.url anstelle von adomain.
bundle	Nein	String	BidResponse.Ad.offersd_app_id	2,3 2,4 2,5		Die Store-ID der App in einem App-Shop, z. B. Apple App Store oder Google Play. Weitere Informationen zu den erwarteten Strings für CTV-App-Shops finden Sie im OTT/CTV Store Assigned App Identification Guidelines. Für mobile Apps im Google Play Store sollten dies Set- oder Paketnamen sein, z. B. com.foo.mygame. Für Apps im Apple App Store sollte dies eine numerische ID sein. Google: Legen Sie zusätzlich zu diesem Feld „bid.ext.app_promotion_type“ fest, um Funktionen speziell für App-Werbetypen zu nutzen.
iurl	Nein	String	Nicht unterstützt	2,3 2,4 2,5		URL ohne Cache-Busting zu einem Bild, das für den Inhalt der Kampagne repräsentativ ist, für die Anzeigenqualität/Sicherheitsprüfung.
cid	Nein	String	BidResponse.Ad.AdSlot.billing_id	2,3 2,4 2,5		Kampagnen-ID zur Unterstützung der Anzeigenqualitätsprüfung; Sammlung von Creatives, für die iurl repräsentativ sein sollte. Stimmt mit der Abrechnungs-ID im Pre-Targeting überein. Wenn die Richtlinie nicht auf die billing_id des Käufers festgelegt ist, wird die Gebotsantwort als ungültig betrachtet. Wenn Creatives gesendet werden, ist ein cid in der Antwort erforderlich, wenn in der Anfrage mehrere billing_id angegeben sind oder wenn der Bieter aktive untergeordnete Nutzerlizenzen hat.
crid	Nein	String	BidResponse.Ad.buyer_creative_id	2,3 2,4 2,5		Creative-ID, die bei der Prüfung der Anzeigenqualität unterstützt wird
cat	Nein	String-Array	BidResponse.Ad.category	2,3 2,4 2,5		IAB-Inhaltskategorien des Creatives.
attr	Nein	Array mit CreativeAttribute-Objekten	BidResponse.Ad.attribute	2,3 2,4 2,5		Attributgruppe zur Beschreibung des Creatives. Kann in OpenRTB als bid.attr (OpenRTB) oder bid.ext.attribute (AdX) deklariert werden.
api	Nein	API-Framework	Bid.api unterstützt die Deklaration der Attribute 1, 2, 3 und 5, die den VPAID- und MRAID-Versionen entsprechen	2,3 2,4 2,5		Vom Markup erforderliche API, falls vorhanden.
protocol	Nein	Protokoll	Nicht unterstützt	2,3 2,4 2,5		Das Videoantwortprotokoll des Markups, falls zutreffend.
qagmediarating	Nein	Qualitätssicherung (QAGMediaRating)	Nicht unterstützt	2,3 2,4 2,5		Altersfreigabe der Creative-Medien gemäß QAG-Richtlinien.
dealid	Nein	String	BidResponse.Ad.AdSlot.deal_id (oder BidResponse.Ad.AdSlot.exchange_deal_id, wenn der Bieter eine Drittanbieter-Anzeigenplattform ist)	2,3 2,4 2,5		Verweisen Sie in der Gebotsanfrage auf die deal.id, wenn sich dieses Gebot auf einen Direct Deal im privaten Marktplatz bezieht.
w	Nein	int32	BidResponse.Ad.width – nur erforderlich, wenn die Impression mehrere Größen hat	2,3 2,4 2,5		Breite des Creatives in geräteunabhängigen Pixeln (DIPS).
h	Nein	int32	BidResponse.Ad.height – nur erforderlich, wenn die Impression mehrere Größen hat	2,3 2,4 2,5		Höhe des Creatives in geräteunabhängigen Pixeln (DIPS).
exp	Nein	int32	Nicht unterstützt	2,4 2,5		Hinweis zur Anzahl der Sekunden, die der Bieter zwischen der Auktion und der tatsächlichen Impression warten möchte.
burl	Nein	String	Impression_tracking_url	4,0		Die URL der Abrechnungsbenachrichtigung, die von der Anzeigenplattform aufgerufen wird, wenn ein erfolgreiches Gebot basierend auf den plattformspezifischen Geschäftsrichtlinien in Rechnung gestellt wird (z. B. in der Regel ausgeliefert, angesehen usw.). Ersetzungsmakros können verwendet werden. Beachten Sie, dass BidExt.impression_tracking_url eine wiederholte Liste von URLs für Abrechnungsbenachrichtigungen akzeptiert. Wenn für Ihren Anwendungsfall mehr als eine Abrechnungs-URL erforderlich ist, verwenden Sie diese Erweiterung anstelle von burl.
lurl	Nein	String	Nicht unterstützt	4,0		Die von der Anzeigenplattform aufgerufene Verlustbenachrichtigungs-URL, wenn ein Gebot verloren gegangen ist. Ersetzungs-Makros können verwendet werden. Eine plattformspezifische Richtlinie kann die Unterstützung für Verlustbenachrichtigungen oder die Offenlegung von Preisklauseln verhindern, was dazu führt, dass Makros in Höhe von ${AUCTION_PRICE} entfernt werden (z. B. durch einen String mit Nulllänge).
tactic	Nein	String	Nicht unterstützt	4,0		Taktische ID, mit der Käufer Gebote für die Taktik der Börse kennzeichnen können, über die ihr Gebot übermittelt wurde Die genaue Nutzung und Bedeutung der Taktik-ID sollte zwischen Käufer und Anzeigenplattformen vorrangig kommuniziert werden.
language	Nein	String	Nicht unterstützt	4,0		Sprache des Creatives mit ISO-639-1-alpha-2 Der nicht standardmäßige Code „xx“ kann auch verwendet werden, wenn das Creative keinen linguistischen Inhalt hat, beispielsweise ein Banner mit einem Unternehmenslogo.
wratio	Nein	int32	Nicht unterstützt	4,0		Relative Breite des Creatives bei Angabe der Größe als Verhältnis. Erforderlich für Flex-Anzeigen.
hratio	Nein	int32	Nicht unterstützt	4,0		Relative Höhe des Creatives, wenn die Größe als Verhältnis ausgedrückt wird. Erforderlich für Flex-Anzeigen.
ext	Nein	BidExt Objekt	Nicht unterstützt	2 2,4 2,5		Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.bid] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Bei OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der Gebotsnachricht.

BidExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
impression_tracking_url	Nein	String-Array	BidResponse.Ad.impression_tracking_url	Die URLs, die beim Rendern der Impression aufgerufen werden sollen. Dies wird für alle Inventartypen und alle Formate unterstützt. In OpenRTB 2.5 ist Bid.burl das analoge Standardfeld.
ad_choices_destination_url	Nein	String	BidResponse.Ad.ad_choices_destination_URL	Link zu einer Anzeigenvorgaben- oder Deaktivierungsseite Falls vorhanden, wird dem nativen Creative ein standardmäßiges Datenschutzinfo-Symbol hinzugefügt und mit dieser URL verknüpft. Dies wird für native Anzeigen unterstützt, ist aber nicht Teil der nativen Nachricht in der Gebotsantwort.
click_tracking_url	Nein	String	BidResponse.Ad.click_tracking_URL	Die URLs, die aufgerufen werden sollen, wenn der Nutzer auf die Anzeige klickt. Diese Option wird derzeit nur für native Anzeigen und programmatisch garantierte Deals mit vom Publisher verwalteten Creatives unterstützt. Im Fall des Publishers werden diese Klick-Tracker an den Bieterserver an den Server gesendet. In allen anderen Fällen werden diese vom Gerät des Nutzers gesendet. Weitere Informationen zu vom Publisher verwalteten Creatives finden Sie unter Vom Publisher verwaltete Creatives.
bidder_name	Nein	String	BidResponse.Ad.Bietername	Bei Authorized Buyers-Bietern (Drittanbieter-Anzeigenplattformen, die Echtzeitgebote über Ad Manager ausführen), gibt der Name des Bieters an, der von der Anzeigenplattform aufgerufen wurde, um die Anzeige bereitzustellen. Dies ist ein beliebiger UTF-8-Text, mit dem sich aber der Bieter identifizieren lässt und der für alle Bieter einheitlich festgelegt wird.
exchange_deal_type	Nein	ExchangeDealType (Aufzählung)	BidResponse.Ad.AdSlot.exchange_deal_type	OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3; default = OPEN_AUCTION
attribute	Nein	Array von int32	Attribut „BidResponse.Ad.	Eine Liste der IDs finden Sie in der Datei buyer-declarable-creative-attributes.txt. Nicht alle deklarierbaren Attribute werden in der BidRequest in den verschiedenen battr-Feldern übermittelt. Viele Bieter geben das Attribut für flexible Anzeigen (auch als „responsive“ oder „größenlos“ bezeichnet) an, die dynamisch angepasst werden, um die gesamte Bildschirmbreite und -höhe einzunehmen. Weitere Informationen finden Sie in der Beschreibung im Leitfaden zu Interstitial-Anzeigen.
amp_ad_url	Nein	String	BidResponse.Ad.amp_ad_url	Die URL zum Abrufen einer AMPHTML-Anzeige. Es sollte nur eines der folgenden Werte festgelegt werden: „html_snippet“, „video_url“, „amp_ad_url“, „native_ad“.
sdk_rendered_ad	Nein	SdkRenderedAd-Objekt	BidResponse.Ad.sdk_rendered_ad	Eine Anzeige, die von einem dem Käufer bekannten SDK gerendert wird. Diese Methode kann nur verwendet werden, wenn die BidRequest eine Untermeldung zu „AppExt.installedSdk“ enthält.
event_notification_token	Nein	EventNotificationToken-Objekt	BidResponse.Ad.event_notification_token	Ein von den Bietern für die Fehlerbehebung festgelegtes Token, das im Echtzeit-Feedback für das Gebot enthalten ist, an das die Anfrage gesendet wird. Der Inhalt des Tokens wird nicht in Logs geschrieben.
restricted_category	Nein	Array von int32	BidResponse.Ad.restricted_category	Alle eingeschränkten Kategorien für die Anzeigen, die über dieses Snippet ausgeliefert werden können. Eine Liste der IDs finden Sie in der Datei ad-restricted-categories.txt.
billing_id	Nein	int64	BidResponse.Ad.AdSlot.Abrechnungs-ID	Die Abrechnungs-ID, der diese Impression zugeordnet werden soll. Der Wert muss im Feld für die wiederholte „BidRequest.Imp.ImpExt.billing_id“ für diese Impression liegen. Wenn die Länge von „BidRequest.Imp.ImpExt.billing_id“ genau 1 ist und der Bieter keine aktiven untergeordneten Lizenzen hat, ist dieses Feld nicht erforderlich und sein Inhalt wird ignoriert.
third_party_buyer_token	Nein	String	BidResponse.Ad.Adslot.Drittanbieter_Käufertoken	Token, das zur Identifizierung von Drittanbieter-Käuferdaten verwendet wird, wenn die Anzeigenplattform als Open Bidding-Vermittler ein Vermittler ist. Diese wird vom Drittanbieterkäufer erfasst und muss unverändert in der Gebotsantwort an Google übergeben werden.
buyer_reporting_id	Nein	String	BidResponse.Ad.Adslot.Käufer_ID	Der Käufer hat eine ID angegeben, die zur Aufschlüsselung der Ausgaben und der Messwerte zu ungültigen Zugriffen in den Berichten zu ungültigen Zugriffen im Abfragetool verwendet wird. IDs mit weniger als 1.000 Impressionen werden nicht zum Aufschlüsseln von Messwerten verwendet. IDs, die länger als 64 Byte sind, werden ignoriert.
skadn	Nein	SKAdNetworkResponse-Objekt	BidResponse.Ad.skadn	SKAdNetwork-Informationen des Werbetreibenden zur Unterstützung der App-Installationszuordnung für iOS 14 und höher. Mit der SKAdNetwork API von Apple können Werbetreibende die Installation werbebasierter Apps messen. Dazu wird nach einer erfolgreichen Installation ein Postback an das Werbenetzwerk gesendet. Werbenetzwerke müssen ihre Netzwerk-ID und die Informationen zum signierten Werbetreibenden senden, damit eine Installation der Anzeigenimpression zugeordnet werden kann. Weitere Informationen finden Sie in diesem Artikel.
app_promotion_type	Nein	enum	BidResponse.Ad.app_promotion_type	Typ der App-Werbung, die der beworbenen App entspricht, die im Feld seatbid.bid.bundle angegeben ist. Wenn die beworbene App nicht angegeben ist, wird dieses Feld ignoriert. Wenn das Feld bundle ohne dieses Feld festgelegt wird, wird es so behandelt, als wäre das Feld auf OTHER gesetzt.
SdkRenderedAd
id	Nein	String	BidResponse.ad[].sdk_rendered_ad.id	Die ID für das SDK, das die Anzeige rendert. Muss mit einem BidRequest.app.ext.installed_sdk.id übereinstimmen, der in der entsprechenden Gebotsanfrage gesendet wurde.
rendering_data	Nein	String	BidResponse.ad[].sdk_rendered_ad.rendering_data	Daten, die an das SDK übergeben werden müssen, um die Anzeige zu rendern. Diese Daten sind für den Publisher und Google undurchsichtig.
declared_ad	Nein	Delcared-Anzeige	BidResponse.ad[].sdk_rendered_ad.declared_ad	Deklarierte Anzeigen-Assets zur Unterstützung des Creative-Scans, der Klassifizierung und der Durchsetzung von Werberichtlinien und Publisher-Blockierungen für Anzeigen, die mit einem benutzerdefinierten SDK gerendert werden. Legen Sie nur html_snippet, video_url, video_vast_xml oder native_response fest.
Ereignisbenachrichtigungs-Token
payload	Nein	String	BidResponse.ad[].event_notification_token	Der Inhalt des Tokens, der ignoriert wird, wenn er länger als 128 Byte ist.
SKAdNetworkResponse
version	Nein	String	BidResponse.ad[].skadn.version	Version des SKAdNetwork, die vom Werbetreibenden unterstützt wird. Außerdem wird angegeben, wie die Signatur vom Werbetreibenden generiert wurde. Dies sollte mit einer der Versionen aus BidRequest.imp.ext.skad.versions übereinstimmen.
network	Nein	String	BidResponse.ad[].skadn.network	Die ID des Werbenetzwerks, die in der Signatur verwendet wird. Dies sollte mit einem der Elemente in BidRequest.imp.ext.skad.skadnetids übereinstimmen.
campaign	Nein	String	BidResponse.ad[].skadn.campaign	Die Kampagnen-ID ist mit den Spezifikationen von Apple kompatibel. Wird in SKAdNetwork 3.0 und niedriger verwendet. Ersetzt durch das Feld BidResponse.imp.ext.skad.sourceidentifier in SKAdNetwork 4.0 und höher.
sourceidentifier	Nein	String	BidResponse.ad[].skadn.source_identifier	Eine vierstellige Ganzzahl, die von Werbenetzwerken für die Anzeigenkampagne definiert wird. Wird in SKAdNetwork 4.0 oder höher verwendet und ersetzt das Feld BidResponse.imp.ext.skad.campaign.
itunesitem	Nein	String	BidResponse.ad[].skadn.itunesitem	ID der App des Werbetreibenden im App-Shop von Apple.
productpageid	Nein	String	BidResponse.ad[].skadn.product_page_id	ID der benutzerdefinierten Produktseite, die angezeigt werden soll (iOS 15 oder höher). Wenn keine Angabe erfolgt, wird die Standardproduktseite angezeigt. Weitere Informationen zu benutzerdefinierten Produktseiten
fidelities	Nein	Array mit Fidelity-Objekten	BidResponse.ad[].skadn.fidelities	Die SKAdNetwork API ab Version 2.2 unterstützt mehrere Optionen für die Anzeigenpräsentation, die durch den Parameter fidelity-type der SKAdNetwork-Signatur angegeben werden. Diese enthält Parameter, die zum Generieren der Signatur verwendet werden, die sich für jeden unterstützten Fidelity-Typ unterscheiden. Weitere Informationen finden Sie in diesem Artikel.
nonce	Nein	String	BidResponse.ad[].skadn.nonce	Eine eindeutige UUID in Kleinbuchstaben, die vom Werbetreibenden zum Generieren der Signatur generiert wird. Hinweis: Dieses Feld wird zugunsten des Felds BidResponse.bid.ext.skadn.fidelities.nonce verworfen, um mehrere Fidelity-Typen zu unterstützen.
sourceapp	Nein	String	BidResponse.ad[].skadn.sourceapp	ID der App des Publishers im App Store von Apple. Sie sollte mit der ID aus „BidRequest.imp.ext.skad.sourceapp“ übereinstimmen.
timestamp	Nein	String	BidResponse.ad[].skadn.timestamp	Die Unix-Zeit in Millisekunden wird zum Zeitpunkt der Signaturgenerierung verwendet. Hinweis: Dieses Feld wird zugunsten des Felds BidResponse.bid.ext.skadn.fidelities.timestamp verworfen, um mehrere Fidelity-Typen zu unterstützen.
signature	Nein	String	BidResponse.ad[].skadn.signature	SKAdNetwork-Signatur wie von Apple angegeben. Hinweis: Dieses Feld wird zugunsten des Felds BidResponse.bid.ext.skadn.fidelities.signature verworfen, um mehrere Fidelity-Typen zu unterstützen.
skoverlay	Nein	SKOverlay-Objekt	BidResponse.ad[].skadn.skoverlay	Mit diesen Optionen wird angegeben, wie SKOverlay in der beworbenen App empfohlen wird. Wird unter iOS 14 und höher unterstützt.

DeclaredAd-Objekt

Deklarierte Anzeigen-Assets zur Unterstützung des Creative-Scans, der Klassifizierung und der Durchsetzung von Werberichtlinien und Publisher-Blockierungen für Anzeigen, die mit einem benutzerdefinierten SDK gerendert werden.

Legen Sie nur html_snippet, video_url, video_vast_xml oder native_response fest.

Mutter/Vater

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
html_snippet	Nein	String	BidResponse.ad[].sdk_rendered_ad.declared_ad.html_snippet	Das HTML-Snippet, das die vom SDK gerenderte Anzeige repräsentiert.
video_url	Nein	String	BidResponse.ad[].sdk_rendered_ad.declared_ad.video_url	Das ist die URL des VAST-Assets, das in der vom SDK gerenderten Anzeige verwendet wird.
video_vast_xml	Nein	String	BidResponse.ad[].sdk_rendered_ad.declared_ad.video_vast_xml	Das VAST-Dokument, das zum Rendern der benutzerdefinierten, mit SDK gerenderten Anzeige verwendet wird. Dieses Dokument muss dem VAST 2.0- oder VAST 3.0-Standard entsprechen.
native_response	Nein	NativeResponse	BidResponse.ad[].sdk_rendered_ad.declared_ad.native_response	Der Content einer nativen Anzeige Native Anzeigen bestehen aus mehreren Bausteinen, die vom Käufer-SDK gerendert werden. Muss mit der standardmäßigen NativeResponse-Definition von OpenRTB Native 1.2 übereinstimmen. NativeResponse.assets.img.type ist erforderlich.
click_through_url	Nein	String	BidResponse.ad[].sdk_rendered_ad.declared_ad.click_through_url	Die endgültigen Landingpages der vom SDK gerenderten Anzeige.

Zuverlässigkeit

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
fidelity	Nein	Aufzählung „SKAdNetworkFidelityType“	BidResponse.ad[].skadn.fidelity_type	Der Zuverlässigkeitstyp der Attribution, die verfolgt werden soll. Standardwert = STOREKIT_RENDERED_ADS VIEW_THROUGH_ADS = 0; Attribution für App-Installationen innerhalb von 24 Stunden nach Ansehen einer Anzeige für mindestens 3 Sekunden. Wird ab SKAdNetwork-Version 2.2 unterstützt Weitere Informationen finden Sie in diesem Artikel. STOREKIT_RENDERED_ADS = 1; Attribution für App-Installationen, die von der über StoreKit gerenderten App Store-Produktseite initiiert wurden, die auf Anzeigenklicks zurückzuführen ist. Wird für alle SKAdNetwork-Versionen unterstützt. Weitere Informationen finden Sie in diesem Artikel.
nonce	Nein	String	BidResponse.ad[].skadn.nonce	Eine eindeutige UUID in Kleinbuchstaben, die vom Werbetreibenden zum Generieren der Signatur generiert wird.
timestamp	Nein	String	BidResponse.ad[].skadn.timestamp	Die Unix-Zeit in Millisekunden wird zum Zeitpunkt der Signaturgenerierung verwendet.
signature	Nein	String	BidResponse.ad[].skadn.signature	SKAdNetwork-Signatur wie von Apple angegeben.

SKOverlay

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
delay	Nein	int32	BidResponse.ad[].skadn.skoverlay.delay_seconds	Verzögerung in Sekunden nach Anzeigenstart, bevor das Overlay eingeblendet wird. Wenn das Feld auf 0 gesetzt ist, wird das Overlay sofort nach Beginn der Anzeige eingeblendet. Wenn dieses Feld nicht festgelegt ist, wird das Overlay nicht für die Anzeige angezeigt.
endcarddelay	Nein	int32	BidResponse.ad[].skadn.skoverlay.endcard_delay_seconds	Verzögerung in Sekunden, nachdem das Endbild angezeigt wurde, bevor das Overlay angezeigt wird. Dieses Feld gilt nur für Creatives mit Prämie oder Interstitial-Video-Creatives. Wenn dieses Feld auf 0 gesetzt ist, wird das Overlay sofort nach der Darstellung des Endbilds angezeigt. Wenn dieses Feld nicht festgelegt ist, wird das Overlay für das Endbild nicht angezeigt. Wenn sowohl delay als auch endcarddelay festgelegt ist, wird das Overlay automatisch geschlossen, wenn die Anzeige endet, und nach der Wiedergabe des Endbildes noch einmal angezeigt.
dismissible	Nein	bool	BidResponse.ad[].skadn.skoverlay.dismissible	Gibt an, ob das Overlay vom Nutzer geschlossen werden kann. Der Standardwert ist „true“.

Native Gebotsvariablen, Definitionen und Erweiterungen

Native Anfrage

Das Native-Objekt definiert die native Werbemöglichkeit, die für Gebote über diese Gebotsanfrage zur Verfügung steht. Sie muss direkt in das Impressionsobjekt eingefügt werden, wenn die für die Auktion angebotene Impression ein natives Anzeigenformat ist.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
ver	Ja	String	„1.2“ für OpenRTB 2.5.	Nummer der verwendeten Version des nativen Markups.
layout	Nein	Layout-ID	Nicht unterstützt	Die Layout-ID des nativen Anzeigenblocks. EMPFOHLEN durch OpenRTB Native 1.0; optional in 1.1, wird eingestellt.
adunit	Nein	Anzeigenblock-ID	Nicht unterstützt	Die Anzeigenblock-ID des nativen Anzeigenblocks. Das entspricht einem der nativen Core-6-Anzeigenblöcke des IAB. EMPFOHLEN durch OpenRTB Native 1.0; optional in 1.1, wird eingestellt.
context	Nein	ContextType"	Nicht unterstützt	Der Kontext, in dem die Anzeige erscheint.
contextsubtype	Nein	Kontextuntertyp	Nicht unterstützt	Detaillierter Kontext, in dem die Anzeige erscheint.
plcmttype	Nein	Placement-Typ	NativeAdTemplate.native_Placement-Typ	Das Design/Format/Layout des angebotenen Anzeigenblocks.
plcmtcnt	Nein	int32	Nicht unterstützt	Die Anzahl der identischen Placements in diesem Layout.
seq	Nein	int32	Nicht unterstützt	0 für die erste Anzeige, 1 für die zweite Anzeige usw. In der Regel sollte dies NICHT in Kombination mit plcmtcnt verwendet werden – Sie verkaufen entweder mehrere identische Placements (in diesem Fall plcmtcnt>1, seq=0) oder Sie führen separate Auktionen für verschiedene Elemente im Feed ab (in diesem Fall plcmtcnt=1, seq>=1).
assets	Nein	Array mit Asset-Objekten	Wird in NativeAdTemplate-Objekt unterstützt. Das Feld „OpenRTB-Assets“ ist dem AdX-Protokollfeld native_ad_template zugeordnet. Es handelt sich nicht um eine 1:1-Zuordnung. Über das Google AdX-Protokoll wird dieselbe Nachricht über das Objekt NativeAdTemplate übertragen, wobei die Felder required_fields und recommended_fields dem Bieter mitteilen, welche Assets erforderlich oder empfohlen sind. NativeAdTemplate enthält auch andere Felder wie image_width. Die Informationen im Feld assets in OpenRTB werden in mehreren Feldern in AdX ausgedrückt.	Jedes Gebot muss dem Array der von der Anzeigenplattform ausgedrückten Elemente entsprechen. Erforderlich gemäß der Native-Spezifikation von OpenRTB: mindestens ein Element
aurlsupport	Nein	bool	Unterstützt.	Gibt an, ob die Quellquelle / Impression die Rückgabe einer Asset-URL anstelle eines Asset-Objekts unterstützt. 0 oder deren Fehlen bedeutet, dass eine solche Unterstützung nicht vorhanden ist. In Version 1.2 implementiert
durlsupport	Nein	bool	Unterstützt.	Gibt an, ob die Bereitstellungsquelle/-impression die Rückgabe einer DCO-URL anstelle eines Asset-Objekts unterstützt. 0 oder deren Fehlen bedeutet, dass eine solche Unterstützung nicht vorhanden ist. Umsetzung in 1.2. Betafunktion.
eventtrackers	Nein	EventTrackers	OpenRTB-Version 1.2 unterstützt das Tracking für IMPRESSION und IMG. Wenn OMSDK für native Anzeigen aktiviert ist, wird JS unterstützt	Gibt an, welche Art von Ereignis-Tracking unterstützt wird. In Version 1.2 implementiert
privacy	Nein	bool	Nicht unterstützt	Wird auf „1“ gesetzt, wenn die native Anzeige käuferspezifische Datenschutzhinweise unterstützt. Wird auf 0 gesetzt (oder das Feld fehlt), wenn die native Anzeige keine benutzerdefinierten Datenschutzlinks unterstützt oder die Unterstützung unbekannt ist. EMPFOHLEN und in 1.2 implementiert. Alle von uns gesendeten nativen Anfragen unterstützen eine Datenschutz-URL. Diese ist also bei nativen Anfragen implizit immer „1“.
ext	Nein	NativeRequestExt Objekt	Unterstützt	Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.native_ext] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Für OpenRTB/JSON erfolgt der Zugriff über das Feld ext in der NativeRequest-Nachricht.

Native AnfrageExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
style_id	Nein	int32	BidRequest.AdSlot. Native_ad_template[0].style_id	Global eindeutige ID für den spezifischen Stil, HTML- und CSS-Code, mit dem die native Anzeige gerendert wird.
style_height	Nein	int32	BidRequest.AdSlot. Native_ad_template[0] .style_height	Ist für style_layout_type der Wert Pixel festgelegt, ist dies die Höhe der gesamten nativen Anzeige nach dem Rendering.
style_width	Nein	int32	BidRequest.AdSlot. Native_ad_template[0] .style_width	Wenn für style_layout_type der Wert Pixel gilt, entspricht dies der Breite der gesamten nativen Anzeige nach dem Rendering.
style_layout_type	Nein	LayoutType (Aufzählung)	BidRequest.AdSlot. Native_ad_template[0] .style_layout_type	Layouttyp „Aufzählung“: PIXEL = 0; (Standard) FLUID = 1;

Asset

Das Hauptcontainerobjekt für jedes Asset, das von Exchange im Namen des Renderingclients angefordert oder unterstützt wird. Alle erforderlichen Objekte müssen als solche gekennzeichnet sein. In jedem Objekt sollte nur eines der {title,img,video,data}-Objekte enthalten sein. Alle anderen sollten null/nicht vorhanden sein. Die id muss innerhalb des Asset-Arrays eindeutig sein, damit die Antwort ausgerichtet werden kann.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
id	Ja	int32	1..N für N-Assets in nicht angegebener Reihenfolge, entsprechend den empfohlenen oder Pflichtfeldern im ersten NativeAdTemplate	Eindeutige Asset-ID, die von der Anzeigenplattform zugewiesen wird. In der Regel ein Zähler für das Array. Erforderlich gemäß der Native-Spezifikation von OpenRTB.
required	Nein	bool	BidRequest.AdSlot.native_ad_template[0]. erforderliche_Felder	Wird auf „true“ gesetzt, wenn ein Asset erforderlich ist.
title	Nein	Titel der Anfrage	BidRequest.AdSlot.native_ad_template[0] vom Typ HEADLINE	Title-Objekt für Titel-Assets. EMPFOHLEN durch die OpenRTB Native-Spezifikation. Entweder Title, Image, Data oder Video.
img	Nein	Bild anfordern	BidRequest.AdSlot.native_ad_template[0] der Typen MAIN/IMAGE, ICON/APP_ICON, LOGO/LOGO	Image-Objekt für Bild-Assets. EMPFOHLEN durch die OpenRTB Native-Spezifikation. Entweder Title, Image, Data oder Video.
video	Nein	Video	BidRequest.AdSlot.NativeAdTemplate.required_fields	Video-Objekt für Video-Assets. In-Stream-Videoanzeigen sind nicht native Anzeigen. Native Anzeigen können ein Video als Creative enthalten. Bei Gebotsanfragen kann angegeben werden, dass das Video in der NativeResponse erforderlich ist. Dazu wird NativeRequest.assets[].required auf true gesetzt und NativeRequest.assets[].video festgelegt. EMPFOHLEN durch die OpenRTB Native-Spezifikation. Entweder Title, Image, Data oder Video.
data	Nein	Daten	BidRequest.AdSlot.native_ad_template[0] der Typen CTATEXT/CALL_TO_ACTION, FROM/BODY, SPONSORED/ADVERTISER, PREIS/PREIS, RATING/STAR_RATING	Data-Objekt für Bewertungen, Preise usw. EMPFOHLEN durch die OpenRTB Native-Spezifikation. Entweder Title, Image, Data oder Video.

Titel

Das Objekt Title wird für das Titelelement der nativen Anzeige verwendet.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
len	Nein	int32	BidRequest.AdSlot.native_ad_template[0].headline_max_safe_length	Maximale Textlänge im Titelelement. EMPFOHLEN, dass der Wert entweder 25, 90, 140 ist. Erforderlich gemäß der Native-Spezifikation von OpenRTB.

Bild

Das Objekt Image wird für Bildelemente der nativen Anzeige verwendet.

Nicht unterstützt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
type	Nein	Bild-Asset-Typ	Feldtyp „BidRequest.AdSlot.native_ad_template[0]“	Typ-ID des vom Publisher unterstützten Bildelements Der Verlag oder Webpublisher kann diese Informationen in einem geeigneten Format anzeigen.
w	Nein	int32	Nicht unterstützt	Breite des Bilds in Pixeln
h	Nein	int32	Nicht unterstützt	Höhe des Bildes in Pixeln
wmin	Nein	int32	BidRequest.AdSlot.native_ad_template[0] vom Typ: MAIN/IMAGE:image_width LOGO/LOGO: logo_width ICON/APP_ICON: app_icon_width	Die minimale angeforderte Bildbreite in Pixeln Diese Option sollte für das erneute Skalieren von Bildern durch den Client verwendet werden. Es sollte entweder w oder wmin übertragen werden. Wenn nur w enthalten ist, sollte dies als genaue Anforderung betrachtet werden. EMPFOHLEN durch die OpenRTB Native-Spezifikation.
hmin	Nein	int32	BidRequest.AdSlot.native_ad_template[0] vom Typ: MAIN/IMAGE:image_height LOGO/LOGO: logo_height ICON/APP_ICON: app_icon_height	Die minimale angeforderte Höhe des Bilds in Pixeln. Diese Option sollte für das erneute Skalieren von Bildern durch den Client verwendet werden. Es sollte entweder h oder hmin übertragen werden. Wenn nur h enthalten ist, sollte dies als genaue Anforderung betrachtet werden. EMPFOHLEN durch die OpenRTB Native-Spezifikation.
mimes	Nein	String		Zulassungsliste mit unterstützten MIME-Typen für Inhalte. Zu den beliebten MIME-Typen gehören unter anderem „image/jpg“ und „image/gif“. Jede Implementierung von Exchange sollte eine eigene Liste der unterstützten Typen in den Integrationsdokumenten haben. Weitere Informationen und Links zu allen IETF-RFCs findest du auf der MIME-Seite von Wikipedia. Wenn das Feld leer ist, nehmen Sie an, dass alle Typen zulässig sind.

Video

Das Objekt Video wird für Videoelemente der nativen Anzeige verwendet.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
mimes	Ja	String-Array	BidRequest.Video.allowed_video_formats	Unterstützte Content-MIME-Typen. Zu den beliebten MIME-Typen gehören unter anderem „video/x-mswmv“ für Windows Media und „video/x-flv“ für Flash-Videos oder „video/mp4“. Hinweis: Native Anzeigen unterstützen häufig kein Flash. Erforderlich gemäß der Native-Spezifikation von OpenRTB: mindestens ein Element
minduration	Ja	int32	BidRequest.Video.min_ad_Dauer	Mindestdauer der Videoanzeige in Sekunden. Erforderlich gemäß der Native-Spezifikation von OpenRTB.
maxduration	Ja	int32	BidRequest.Video.max_ad_duration	Maximale Dauer der Videoanzeige in Sekunden. Erforderlich gemäß der Native-Spezifikation von OpenRTB.
protocols	Ja	Array mit Protocol Enum	BidRequest.Video.Protokolle	Ein Array mit Videoprotokollen, die der Publisher in der Gebotsantwort akzeptieren kann. Erforderlich gemäß der Native-Spezifikation von OpenRTB: mindestens ein Element Beispiele: VAST_1_0 = 1; VAST_2_0 = 2; VAST_3_0 = 3;

Daten

Das Data-Objekt sollte für alle Elemente verwendet werden, die keine Kernelemente der nativen Einheit sind, z. B. Bewertungen, Anzahl der Sterne, Anzahl der Sterne, Anzahl der Downloads oder Beschreibungen. Es gilt auch für die Zukunft von nativen Elementen, die zum Zeitpunkt der Erstellung dieses Dokuments nicht vorgesehen waren.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
type	Ja	Daten-Asset-Typ	Feldtyp „BidRequest.AdSlot.native_ad_template[0]“	Die ID des Elements, die vom Publisher unterstützt wird Der Verlag oder Webpublisher kann diese Informationen in einem geeigneten Format anzeigen. Erforderlich gemäß der Native-Spezifikation von OpenRTB.
len	Nein	int32	BidRequest.AdSlot.native_ad_template[0] vom Typ: DEFANG/TEXT: body_max_safe_length CTATEXT/CALL_TO_ACTION: call_to_action_max_safe_length SPONSORED/ADVERTISER: Advertisers_max_safe_length PREIS/PREIS: price_max_safe_length	Maximale Textlänge in der Antwort des Elements. Hinweis: nicht für RATING/STAR_RATING verwendet. AdX erfordert ein doppeltes 0–5-Zeichen.

Event-Tracker

Das EventTrackers-Objekt gibt die Art der Ereignisse an, die der Bieter anfordern kann, damit es in der Gebotsantwort erfasst wird. Außerdem ist angegeben, welche Arten von Tracking für die einzelnen Ereignistypen verfügbar sind, und als Array in die Anfrage aufgenommen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
event	Ja	EventType	Nicht unterstützt	Ereignistyp, der für das Tracking verfügbar ist. Erforderlich gemäß der Native-Spezifikation von OpenRTB.
methods	Ja	Tracking-Methode	Nicht unterstützt	Array von Tracking-Typen, die für das jeweilige Ereignis verfügbar sind. Erforderlich gemäß der Native-Spezifikation von OpenRTB.

Native Antwort

Das native Antwortobjekt ist das JSON-Objekt der obersten Ebene, das eine native Antwort identifiziert.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
ver	Nein	String	„1.0“ für OpenRTB 2.3; „1.1“ für OpenRTB 2.4	Version der verwendeten nativen Markup-Version.
assets	Nein	Asset-Array	BidResponse.Ad.native_ad[0] Alle Assets werden Feldern einer einzelnen NativeAd zugeordnet.	Liste der Assets einer nativen Anzeige.
link	Ja	Link	BidResponse.Ad.native_ad[0]	Ziellink.Erforderlich gemäß der OpenRTB-Spezifikation für native Anzeigen.
imptrackers	Nein	String-Array	BidResponse.Ad.impression_tracking_url	Array mit Impressions-Tracking-URLs, das ein 1 × 1-Bild oder eine 204-Antwort zurückgeben soll – normalerweise nur dann, wenn Tracker von Drittanbietern verwendet werden Verwenden Sie das Makro %%WINNING_PRICE%% oder ${AUCTION_PRICE}.
jstracker	Nein	String	Nicht unterstützt	Optionaler JavaScript-Impressions-Tracker Enthält script-Tags, die zum Zeitpunkt der Impression ausgeführt werden sollen, sofern es unterstützt wird.
eventtrackers	Nein	Array mit EventTracker-Objekten	BidResponse.Ad.impression_tracking_url und BidResponse.Ad.impression_tracking_resource	Array von Trackern für Antwortereignisse, die mit der Anzeige ausgeführt werden, als Reaktion auf die deklarierten unterstützten Methoden in der NativeRequest. Ersetzt Imptracker und jstracker. Umsetzung in 1.2.

Event-Tracker

Die Ereignis-Tracker-Antwort ist ein Array von Objekten und gibt die Ereignistypen an, die der Bieter erfassen möchte, sowie die URLs/Informationen, anhand derer diese erfasst werden sollen. Die Gebotsfunktion darf nur mit den in der Anfrage angegebenen Methoden antworten. Die meisten JavaScript-Tracker erwarten zum Zeitpunkt der Impression, daher wird es im Allgemeinen nicht empfohlen, dass der Käufer mit JavaScript-Trackern bei anderen Ereignissen antwortet. Dies ist jedoch für jeden Käufer angemessen.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
event	Ja	Ganzzahl	Nicht unterstützt	Die Art des zu erfassenden Ereignisses.
method	Ja	Ganzzahl	Nicht unterstützt	Die Art des Trackings wird angefordert.
url	Nein	Text	BidResponse.Ad.impression_tracking_url und BidResponse.Ad.ImpressionTrackingResource.script_url	Die URL des Bildes oder JS. Erforderlich für Image oder JS, optional für benutzerdefiniert.
customdata	Nein	Objekt mit Schlüssel/Wert-Paaren.	Nicht unterstützt	Wird einzeln mit der Anzeigenplattform vereinbart, einer Reihe von Key:value-Objekten für benutzerdefiniertes Tracking, z. B. die Kontonummer der DSP bei einem Tracking-Unternehmen, z. B. {"accountnumber":"123"}.
ext	Nein	EventTrackerExt Objekt	Nicht unterstützt	Bei OpenRTB/Protobuf können Sie mit dem Erweiterungsschlüssel [com.google.doubleclick.eventtrackers] auf dieses Objekt zugreifen (der genaue Pfad variiert je nach Sprache, die zum Generieren der Proto-Bibliothek verwendet wurde). Für OpenRTB/JSON erfolgt der Zugriff auf das Feld ext in der EventTracker-Nachricht.

EventTrackerExt

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
context	Nein	Array von Enum-Kontext	BidResponse.Ad.ImpressionTrackingResource.Kontext	Zusätzlicher Kontext für das Rendering angegeben UNKNOWN = 0; OMID = 1; wird derzeit nicht unterstützt
verification_parameters	Nein	String	BidResponse.Ad.ImpressionTrackingResource.verification_parameters	Parameter, die der Ressource zugeordnet sind, die beim Laden an die Ressource übergeben wird. Das Format der Parameter hängt vom Skriptanbieter ab.
vendor_key	Nein	String	BidResponse.Ad.ImpressionTrackingResource.vendor_key	Wird verwendet, um den Anbieter des Überprüfungsskripts eindeutig zu identifizieren.

Link

Wird für Assets mit Call-to-Action oder anderen Links aus der nativen Anzeige verwendet Dieses Objekt sollte mit seinem Peer-Objekt im übergeordneten Objekt Asset verknüpft sein. Wenn das Peer-Objekt aktiviert (angeklickt) wird, sollte die Aktion den Nutzer zum Ort des Links leiten.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
url	Nein	String	BidResponse.ad[].native_ad.click_link_url	Landingpage-URL des anklickbaren Links
clicktrackers	Nein	String-Array	(NativeResponse.link) BidResponse.Ad.NativeAd.click_tracking_url[0]	Drittanbieter-Tracker-URLs, die beim Klicken auf die URL ausgelöst werden Die Klick-Tracker von Google leiten HTTP 30x an den Tracker des Bieters weiter. Es sind mehrere Klick-Tracker zulässig.
fallback	Nein	String	Nicht unterstützt	Fallback-URL für Deeplink. Wird verwendet, wenn die in url angegebene URL vom Gerät nicht unterstützt wird.

Asset

Entspricht dem Objekt Asset in der Anfrage. Das Hauptcontainerobjekt für jedes Asset, das von Exchange im Namen des Renderingclients angefordert oder unterstützt wird. Alle erforderlichen Objekte müssen entsprechend gekennzeichnet sein. In jedem Objekt sollte nur eines der {title,img,video,data}-Objekte vorhanden sein. Alle anderen sollten null/nicht vorhanden sein. Die ID sollte innerhalb des Asset-Arrays eindeutig sein, damit die Antwort ausgerichtet werden kann.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
id	Ja	int32	Nicht unterstützt	Die eindeutige Asset-ID, die von der Anzeigenplattform zugewiesen wird, muss mit einer der Asset-IDs in der Anfrage übereinstimmen Erforderlich gemäß der Native-Spezifikation von OpenRTB.
required	Nein	bool	Nicht unterstützt	Legen Sie 1 fest, wenn das Asset erforderlich ist. (der Bieter erfordert, dass er angezeigt wird)
title	Nein	Titel	AdX: BidResponse.Ad.native_ad[0] / ÜBERSCHRIFT	Title, Image, Data oder Video Titelobjekt für Titel-Assets
img	Nein	Bild	BidResponse.Ad.native_ad[0] / BILD|LOGO|APP_ICON	Title, Image, Data oder Video Image-Objekt für Bild-Assets.
video	Nein	Video	BidResponse.Ad.NativeAd.video_url oder BidResponse.Ad.NativeAd.video_vast_xml	Dies kann entweder ein String mit VAST-XML oder eine URL zu einem VAST-Dokument über das Attribut NativeResponse.assets[].video.vasttag sein. Video-Objekt für Video-Assets. In-Stream-Videoanzeigen sind nicht native Anzeigen. Native Anzeigen können ein Video als Creative enthalten.
data	Nein	Daten	BidResponse.Ad.native_ad[0] / BODY|CALL_TO_ACTION|ADVERTISER|STAR_RATING_PRICE_STORE	Entweder Title, Image, Data oder Video. Data-Objekt für Bewertungen, Preise usw.
link	Nein	Link	BidResponse.Ad.native_ad[0]	Linkobjekt für Calls-to-Action. Dieser Link ist mit dem anderen ausgefüllten Feld innerhalb des Objekts verknüpft.

Titel

Entspricht dem Objekt Title in der Anfrage, wobei der Wert ausgefüllt ist.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
text	Ja	String	BidResponse.Ad.native_ad[0].headline	Der mit dem Textelement verknüpfte Text. Erforderlich gemäß der Spezifikation für OpenRTB Native.

Bild

Entspricht dem Objekt Image in der Anfrage. Das Image-Objekt, das für alle Bildelemente der nativen Anzeige verwendet werden soll, z. B. Symbole oder Hauptbild

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
url	Ja	String	BidResponse.Ad.native_ad[0] für Asset-Typ "Anfrage": HAUPTBILD: Image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: Logo.url	URL des Bild-Assets. Erforderlich gemäß der Native-Spezifikation von OpenRTB.
w	Nein	int32	BidResponse.Ad.native_ad[0] für Asset-Typ "Anfrage": HAUPTBILD: Image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: Logo.url	Breite des Bilds in Pixeln EMPFOHLEN durch die OpenRTB-Native-Spezifikation.
h	Nein	int32	BidResponse.Ad.native_ad[0] für Asset-Typ "Anfrage": HAUPTBILD: Image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: Logo.url	Höhe des Bildes in Pixeln

Video

Entspricht dem Objekt Video in der Anfrage, enthält jedoch einen Wert eines übereinstimmenden VAST-Tags als Wert.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
vasttag	Ja	String	Nicht unterstützt	VAST-XML. Erforderlich gemäß der Native-Spezifikation von OpenRTB.

Daten

Entspricht dem Objekt Data in der Anfrage, wobei der Wert ausgefüllt ist. Das Data-Objekt sollte für alle sonstigen Elemente der nativen Einheit verwendet werden, z. B. für Bewertungen, Anzahl der Sterne, Sterne, Downloads oder die Anzahl der Preise. Es ist auch allgemein für zukünftige native Elemente vorgesehen, die zum Zeitpunkt der Erstellung dieses Dokuments nicht in Betracht gezogen wurden.

Attribut	Immer bestanden	Typ	Authorized Buyers-Entsprechung	Implementierungsdetails
label	Nein	String	Nicht unterstützt	Der optionale formatierte Stringname des anzuzeigenden Datentyps.
value	Ja	String	BidResponse.Ad.native_ad[0] für Asset-Typ „OpenRTB/AdX“ von Anfragen: CTATEXT/CALL_TO_ACTION: Call_to_action UNTERSCHRIFT/KÖRPER: Text SPONSORED/ADVERTISER: Werbetreibender PREIS/PREIS: Preis RATING/STAR_RATING: star_rating (AdX erfordert ein doppeltes 0–5-Zeichen)	Der formatierte String der anzuzeigenden Daten. Kann einen formatierten Wert wie „5 Sterne“, „10 €“ oder „3,4 von 5 Sternen“ enthalten. Erforderlich gemäß der Native-Spezifikation von OpenRTB.

Beispiele

• Beispiel für Gebotsanfragen
• Beispiel für Gebotsantworten