Protokoll für Echtzeitgebote in Authorized Buyers

In diesem Leitfaden werden die einzelnen Felder des Protokolls „Real-Time Bidding“ in Authorized Buyers (Version 288) sowie zusätzliche Tipps und Informationen zur Implementierung beschrieben.

Weitere Informationen finden Sie in der Protokolldatei für Echtzeitgebote in Authorized Buyers.

BidRequest-Objekt

Dies ist die Nachricht, die Google zur Anforderung von Geboten verwendet. Eine BidRequest enthält die Anzeigenfläche aus einer einzelnen Impression.

In diesem Abschnitt werden Informationen über den Nutzer aufgeführt.

Informationen zur Webseite oder App, von der die Impression stammt.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
id	erforderlich	Byte	Von Google generierte eindeutige Anfrage-ID. Sie ist 16 Byte lang.
ip	optional	Byte	Die ersten 3 Byte der IP-Adresse in Netzwerk-Byte-Reihenfolge für IPv4 oder die ersten 6 Byte für IPv6. Beachten Sie, dass sich die Anzahl und Position der Byte von IPv6-Adressen später ändern können.
user_data_treatment	repeated	enum	Wenn „user_data_treatment“ festgelegt ist, werden die Cookie-/ID-Daten des Nutzers aus der Anfrage gelöscht und nicht in den Callouts gesendet. Die betroffenen Felder sind: google_user_id Gehostete_Abgleichdaten mobile.verschlüsselte_Werbe-ID mobile.encrypted_hashed_idfa session_id TAG_FOR_CHILD_DIRECTED_TREATMENT = 0: Die aktuelle Anfrage sollte im Sinne des US-Gesetzes zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act, COPPA) als Inhalte für Kinder behandelt werden. Weitere Informationen findest du in diesem Artikel.
google_user_id	optional	String	Die Google-ID für den Nutzer, wie in der Dokumentation für den Cookie-Abgleichdienst beschrieben. Dieses Feld ist die nicht aufgefüllte websichere base64-codierte Version einer binären Cookie-ID. Weitere Informationen zur Codierung finden Sie im Abschnitt Base 64-Codierung mit URL- und Dateiname „Safe Alphabet“ in RFC 3548. Dieses Feld entspricht der vom Cookie-Abgleichdienst zurückgegebenen Google-ID.
cookie_version	optional	int32	Die Versionsnummer von google_user_id. Unter Umständen wird die Zuordnung von Cookie zu google_user_id geändert. In diesem Fall wird die Version erhöht.
cookie_age_seconds	optional	int32	Die Zeit in Sekunden, seit google_user_id erstellt wurde. Diese Zahl kann quantisiert werden.
hosted_match_data	optional	Byte	Abgleichsdaten, die für diesen google_user_id über den Cookie-Abgleichdienst gespeichert werden. Wenn eine Übereinstimmung vorhanden ist, enthält dieses Feld die decodierten Daten, die im Parameter google_hm übergeben wurden.
session_id	optional	String	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.
user_agent	optional	String	Ein String zur Identifizierung des Browsers und Gerätetyps, der die Anfrage gesendet hat. Bestimmte Daten können entfernt oder ersetzt werden.
privacy_treatments	optional	Datenschutzbestimmungen	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.
user_agent_data	optional	User-Agent	Informationen zum User-Agent.
publisher_country	optional	String	Das Land der Rechnungsadresse des Publishers Das kann ein anderes sein als das erkannte Land des Nutzers in geo_criteria_id oder das Hostingland der Website. Eine vollständige Liste der Ländercodes finden Sie in der Liste der Ländercodes.
host_publisher_id	optional	String	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.
inventorypartnerdomain	optional	String	Die Domain des Partners (der Website oder des App-Inhabers) mit einem Teil des Anzeigeninventars auf der Website oder 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.
geo_criteria_id	optional	int32	Standort des Endnutzers. Verwendet eine Teilmenge der Codes, die in der Google Ads API verwendet werden. In der Tabelle geo-table.csv der technischen Dokumentation finden Sie eine Liste von IDs. Das Feld geo_criteria_id ersetzt die Felder „Land“, „Region“, „Stadt“ und „Großraum“.
geo	optional	Region	Der ungefähre geografische Standort des Nutzers. Alle Standortinformationen werden aus der IP-Standortbestimmung abgeleitet. Die Felder „lat/lon“ können eine Referenzposition (z. B. Schwerpunkt) für den aus der IP-Standort abgeleiteten Standort sein, der auch von den anderen Feldern (z. B. einer Stadt) getragen wird. Die Genauigkeit ist dann der Radius eines Kreises mit dem ungefähren Bereich dieses Standorts. Der Standort und seine Genauigkeit werden nach Bedarf beeinträchtigt, um die Privatsphäre der Nutzer zu schützen.
postal_code postal_code_prefix	optional	String	Es wurde eine Postleitzahl des entsprechenden Typs des Landes des Endnutzers erkannt (z. B. Postleitzahl, wenn das Land „US“) ist. Das Feld postal_code_prefix wird festgelegt, wenn die Genauigkeit zu niedrig ist, um einen vollständigen Code zu implizieren. Andernfalls ist das Feld postal_code festgelegt.
encrypted_hyperlocal_set	optional	Byte	Verschlüsselte hyperlokale Ausrichtungssignale
hyperlocal_set	optional	HyperlocalSet	Unverschlüsselte Version von encrypted_hyperlocal_set. Dieses Feld wird nur festgelegt, wenn Sie eine SSL-Verbindung verwenden.
timezone_offset	optional	int32	Die Abweichung der Nutzerzeit in GMT in Minuten. GMT+10 ist beispielsweise timezone_offset = 600.
user_list	repeated	Zusatzliste
publisher_id	optional	String	Die Publisher-ID, die durch das Publisher-Code-Suffix des Web-Property-Codes definiert wird. Beispielsweise ist „pub-123“ der Publisher-Code des Web-Property-Codes „ca-pub-123“ (ca- ist das produktspezifische Präfix der Web-Property).
seller_network_id	optional	int32	Die Netzwerk-ID des Verkäufers. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei „sellers-network-ids.txt“. Dieser Wert wird nur festgelegt, wenn die Website nicht anonym ist und der Publisher das Website-Targeting erlaubt.
partner_id	optional	fest64	ID des Partners, der dieses Inventar bereitstellt Dies ist nur festgelegt, wenn seller_network_id ebenfalls festgelegt wurde und weitere Partnerinformationen verfügbar sind, die über das seller_network_id-Element hinausgehen. Der Wert von partner_id ist nur sinnvoll, wenn Sie eine stabile Kennung angeben.
url	optional	String	Die URL der Seite, ohne die Parameter zu entfernen. Dies beginnt immer mit einem Protokoll (entweder http oder https).
is_semi_transparent_request	optional	bool	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.
detected_language	repeated	String	Erkannte Nutzersprachen basierend auf der Sprache der Webseite, der Browsereinstellungen und anderer Signale. Die Reihenfolge ist willkürlich. Die Codes bestehen aus 2 oder 5 Zeichen und sind in der Tabelle „Sprachcodes“ dokumentiert.
detected_vertical	repeated	Vertikal	Hinweis:Die Werte für dieses Feld werden jetzt entfernt. Ungeordnete Liste der erkannten Inhaltsbranchen. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei publisher-Verticals.txt.
detected_content_label	repeated	int32	Hinweis:Die Werte für dieses Feld werden jetzt entfernt. Liste der erkannten Inhaltslabels. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei content-labels.txt.
google_query_id	optional	String	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.
auction_type	optional	enum	Die Art der Auktion, die für diese Abfrage durchgeführt wird. Standardwert = SECOND_PRICE. UNKNOWN_AUCTION_TYPE = 0 FIRST_PRICE = 1 SECOND_PRICE = 2 FIXED_PRICE = 3
device	optional	Gerät
key_value	repeated	Schlüssel/Wert-Paar
mobile	optional	Mobil
video	optional	Video
publisher_settings_list_id	optional	fest64	Die ID der Liste mit den Publisher-Einstellungen, die für diese Seite gilt. Weitere Informationen findest du im Leitfaden zu RTB-Publisher-Einstellungen.
publisher_type	optional	enum	Publisher-Typ des Inventars, in dem die Anzeige ausgeliefert wird Bei einer bestimmten Anfrage kann das Inventar des Publishers entweder dem Publisher gehören und von diesem betrieben werden, vom Publisher vertreten werden oder einen unbekannten Status haben. Standardwert = UNKNOWN_PUBLISHER_TYPE. UNKNOWN_PUBLISHER_TYPE = 0 PUBLISHER_OWNED_AND_OPERATED = 1 PUBLISHER_REPRESENTED = 2
page_visibility	optional	enum	Der Sichtbarkeitsstatus der Webseite, die die Anzeigenflächen 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 im Vordergrund eines nicht minimierten Fensters geschehen. 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.
adslot	repeated	Anzeigenfläche
bid_response_feedback	repeated	Feedback für Gebotsantworten
response_deadline_ms	optional	int32	Gibt an, wie lange Google auf eine Antwort in Millisekunden auf diese bestimmte Gebotsanfrage wartet. Wenn die Richtlinie nicht konfiguriert ist, sollten Bieter davon ausgehen, dass die Standardfrist verwendet wird.
is_test	optional	bool	Bei „true“ ist das eine Testanfrage. Die Ergebnisse werden den Nutzern nicht angezeigt und Ihnen werden keine Antworten in Rechnung gestellt, selbst wenn sie die Auktion gewinnen. Trotzdem sollten Sie die Verarbeitung regelmäßig durchführen, da die Anfrage möglicherweise zum Bewerten der Latenzen oder für andere Tests verwendet wird. Während der ersten Tests mit Google-Zugriffen werden Ihre Antworten aus der Auktion herausgefiltert, unabhängig davon, ob diese Option den Wert „wahr“ oder „falsch“ hat.
is_ping	optional	bool	Wenn der Wert „true“ ist, dient diese Anfrage zum Messen der Netzwerklatenz. Geben Sie ein leeres BidResponse-Objekt zurück, bei dem nur „processing_time_ms“ so schnell wie möglich festgelegt ist, ohne eine Gebotslogik auszuführen.
is_predicted_to_be_ignored	optional	bool	Wenn der Wert „true“ ist, hat das Callout-Modell prognostiziert, dass Sie nicht auf diese Anfrage bieten. Wir senden einen Stichprobenanteil dieser Anfragen, damit das Modell automatisch aktualisiert werden kann, wenn sich die Gebotsmuster ändern.
supply_chain	optional	SupplyChain

User-Agent-Objekt

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	Erforderlich/Optional	Typ	Implementierungsdetails
browser	optional	BrandVersion	Identifiziert den Browser
platform	optional	BrandVersion	Kennzeichnet die Plattform.
mobile	optional	bool	„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	optional	String	Gerätearchitektur, z. B. „x86“ oder „Arm“.
bitness	optional	String	Bit-Nummer des Geräts, z. B. „64“ für eine 64-Bit-Architektur
model	optional	String	Gerätemodell

PrivacyTreatment-Objekt

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.

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
non_personalized_ads_reason	optional	NonPersonalizedAdsReason Aufzählung	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	optional	bool	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.

BrandVersion-Objekt

Mutter/Vater

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

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
brand	optional	String	Markenkennzeichnung, z. B. „Chrome“ oder „Windows“.
version	repeated	String	Version, bei Bedarf in Komponenten aufteilen, z. B. {"85", "1"} = v85.1.

Geografisches Objekt

Der ungefähre geografische Standort des Nutzers. Alle Standortinformationen werden aus der IP-Standortbestimmung abgeleitet. Die Felder „lat/lon“ können eine Referenzposition (z. B. Zentrum) für den aus der IP-Standort abgeleiteten Standort sein, der auch von den anderen Feldern (z. B. einer Stadt) getragen wird. Die Genauigkeit ist der Radius eines Kreises mit dem ungefähren Bereich dieses Standorts. Der Standort und die Genauigkeit werden nach Bedarf beeinträchtigt, um die Privatsphäre der Nutzer zu schützen.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
lat	optional	Doppelwert
lon	optional	Doppelwert	Längengrad von -180.0 bis +180.0, wobei negativ West ist.
country	optional	String	Land mit ISO-3166-1 Alpha-3.
region	optional	String	Regionscode mit ISO-3166-2; aus zwei Buchstaben bestehender Bundesstaat, wenn USA.
metro	optional	String	Google-Großraumcode, ähnelt den Nielsen-DMAs, aber nicht genau davon
city	optional	String	Stadt, in der der UN-Kodex für Handels- und Transportstandorte verwendet wird. Klicken Sie in der Länderliste auf ein Land, um die Stadtcodes zu sehen.
zip	optional	String	Postleitzahl.
accuracy	optional	int32	Geschätzte Standortgenauigkeit in Metern.
utcoffset	optional	int32	Ortszeit als Anzahl +/- von Minuten ab UTC

HyperlocalSet-Objekt

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
hyperlocal	repeated	Hyperlokal	Dieses Feld enthält derzeit höchstens ein hyperlokales Polygon.
center_point	optional	Hyperlokal.Zugangspunkt	Das ungefähre geometrische Zentrum eines Geofence-Bereichs. Sie wird ausschließlich auf Grundlage der geometrischen Form des Geofence-Bereichs berechnet und gibt in keiner Weise den tatsächlichen Standort des Mobilgeräts im Geofence-Bereich an. Wenn oben mehrere hyperlokale Polygone angegeben sind, ist center_point der geometrische Mittelpunkt aller hyperlokalen Polygone.

Hyperlokales Objekt

Mutter/Vater

Ungefähre Standortinformationen, basierend auf der IP-Adresse des Geräts, von dem die Anzeigenanfrage stammt.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
corners	repeated	Zugangspunkt	Das Gerät kann sich innerhalb des Geofence-Polygons befinden, das durch eine Liste von Ecken definiert wird. Derzeit ist das Polygon immer ein Parallelogramm mit 4 Ecken.

Punktobjekt

Mutter/Vater

Ein Ort auf der Erdoberfläche.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
latitude	optional	float	Breitengrad des Orts.
longitude	optional	float	Längengrad des Standorts

ACL-Objekt

Dieses Feld wird nicht standardmäßig ausgefüllt. Bieter sollten stattdessen Listen-IDs mit google_user_id oder hosted_match_data als Schlüssel speichern und suchen.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
id	optional	int64	Die ID der Nutzerliste.
age_seconds	optional	int32	Die Zeit in Sekunden, seit der Nutzer in die Liste aufgenommen wurde.

Vertikales Objekt

Eine oder mehrere von Google ermittelte Branchen für die Seite.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
id	erforderlich	int32	Die Branchen-ID. In der technischen Dokumentation in der Datei „publisher-Verticals.txt“ finden Sie eine Liste der IDs.
weight	erforderlich	float	Gewichtung für diese Branche im Bereich (0,0, 1,0). Relevantere Branchen haben eine höhere Gewichtung.

Geräteobjekt

Informationen zum Gerät.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
device_type	optional	enum	Der Gerätetyp, auf dem die Anzeige erscheint. Standardwert = UNKNOWN_DEVICE. UNKNOWN_DEVICE = 0 HIGHEND_PHONE = 1 TABLET = 2 PERSONAL_COMPUTER = 3 – Computer oder Laptop. CONNECTED_TV = 4: Sowohl internetfähige Fernseher (Smart-TVs) als auch verbundene Geräte wie Roku und Apple TV. GAME_CONSOLE = 5
platform	optional	String	Die Plattform des Geräts. Beispiele: Android, iPhone, Palm.
brand	optional	String	Die Marke des Geräts, z. B. Nokia, Samsung.
model	optional	String	Das Modell des Geräts, z. B. N70, Galaxy.
os_version	optional	OsVersion	Betriebssystemversion, z. B. 2 für Android 2.1 oder 3.3 für iOS 3.3.1.
carrier_id	optional	int64	Eindeutige Kennung des Mobilfunkanbieters, wenn das Gerät über WLAN (nicht über WLAN) mit dem Internet verbunden ist Den Namen und das Land des Mobilfunkanbieters finden Sie in der Tabelle der Mobilfunkanbieter.
screen_width	optional	int32	Breite des Gerätebildschirms in Pixeln
screen_height	optional	int32	Höhe des Gerätebildschirms in Pixeln
screen_pixel_ratio_millis	optional	int32	Diese Option wird für Geräte mit hoher Dichte verwendet, beispielsweise iOS-Retina-Displays. Ein nicht standardmäßiger Wert gibt an, dass die nominelle Bildschirmgröße (mit Pixeln als Einheit) nicht die tatsächliche Anzahl von Pixeln auf dem Bildschirm beschreibt. Die nominelle Breite und Höhe können bei einem Bildschirm mit 640 x 1280 Pixeln beispielsweise 320 x 640 betragen, in diesem Fall screen_width=320, screen_height=640 und screen_pixel_ratio_millis=2000, da jede Achse doppelt so viele Pixel hat, wie ihre Abmessungen angeben würden. Standardwert = 0.
screen_orientation	optional	enum	Die Bildschirmausrichtung des Geräts beim Senden der Anzeigenanfrage. Standardwert = UNKNOWN_ORIENTATION. UNKNOWN_ORIENTATION = 0 PORTRAIT = 1 LANDSCAPE = 2
hardware_version	optional	String	Apple iOS-Gerätemodell, z. B. „iPhone 5S“, „iPhone 6+“, „ipad 4“.
limit_ad_tracking	optional	bool	„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.
app_tracking_authorization_status	optional	enum	Dieses Feld wird nur für iOS-Geräte ausgefüllt. Gibt den Autorisierungsstatus des App-Trackings an. Dieser Wert wird von ATTrackingManager abgerufen und unverändert bereitgestellt. Weitere Informationen zum App-Tracking-Autorisierungsstatus von iOS finden Sie in diesem Artikel. NOT_DETERMINED = 0 RESTRICTED = 1 DENIED = 2 AUTHORIZED = 3

OsVersion-Objekt

Mutter/Vater

Enthält die Betriebssystemversion der Plattform. Für Android 2 gilt: z. B. major=2, Minderjährige=0. Für iPhone 3.3.1, Major=3 und klein=3.

Attribut	Erforderlich/Optional	Typ
major minor micro	optional	int32

Schlüssel/Wert-Objekt

Zusätzliche Schlüssel/Wert-Paar-Attribute. Derzeit nicht verwendet.

Attribut	Erforderlich/Optional	Typ
key value	optional	String

Mobiles Objekt

Informationen zu Anzeigenanfragen von Mobilgeräten. Ein Mobilgerät ist entweder ein Smartphone oder ein Tablet. Dies gilt für Anzeigenanfragen von mobilen Geräten, die im Web surfen, und von mobilen Apps.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
is_app	optional	bool	Bei „true“ stammt die Anfrage von einer mobilen App. Gilt immer, wenn app_id festgelegt ist.
app_id	optional	String	Die ID der mobilen App, wenn diese Anzeigenanfrage von einer mobilen App stammt. Wenn die App aus dem Apple iTunes App Store heruntergeladen wurde, ist dies die App-Shop-ID, z. B. 343200656. Bei Android-Geräten ist dies der voll qualifizierte Paketname, z. B. com.rovio.angrybirds. Bei Windows-Geräten ist es die App-ID. Beispiel: f15abcde-f6gh-47i0-j3k8-37l93817mn3o.
is_interstitial_request	optional	bool	Bei "true" handelt es sich um eine Vollbildanzeige für Mobilgeräte.
app_category_ids	repeated	int32	Hinweis:Die Werte für dieses Feld werden jetzt entfernt. Dieses Feld enthält die IDs der Kategorien, zu denen die aktuelle mobile App gehört. Dieses Feld ist leer, wenn is_app auf „false“ gesetzt ist. Die Zuordnung zwischen mobilen Apps und Kategorien wird vom Google Play Store für Android-Apps bzw. vom Apple iTunes Store für iOS-Apps definiert. Den Kategorienamen finden Sie in der Tabelle zur Kategorie der mobilen Apps.
is_mobile_web_optimized	optional	bool	Bei einer Anfrage für das mobile Web gibt dieses Feld an, ob die Seite für mobile Browser auf High-End-Smartphones optimiert ist. Die Standardeinstellung ist „false“.
is_app_open_ad	optional	bool	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.
encrypted_advertising_id	optional	Byte	Dieses Feld wird für Werbe-IDs verwendet für: iOS-Geräte (wird in diesem Hilfeartikel als IDFA (Identifier for Advertising) bezeichnet)) Android-Geräte Roku-Geräte Microsoft Xbox-Geräte Amazon-Geräte Wenn encrypted_advertising_id ein IDFA ist, ist der Klartext nach der Entschlüsselung des Geheimtexts der IDFA (16-Byte-UUID), der von [ASIdentifierManager advertisingIdentifier] von iOS zurückgegeben wird. Bei encrypted_hashed_idfa ist der Klartext der 16-Byte-MD5-Hash des IDFA. Je nach SDK-Version, die die Anfrage stellt, ist nur eines der beiden Felder verfügbar. Spätere SDKs stellen nicht gehashte Werte bereit.
encrypted_hashed_idfa	optional	Byte	Weitere Informationen finden Sie in der Beschreibung zu „encrypted_advertising_id“.
advertising_id	optional	Byte	Unverschlüsselte Version von encrypted_advertising_id. Dieses Feld wird nur festgelegt, wenn Sie eine SSL-Verbindung verwenden. Dieses Feld ist eine 16-Byte-UUID.
hashed_idfa	optional	Byte	Unverschlüsselte Version von encrypted_hashed_idfa. Dieses Feld wird nur festgelegt, wenn Sie eine SSL-Verbindung verwenden. Dieses Feld ist ein 16 Byte MD5.
app_name	optional	String	Die App-Namen für Android-Apps stammen aus dem Google Play Store. App-Namen für iOS-Apps werden von App Annie bereitgestellt.
app_rating	optional	float	Durchschnittliche Nutzerbewertung für die App zwischen 1,0 und 5,0. Derzeit nur für Apps im Google Play Store verfügbar.
installed_sdk	optional	Installiert SDD	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
skadn	optional	SKAdNetworkRequest	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 diesem Artikel.

installedSdk-Objekt

Mutter/Vater

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

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
id	optional	String	Kennung für das installierte SDK.
sdk_version	optional	Version	Die Version des installierten SDKs.
adapter_version	optional	Version	Die Version des Adapters, der mit dem installierten SDK kommuniziert.

Versionsobjekt

Mutter/Vater

Semantische Version des installierten SDKs und des Adapters, die zwischen dem installierten SDK und dem Google SDK kommunizieren.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
major	optional	int32	Standard = -1
minor	optional	int32	Standard = -1
micro	optional	int32	Standard = -1

SKAdNetworkRequest-Objekt

Mutter/Vater

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 diesem Artikel.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
versions	repeated	String	Liste aller von der Anfrage unterstützten SKAdNetwork-Versionen, je nach Betriebssystem- und SDK-Version.
sourceapp	optional	String	ID der Publisher-App im App Store von Apple.
skadnetids	repeated	String	SKAdNetworkIdentifier-Einträge in der Info.plist der Publisher App.
supported_fidelity_types	repeated	enum	Liste der unterstützten Fidelity-Typen, je nach SKAdNetwork-API-Version, die vom Betriebssystem und SDK unterstützt wird, sowie an den Anzeigenflächeneigenschaften. VIEW_THROUGH_ADS = 0; Attribution für App-Installationen innerhalb von 24 Stunden nach dem 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 über die von StoreKit gerenderte Produktseite im App Store initiiert werden, die auf Anzeigenklicks zurückzuführen ist. Wird für alle SKAdNetwork-Versionen unterstützt. Weitere Informationen finden Sie in diesem Artikel.
skoverlay	optional	bool	Gibt an, ob diese Anfrage die SKOverlay-Funktion für Videoanzeigen unterstützt.

Videoobjekt

Informationen zum Video, wenn es sich um eine In-Video-Anzeigenanfrage handelt

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
placement	optional	enum	In diesem Feld wird angegeben, wo die Videoanzeige wiedergegeben wird. Standardwert = UNKNOWN_PLACEMENT. UNKNOWN_PLACEMENT = 0. INSTREAM = 1: In-Stream bedeutet, dass die Anzeige vor, während oder nach einem anderen Videocontent wiedergegeben wird. Dies ähnelt einem traditionellen TV-Werbespot. Der Videocontent, den sich der Nutzer ansieht, wird während der Anzeigenwiedergabe nicht abgespielt. INTERSTITIAL = 2: „Interstitial“ bedeutet, dass die Videoanzeige vor Nicht-Videocontent (z. B. einem Nachrichtenartikel oder einem Videospiel) wiedergegeben wird. Die Anzeige nimmt die gesamte Fläche auf dem Bildschirm ein, auf der der Inhalt zu sehen ist. Der Nutzer kann erst mit dem Inhalt fortfahren, wenn die Anzeige vollständig wiedergegeben wurde. IN_FEED = 3 – Das In-Feed-Videoformat ist ein Video-Creative, das in einem Contentfeed, in der Regel in einem Feed in sozialen Apps oder einer Liste mit redaktionellen Inhalten usw., während der Nutzer scrollt, angezeigt wird. Es wird zentriert und nicht an der Seite gerendert. AUDIO = 4: „Audio“ ist eine Anfrage für eine Anzeige, bei der es sich um einen Audiostream handelt. Dies unterscheidet sich von dem oben genannten INSTREAM, der ausschließlich für Videoanfragen verwendet wird. IN_ARTICLE = 5: Das In-Article-Videoformat ist ein Video-Creative, das als eigenständiger Videoplayer zwischen Absätzen von redaktionellem Content geladen und wiedergegeben wird.
description_url	optional	String	Die URL der Seite, die der Publisher Google zur Beschreibung des Videocontents zur Verfügung stellt, wobei Parameter entfernt werden.
is_embedded_offsite	optional	bool	Bei "true" wird das Video auf einer Seite außerhalb der Domain des Publishers eingebettet. Wenn dies festgelegt ist, verweist description_url (wie immer) auf eine Beschreibung des Videos und das Feld url in der BidRequest ist die Seite, auf der das Video eingebettet ist. Für eine Anfrage für eine In-Stream-Anzeige in einem Vimeo-Video, das auf Facebook geteilt wird, ist beispielsweise is_embedded_offsite festgelegt. Das Feld url bezieht sich auf eine Facebook-Seite und die description_url verweist auf das Video bei Vimeo.
playback_method	optional	enum	In diesem Feld wird die Wiedergabe der Videoanzeige beschrieben. Die Wiedergabemethode wird anhand der besten verfügbaren Messung automatisch oder per Click-to-Play oder Mouseover festgelegt. Dazu gehört beispielsweise, wie lange der Nutzer zuletzt mit einer Webseite interagiert hat. Bei der automatischen Wiedergabe werden die Anzeigen mit oder ohne Ton wiedergegeben. Einige Anzeigen (z. B. In-Feed-Anzeigen) werden stummgeschaltet, bis der Nutzer mit der Anzeige interagiert. Wenn eine Anzeige normalerweise mit eingeschaltetem Ton wiedergegeben werden würde, das Gerät aber stummgeschaltet ist, wird der Wert auf „Ton“ gesetzt. Bei Geräten, auf denen nicht festgestellt werden kann, ob das Gerät stummgeschaltet ist (z. B. Computer), wird davon ausgegangen, dass der Ton eingeschaltet ist. Standardwert = METHOD_UNKNOWN. METHOD_UNKNOWN = 0 AUTO_PLAY_SOUND_ON = 1 AUTO_PLAY_SOUND_OFF = 2 CLICK_TO_PLAY = 3 MOUSE_OVER = 4 INITIATE_ON_ENTERING_VIEWPORT_SOUND_ON = 5 INITIATE_ON_ENTERING_VIEWPORT_SOUND_OFF = 6
is_clickable	optional	bool	Gibt an, ob der Nutzer durch Klicken auf die Videoanzeige zum Aufrufen der Website des Werbetreibenden weitergeleitet werden soll. Einige Plattformen, insbesondere internetfähige Fernseher, unterstützen das Klicken auf Videoanzeigen nicht. In diesem Fall ist das Feld auf „false“ gesetzt.
videoad_start_delay	optional	int32	Die Zeit in Millisekunden ab dem Start des Videos, wenn die Anzeige ausgeliefert wird. 0 bedeutet: Pre-Roll, -1 (oder ein negativer 32-Bit-Ganzzahl) bedeutet Post-Roll und 1 (oder ein positiver 32-Bit-Ganzzahl) bedeutet Mid-Roll. Der Wert ist nur gültig, wenn dieser Parameter festgelegt ist. Wenn die Richtlinie nicht konfiguriert ist, ist die Anzeigeposition unbekannt.
max_ad_duration	optional	int32	Die maximale Dauer der Anzeige in Millisekunden, die zurückgegeben werden soll. Wenn dies nicht festgelegt ist oder den Wert <= 0 hat, ist eine beliebige Dauer zulässig.
min_ad_duration	optional	int32	Die Mindestdauer der Anzeige (in Millisekunden), die zurückgegeben werden soll. Wenn dieser Wert nicht festgelegt wurde oder den Wert <= 0 hat, gibt es keine Mindestdauer.
max_ads_in_pod	optional	int32	Die maximale Anzahl von Anzeigen in einem Videopod. Ein Wert ungleich null gibt an, dass die aktuelle Anzeigenfläche ein Videopod ist, in dem mehrere Videoanzeigen präsentiert werden können. Die tatsächliche Anzahl der ausgelieferten Videoanzeigen darf diesen Wert nicht überschreiten.
video_ad_skippable	optional	enum	Lässt der Publisher überspringbare Videoanzeigen zu? Standardwert = ALLOW_SKIPPABLE. ALLOW_SKIPPABLE = 0 REQUIRE_SKIPPABLE = 1 BLOCK_SKIPPABLE = 2
skippable_max_ad_duration	optional	int32	Die maximal zulässige Dauer in Millisekunden für die Anzeige, die zurückgegeben werden soll, wenn diese Anzeige überspringbar ist (in der Regel von der maximal zulässigen Dauer für nicht überspringbare Anzeigen). Wenn dies nicht festgelegt ist oder den Wert <= 0 hat, ist eine beliebige Dauer zulässig.
protocols	repeated	enum	Array mit unterstützten Gebotsprotokollen für Videos Unterstützte Videoprotokolle. VAST_1_0 = 1 VAST_2_0 = 2 VAST_3_0 = 3 VAST_1_0_WRAPPER = 4 VAST_2_0_WRAPPER = 5 VAST_3_0_WRAPPER = 6 VAST_4_0 = 7 VAST_4_0_WRAPPER = 8 DAAST_1_0 = 9 DAAST_1_0_WRAPPER = 10
allowed_video_formats	repeated	enum	Die für diese Anfrage zulässigen Videodateiformate. Die Antwort sollte mindestens eine der Antworten unterstützen. UNKNOWN_VIDEO_FORMAT = -1; // Flash video files are accepted (FLV). VIDEO_FLV = 0; VIDEO_MP4 = 1; // Valid VAST ads with at least one media file // hosted on youtube.com. YT_HOSTED = 2; // Flash VPAID (SWF). VPAID_FLASH = 3; // JavaScript VPAID. VPAID_JS = 4; AUDIO_MP3 = 5; AUDIO_OGG = 6; // Requires both MP3 & OGG as Google does not know // which codecs are installed on the player. AUDIO_MP3_OGG = 7; VIDEO_WEBM = 8; VIDEO_MOV = 9; VIDEO_3GPP = 10; VIDEO_HLS = 11; VIDEO_DASH = 12; // Audio version of MP4. AUDIO_MP4A = 13;
companion_slot	repeated	Companion-Slot	Informationen zu den Companion-Anzeigenflächen, die im Video eingeblendet werden können. Obwohl dies ein wiederkehrendes Feld ist, gibt es in den meisten Fällen nur einen Wert. Wenn keine Companion-Anzeigen verfügbar sind, wird dieses Feld nicht festgelegt.
end_cap_support	optional	enum	Endbannerunterstützung Wenn diese Option aktiviert ist, kann die Companion-Anzeige so ausgewählt werden, dass sie als Endbanner (Infokarte) in der Anzeigenfläche gerendert wird, nachdem die Videoanzeige wiedergegeben wurde. Wenn mehrere Companion-Anzeigen zurückgegeben werden, wählt das IMA SDK die aus, die am besten zur Bildschirmgröße des Geräts passt. Endbanner werden nur bei Videoinventar für Mobilgeräte unterstützt. Seit August 2015 werden END_CAP_FORBIDDEN und END_CAP_REQUIRED nicht mehr unterstützt. END_CAP_NOT_ENABLED = 0;: Die Companion-Anzeige wird nicht als Endbanner gerendert. END_CAP_OPTIONAL = 1;: Das Endbanner wird gerendert, wenn die Antwort ein geeignetes Companion-Banner enthält, ein Companion-Banner aber nicht erforderlich. END_CAP_FORBIDDEN = 2;: Die Antwort mit der Companion-Anzeige wird gefiltert. END_CAP_REQUIRED = 3;: Die Antwort ohne Companion-Anzeige wird gefiltert.
content_attributes	optional	ContentAttributes	Attribute des Videos, den der Nutzer sieht, nicht die Videoanzeige. Diese Felder basieren auf der Verfügbarkeit der Videometadaten des Video-Publishers und werden möglicherweise nicht immer ausgefüllt.
DEPRECATED_inventory_type	optional	enum	Der Typ des Inventars, von dem die Anfrage gesendet wird. Eingestellt, wird aber noch bis Januar 2017 ausgefüllt. Legen Sie mithilfe des Placement-Felds fest, ob es sich um Interstitial- oder In-Stream-Inventar handelt. Mit Device.device_type kannst du feststellen, ob die Anfrage von einem Mobilgerät stammt, und Mobile.is_app, um zu ermitteln, ob die Anfrage von einer App stammt. WEB_VIDEO ist INSTREAM Placement aus Webbrowsern. GAMES besteht aus INTERSTITIAL-Placements sowohl aus Apps als auch aus Webbrowsern. MOBILE_INTERSTITIAL ist nur INTERSTITIAL Placements aus Apps. Auf diesem Inventar sind auch Displayanzeigen zulässig. Wenn adslot.excluded_attributes nicht den Wert 21 (CreativeType: Html) enthält, lässt sich erkennen, ob auf einer Anzeigenfläche Displayanzeigen zulässig sind. MOBILE_APP_VIDEO ist nur INSTREAM Placement aus Apps. WEB_VIDEO = 0 GAMES = 1 MOBILE_INTERSTITIAL = 2 MOBILE_APP_VIDEO = 3
is_livestream	optional	bool	Legen Sie fest, ob die Anzeigenanfrage von einem Live-Videostream stammt (0 = nicht aktiv, 1 = live). Die Standardeinstellung ist „false“.

CompanionSlot-Objekt

Mutter/Vater

Informationen zu den Anzeigenflächen der Companion-Anzeigen, die im Video eingeblendet werden können Obwohl dies ein wiederkehrendes Feld ist, gibt es in den meisten Fällen nur einen Wert. Wenn keine Companion-Anzeigen verfügbar sind, wird dieses Feld nicht festgelegt. Sie wird nicht angezeigt, wenn der Nutzer das Video überspringt. Weitere Informationen finden Sie im Leitfaden zu Videoanzeigen.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
height	repeated	int32	Diese Felder stellen die verfügbaren Höhen und Breiten in diesem Slot dar. Es gibt immer dieselben Zahlen für Höhe und Breite.
width	repeated	int32	Diese Felder stellen die verfügbaren Höhen und Breiten in dieser Anzeigenfläche dar. Es gibt immer dieselben Zahlen für Höhe und Breite.
creative_format	repeated	enum	Das sind die Formate der Creatives, die auf dieser Companion-Anzeigenfläche zulässig sind. IMAGE_CREATIVE = 0 FLASH_CREATIVE = 1 HTML_CREATIVE = 2

ContentAttributes-Objekt

Mutter/Vater

Attribute des Videos, den der Nutzer sieht, nicht die Videoanzeige.

Diese Felder basieren auf der Verfügbarkeit der Videometadaten des Video-Publishers und werden möglicherweise nicht immer ausgefüllt.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
duration_seconds	optional	int32	Die Dauer des Videos in Sekunden.

AdSlot-Objekt

Informationen zu den Werbeflächen auf der Seite.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
id	erforderlich	int32	Eine willkürlich zugewiesene Slot-ID, die auf einer bestimmten Seite eindeutig ist und normalerweise ab 1 gezählt wird. Damit können Sie bestimmen, auf welche Anzeigenfläche in der BidResponse geboten werden soll.
ad_block_key	optional	uint64	Eine stabile Kennung für die Kombination aus Publisher, Anzeigenfläche und Seite.
targetable_channel	repeated	String	Gruppe von Channels, zu denen diese Anzeigenfläche gehört. Ein Channel ist eine Gruppe von Anzeigenflächen auf einer Website. Du kannst eine Ausrichtung auf einen Kanal (z. B. „Sportbereich“ oder „Alle Top-Banner“) vornehmen, um besser zu steuern, wo deine Anzeigen eingeblendet werden. Kanalnamen werden vom Publisher bereitgestellt.
width height	repeated	int32	Bei mobilen Interstitial-Anzeigen (einschließlich solcher, für die Videoanzeigen infrage kommen) entspricht die erste Breite und Höhe der Bildschirmgröße. Hierbei handelt es sich ebenfalls um die Größe des Videoplayers für VAST-Videoanzeigen. Nachfolgende Paare stellen die empfohlenen Interstitial-Anzeigengrößen dar, die den Größenbeschränkungen für Interstitials entsprechen. Sie dürfen beispielsweise nicht größer als die Bildschirmgröße und nicht kleiner als 50% der Breite und 40% der Höhe sein.
flexible_adslot_settings	optional	FlexibleAdSlotSettings	Wenn die Anzeigenfläche flexibel ist, enthält sie Einstellungen zur Größenanpassung der Anzeigenfläche.
excluded_attribute	repeated	int32	Die unzulässigen Attribut-IDs für die Anzeigen, die in dieser Anzeigenfläche erscheinen können. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei publisher-excludable-creative-attributes.txt.
allowed_vendor_type	repeated	int32	Die zulässigen Anbietertypen. Eine Liste der IDs findest du in der vendors.txt-Datei in der technischen Dokumentation. Dieses Feld gilt nicht für Deals mit Überschreibungen von Blockierungen. Weitere Informationen finden Sie in diesem Hilfeartikel.
consented_providers_settings	optional	ConsentedProvidersSettings	Informationen zu den Anbietern, für die der Publisher Google mitgeteilt hat, dass seine Nutzer im EWR der Verwendung ihrer personenbezogenen Daten für personalisierte Anzeigen zugestimmt haben. Dieses Feld wird nur ausgefüllt, wenn „regs_gdpr“ auf „true“ gesetzt ist.
regs_gdpr	optional	bool	Das Feld in Authorized Buyers wird ausschließlich anhand der Informationen ausgefüllt, die Google zur Verfügung gestellt werden, und zwar basierend darauf, ob die Impression für einen Nutzer im EWR ausgeliefert wird. Sie stellen keine Rechtsberatung zur DSGVO dar.
regs_lgpd	optional	bool	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
excluded_sensitive_category	repeated	int32	Die unzulässigen sensiblen Anzeigenkategorien. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei ad-sensitive-categories.txt. Du solltest diese Ausschlüsse erzwingen, wenn du Anzeigen in die aufgeführten Kategorien einordnen kannst. Dieses Feld gilt nicht für Deals mit Blockierungen. Weitere Informationen
allowed_restricted_category	repeated	int32	Die zulässigen eingeschränkten Anzeigenkategorien für private und offene Auktionen. Eine Liste der IDs findest du in der Datei ad-restricted-categories.txt in der technischen Dokumentation. Diese gelten nur für private und offene Auktionen. Weitere Informationen zu Preferred Deals oder programmatischen Garantien finden Sie im Feld allowed_restricted_category_for_deals.
allowed_restricted_category_for_deals	repeated	int32	Die zulässigen eingeschränkten Anzeigenkategorien für Preferred Deals oder programmatisch garantierte Deals. Die Datei ad-restricted-categories.txt in der technischen Dokumentation enthält eine Liste von IDs. Diese gelten nur für Preferred Deals oder programmatisch garantierte Deals. Für private und offene Auktionen gibt es das Feld allowed_restricted_category. In einigen Fällen sind eingeschränkte Kategorien nur für Preferred Deals oder programmatische Garantien zulässig. Daher werden in diesem Feld alle Kategorien in allowed_restricted_category und zusätzlich eingeschränkte Kategorien, die nur für Preferred Deals oder programmatische Garantien zulässig sind, aufgelistet.
allowed_languages	repeated	String	Liste der vom Publisher zugelassenen Creative-Sprachen. Die Reihenfolge ist beliebig. Die Codes bestehen aus 2 oder 5 Zeichen und sind in der Tabelle mit den Sprachcodes dokumentiert. Wenn die Richtlinie nicht konfiguriert ist, sind alle Sprachen zulässig.
excluded_product_category	repeated	int32	Die unzulässigen Produktkategorien Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei „ad-product-categories.txt“. Du solltest diese Ausschlüsse erzwingen, wenn du Anzeigen in die aufgeführten Kategorien einordnen kannst. Dieses Feld gilt nicht für Deals mit Blockierungen wie in diesem Hilfeartikel beschrieben.
excluded_creatives	repeated	Ausgeschlossenes Creative	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.
only_deal_bids_accepted	optional	bool	Hiermit wird angegeben, ob die Anzeigenfläche nur für Deals infrage kommt. Gebote für die offene Auktion werden herausgefiltert, wenn dieses Feld auf „true“ gesetzt ist. Bieter können auf die offene Auktion oder Deals bieten, wenn dieses Feld auf „false“ gesetzt ist.
matching_ad_data	repeated	MatchingAdData	Informationen zu passenden Pre-Targeting-Konfigurationen.
exchange_bidding	optional	Anzeigenplattform-Gebote	Parameter für Anzeigenplattform-Gebote (über Anzeigenplattformen von Drittanbietern abgegebene Echtzeitgebote in Google Ad Manager). Dies wird nie in Aufrufen von Authorized Buyers-Echtzeitgeboten eingefügt.
open_bidding	optional	OpenBidding	Die Parameter werden in allen Open Bidding-Anfragen gesendet.
ad_unit_mapping	optional	AdUnitMapping	Anzeigenblockzuordnungen, die der angegebenen Anzeigenfläche entsprechen.
dfp_ad_unit_code	optional	String	Der Ad Manager-Anzeigenblockcode Diese Einstellung wird derzeit nur für Open Bidding-Anfragen festgelegt.
slot_visibility	optional	enum	Sichtbarkeitsinformationen für die Anzeigenfläche. Standardwert = NO_DETECTION. NO_DETECTION = 0 ABOVE_THE_FOLD = 1 BELOW_THE_FOLD = 2
viewability	optional	int32	Prozentsatz der Sichtbarkeit für die Anzeigenfläche. Dies ist eine Schätzung der Wahrscheinlichkeit, dass dieser Slot für den Endnutzer auf der Grundlage von Verlaufsdaten und Umgebungsdaten sichtbar ist. Sie wird als Prozentsatz im Bereich [0, 100] ausgedrückt. Der Standardwert -1 gibt an, dass die Sichtbarkeit nicht geschätzt werden konnte.
click_through_rate	optional	float	Bisherige Klickrate für Anzeigen, die in der Anzeigenfläche ausgeliefert wurden. Ausgedrückt wird das als Dezimalbruch im Bereich [0,0, 1,0]. Der Standardwert von -1,0 gibt an, dass keine Daten zur bisherigen Klickrate verfügbar sind. Diese Zahl umfasst keine Daten, die aus Google Ads zusammengefasst wurden.
video_completion_rate	optional	float	Bisherige Abschlussrate für Videoanzeigen, die auf der Anzeigenfläche ausgeliefert wurden Ausgedrückt wird das als Dezimalbruch im Bereich [0,0, 1,0]. Der Standardwert von -1,0 gibt an, dass keine Daten zur bisherigen Abschlussrate verfügbar sind. Dieses Feld gilt nur für Videoinventar und enthält keine aus Google Ads aggregierten Daten.
iframing_state	optional	enum	iFraming-Status der Anzeigenfläche auf der Webseite, auf der sie vorhanden ist Standardwert = UNKNOWN_IFRAME_STATE. UNKNOWN_IFRAME_STATE = 0 NO_IFRAME = 1 SAME_DOMAIN_IFRAME = 2 CROSS_DOMAIN_IFRAME = 3
iframing_depth	optional	enum	iFrame-Tiefe der Anzeigenfläche auf der Webseite, auf der sie vorhanden ist Derzeit nur für Videoanzeigenanfragen festgelegt. Standardwert = UNKNOWN_IFRAME_DEPTH. UNKNOWN_IFRAME_DEPTH = 0 NOT_IN_IFRAME = 1 ONE_IFRAME = 2 MULTIPLE_IFRAME = 3
native_ad_template	repeated	NativeAnzeigenvorlage	Eine native Anzeige besteht aus Teilen, die vom Publisher gerendert werden. Ein Publisher kann mehrere unterschiedliche native Anzeigenvorlagen unterstützen. Wenn in der Anfrage auch Banner oder Videos zulässig sind, kannst du mit anderen Anzeigentypen antworten, indem du stattdessen „html_snippet“ oder „video_url“ festlegst. Wenn nur native Vorlagen vorhanden sind, müssen Sie das Feld „native_ad“ in jeder gesendeten Antwort festlegen.
native_placement_type	optional	enum	Beschreibt die Platzierung der nativen Anzeigenfläche in Bezug auf den Kontext. PLACEMENT_UNKNOWN = 0 PLACEMENT_IN_FEED = 1: im Contentfeed, z. B. als Element im organischen Feed, im Raster, in der Liste oder im Karussell. PLACEMENT_ATOMIC_UNIT = 2 – In der atomaren Einheit des Inhalts, z. B. auf der Artikelseite oder Seite mit einem einzelnen Bild. PLACEMENT_OUTSIDE = 3 – Außerhalb des Hauptinhalts, beispielsweise im Anzeigenbereich im rechten Bereich, als Banner-Placement in der Nähe des Contents usw. PLACEMENT_RECOMMENDATION = 4: Empfehlungs-Widget, das am häufigsten unter dem Artikelinhalt präsentiert wird.
mediation_status	optional	enum	Ob die Anzeigenanfrage direkt vom Publisher stammt Standardwert = UNKNOWN. UNKNOWN = 0 DIRECT_REQUEST = 1
auto_refresh	optional	Automatisch aktualisieren
sticky_settings	optional	Fixierte Einstellungen
non_browser_slot_source	optional	enum	Publisher-Deklaration, in der angegeben wird, dass diese Anzeigenfläche auf nicht browserbasiertem Inventar wie Desktop-Apps ausgeliefert werden darf Standardwert = UNDECLARED_SOURCE. UNDECLARED_SOURCE = 0 DESKTOP_APP = 1
renderer	optional	enum	Legt fest, wer die Umgebung steuert, von der die Anzeigenanfrage stammt, und die Anzeige rendert. Auf Plattformen, auf denen von Google geschriebener Code die Anzeige verarbeitet, wird dieses Feld auf GOOGLE gesetzt. Wenn das Feld auf PUBLISHER gesetzt ist, hat der Publisher seinen eigenen Code auf dem Gerät platziert, um die Wiedergabe der Anzeige zu verarbeiten. Es gibt keine technischen Unterschiede bei der Verarbeitung dieser Anfrage. Sie können dieses Feld verwenden, um aus technischen Gründen zwischen verschiedenen Umgebungen zu unterscheiden. Dieses Feld wird nur für Anfragen festgelegt, die VAST-Videoanzeigen zulassen. UNKNOWN_RENDERER = 0 GOOGLE = 1 PUBLISHER = 2
amp_ad_request_type	optional	enum	Ob diese Anfrage für eine Accelerated Mobile Page (AMP) gilt AMP-HTML-Seiten werden schneller geladen, da Teile von HTML, CSS und JavaScript eingeschränkt werden. Weitere Informationen zum Rendern von AMP-Anzeigen findest du in der Readme-Datei für AMP-Anzeigen. Standardwert = NON_AMP_PAGE. UNKNOWN_AMP = 0 – Unbekannter AMP-Status. Die Anfrage kann von einer AMP-Seite stammen, muss aber nicht. NON_AMP_PAGE = 1: Dies ist keine AMP-Seite. Kann reguläres HTML, VAST-Video usw. sein. AMP_PAGE_LATE_REQUEST = 2: Anfrage, die spät von einer AMP-HTML-Seite geladen wird. Die Anzeige wird mit einer geringfügigen Verzögerung gerendert, sodass sie die Leistung der Seiten nicht nicht beeinträchtigt.
is_amp_page	optional	enum	Gibt an, ob es eine AMP-Seite ist oder nicht. UNKNOWN_AMP_PAGE = 0 – Status der AMP-Seite ist unbekannt. DIALECT_HTML = 1: Dies ist keine AMP-Seite. DIALECT_HTML_AMP = 2: Das ist eine AMP-Seite.
amp_ad_requirement_type	optional	enum	Mögliche Typen von AMP-Anzeigen UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 0: Die Anforderungen an AMP-Anzeigen sind unbekannt. AMP_AD_NOT_ALLOWED = 1: AMP-Anzeigen sind nicht zulässig. AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 2: Entweder sind AMP-Anzeigen oder Nicht-AMP-Anzeigen zulässig. AMP-Anzeigen werden nicht frühzeitig gerendert. AMP_AD_ALLOWED_AND_EARLY_RENDERED = 3: Entweder sind AMP-Anzeigen oder Nicht-AMP-Anzeigen zulässig. AMP-Anzeigen werden frühzeitig gerendert. AMP_AD_REQUIRED = 4: AMP-Anzeigen sind erforderlich. Nicht-AMP-Anzeigen werden unter Umständen vom Publisher abgelehnt.
is_rewarded	optional	bool	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.
allowed_ad_types	repeated	enum	Mögliche Anzeigentypen, die in der Gebotsantwort zulässig sind. allowed_ad_types enthält immer einen oder mehrere Werte. Interstitial-Anzeigenflächen können auch Banneranzeigen unterstützen. Eine Anzeigenfläche mit ALLOWED_AD_TYPE_NATIVE kann ein natives Video unterstützen, unabhängig davon, ob ALLOWED_AD_TYPE_VIDEO festgelegt ist. Ebenso unterstützt eine Anzeigenfläche ohne ALLOWED_AD_TYPE_NATIVE kein natives Video, unabhängig davon, ob ALLOWED_AD_TYPE_VIDEO festgelegt ist. UNKNOWN_ALLOWED_AD_TYPE = -1 ALLOWED_AD_TYPE_BANNER = 0 ALLOWED_AD_TYPE_NATIVE = 1 ALLOWED_AD_TYPE_VIDEO = 2 ALLOWED_AD_TYPE_AUDIO = 3
session_depth	optional	int32	Gesamtzahl der Impressionen, die für diesen Nutzer in dieser Browsersitzung oder auf dieser speziellen Website erzielt wurden, plus 1. Eine Sitzung endet nach 30 Minuten Inaktivität. Der Standardwert von -1 gibt an, dass die Sitzungstiefe nicht geschätzt werden kann.
publisher_settings_list_id	repeated	fest64	In den Publisher-Einstellungen werden die IDs aufgeführt, die für diese Anzeigenfläche gelten. Weitere Informationen findest du im Leitfaden zu RTB-Publisher-Einstellungen.
secure_signals	repeated	SichereSignale	Vom Publisher übergebene sichere Signale
api	repeated	enum	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. Es sind folgende zulässig: UNKNOWN_FRAMEWORK = 0 MRAID_1 = 3 Definitionen der mobilen Rich Media-Anzeigenoberfläche Version 1.0 MRAID_2 = 5 Definitionen der mobilen Rich Media-Anzeigenoberfläche, Version 2.0 MRAID_3 = 6 Definitionen für Rich Media-Anzeigen auf Mobilgeräten Version 3.0 OMID_1 = 7 Open Measurement Interface Definition Version 1.0.
billable_event_rate_adjustment	optional	Doppelwert	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.
omidpn	optional	String	ID der OM SDK-Integration. Weitere Informationen finden Sie in den Hinweisen zum OpenRTB-Analysetool für OpenRTB.
omidpv	optional	String	Version der OM SDK-Integration. Weitere Informationen finden Sie in den Hinweisen zum OpenRTB-Analysetool für OpenRTB.
impression_expiration_seconds	optional	int32	Der erwartete Zeitraum, in dem eine Impression nach einem erfolgreichen Gebot in Sekunden erzielt werden kann. Die Impression kann nur abgerechnet werden, wenn sie innerhalb dieses Zeitraums ausgeliefert wird. Weitere Informationen zum Ablauf von Impressionen finden Sie unter https://developers.google.com/authorized-buyers/rtb/billing-event-guide.
frequency_capping_scope	erforderlich	FrequencyCappingScope Aufzählung	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 „BidResponse.ad.adslot.frequency_cap“ 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.
excluded_app_ids	repeated	String	Liste der Anwendungen anhand ihrer plattformspezifischen, plattformunabhängigen Anwendungs-IDs blockieren. Auf Android-Geräten müssen sie die Set- oder Paketnamen sein (z. B. com.foo.mygame). Unter iOS sind dies die numerischen IDs.

FlexibleAdSlotSettings-Objekt

Mutter/Vater

Einstellungen zur Größenanpassung der Anzeigenfläche.

Attribut	Erforderlich/Optional	Typ
max_width	optional	int32
max_height	optional	int32
min_width	optional	int32
min_height	optional	int32

ConsentedProvidersSettings-Objekt

Mutter/Vater

Informationen zu den Anbietern, für die der Publisher Google mitgeteilt hat, dass seine Nutzer im EWR der Verwendung ihrer personenbezogenen Daten für personalisierte Anzeigen zugestimmt haben. Dieses Feld wird nur ausgefüllt, wenn „regs_gdpr“ wahr ist.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
consented_providers	repeated	int64	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-Richtlinie zur Einwilligung der Nutzer in der EU. Wenn ein Publisher Version 2 des Transparency & Consent Framework (TCF) von IAB zum Verwalten der Nutzereinwilligung verwendet, finden Sie über den String für die zusätzliche Einwilligung die entsprechenden Anbieter dieser Anzeigentechnologie (weitere Informationen in diesem Artikel zum Modus für zusätzliche Einwilligung von Google). Anzeigen von Anbietern, die über den Einwilligungsstring TCF 2 eingewilligt haben, werden im Feld „ConsentedProvidersSettings.tcf_consent_string“ angezeigt. Eine Zuordnung der ATP-ID zum ATP-Namen wird unter provider.csv veröffentlicht.
tcf_consent_string	optional	String	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.

Ausgeschlossenes Creative-Objekt

Mutter/Vater

Ein Creative, das aufgrund von Google-Richtlinien oder Creative-Ablehnungen kein Gebot für diese Impression abgeben darf, sowie Creative-Attribute, Produktkategorien oder sensible Kategorien, zulässige Anbietertypen, eingeschränkte Kategorien oder Sprachen, die für die Gebotsanfrage gelten.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
buyer_creative_id	optional	String	Creative-ID des Käufers des unzulässigen Creatives.

MatchingAdData-Objekt

Mutter/Vater

Die Abrechnungs-IDs, die den übereinstimmenden Pre-Targeting-Konfigurationen entsprechen.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
billing_id	repeated	int64	Die Abrechnungs-IDs, die den übereinstimmenden Pre-Targeting-Konfigurationen entsprechen.
minimum_cpm_micros	optional	int64	Der minimale CPM-Wert, auf den Sie bieten können, vor der Auktion nicht gefiltert zu werden. Dies kann ein globales Minimum oder ein vom Publisher festgelegtes Minimum sein. Der Wert ist in „micros“ (millionstel) Ihrer Kontowährung angegeben.
direct_deal	repeated	DirectDeal

DirectDeal-Objekt

Mutter/Vater

Informationen zu Deals, die für dieses Inventar übereinstimmen.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
direct_deal_id	optional	int64	Eine ID zur Identifizierung des Deals.
fixed_cpm_micros	optional	int64	Sie müssen mindestens fixed_cpm_micros (in Micros Ihrer Kontowährung) bieten, um am Deal teilnehmen zu können. Wenn du gewinnst, werden dir fixed_cpm_micros in Rechnung gestellt. Dies gilt nicht, wenn deal_type=PRIVATE_AUCTION. Für private Auktionen müssen Sie mindestens fixed_cpm_micros bieten. Wenn Sie einen höheren CPM als fixed_cpm_micros bieten, ist die Wahrscheinlichkeit höher, dass bei deal_type=PRIVATE_AUCTION ein Gewinn erzielt wird. Die Wahrscheinlichkeit, dass Sie bei anderen Deals gewinnen, ist aber höher.
deal_type	optional	enum	Der Typ des Deals. Standardwert = UNKNOWN_DEAL_TYPE. UNKNOWN_DEAL_TYPE = 0 PREFERRED_DEAL = 1 PRIVATE_AUCTION = 2 PROGRAMMATIC_GUARANTEED = 3 – Weitere Informationen finden Sie im Hilfeartikel Unterschiede bei Echtzeitgeboten für programmatisch garantierte Deals. AUCTION_PACKAGE = 4: Weitere Informationen finden Sie im Hilfeartikel Auktionspakete. MARKETPLACE_PACKAGE = 5: Die Deal-ID für vom Publisher zusammengestellte Inventarpakete Weitere Informationen findest du im Hilfeartikel Marketplace-Pakete.
publisher_blocks_overridden	optional	bool	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.
creative_source	optional	enum	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 (Standard) festgelegt sein. CREATIVE_SOURCE_UNKNOWN = 0 CREATIVE_SOURCE_ADVERTISER = 1: Das Creative wird vom Werbetreibenden gehostet. Der Bieter muss in der Gebotsantwort ein Creative 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.
must_bid	optional	bool	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.

ExchangeBidding-Objekt

Mutter/Vater

Parameter für Anzeigenplattformen, die Open Bidding nutzen, also Anzeigenplattformen von Drittanbietern, die Echtzeitgebote in Ad Manager abgeben. Sie wird nie in Aufrufen von Authorized Buyers-Echtzeitgeboten eingefügt.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
publisher_parameter	repeated	String	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 Anzeigenplattform-Bieter vereinbart werden.
key_value	repeated	Schlüssel/Wert-Paar	Wiederholte Schlüssel/Wert-Paare, die vom Publisher an die Anzeigenplattform gesendet werden

OpenBidding-Objekt

Mutter/Vater

Die Parameter werden in allen Open Bidding-Anfragen gesendet.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
is_open_bidding	optional	bool	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.

AdUnitMapping-Objekt

Mutter/Vater

AdUnitMapping wird verwendet, um Publisher-Inventareinheiten im Namespace des Bieters zu identifizieren. Die Zuordnungen werden nur ausgefüllt, wenn der Bieter direkt mit einem Publisher zusammenarbeitet und die Zuordnungen vom Namespace des Anzeigenblocks von Google zum Inventar-Namespace des Bieters bereitstellt. Die Anzeigenblockzuordnung gilt nur für Anfragen mit einem benutzerdefinierten SDK. https://support.google.com/admanager/answer/9601810.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
Keyval	Optional	Schlüssel/Wert-Paar	Schlüssel/Wert-Paar, mit dem die Inventareinheit im Namespace des Bieters angegeben wird.
FormatType	Optional	enum	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;

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.ad.sdk_rendered_ad.sdk_params zurückgegeben werden. Diese wird an das SDK des Bieters übergeben.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
key	Optional	String	Der Schlüssel ist der Name der Inventareinheits-ID des Bieters für das SDK.
value	Optional	String	Der Wert der ID der Inventareinheit des Bieters für das angegebene Format.

NativeAdTemplate-Objekt

Mutter/Vater

Eine native Anzeige besteht aus Teilen, die vom Publisher gerendert werden. Ein Publisher kann mehrere unterschiedliche native Anzeigenvorlagen unterstützen. Wenn in der Anfrage auch Banner oder Videos zulässig sind, können Sie mit anderen Anzeigentypen reagieren, indem Sie stattdessen html_snippet, video_url oder video_vast_xml festlegen. Wenn nur native Vorlagen vorhanden sind, müssen Sie in jeder gesendeten Antwort das Feld native_ad festlegen.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
required_fields	optional	int64	Bitfeld, in dem die vom Publisher erforderlichen Felder beschrieben werden Gebotsantworten ohne Wert für diese Felder werden abgelehnt. Klick- und Ansicht-Tracking-URLs sind immer implizit erforderlich. enum Fields: Definiert die Bits, die in required_fields und recommended_fields verwendet werden. Für jedes Feld in BidResponse.Ad.NativeAd gibt es ein Bit. HEADLINE = 0x1 BODY = 0x2 CALL_TO_ACTION = 0x4 ADVERTISER = 0x8 IMAGE = 0x10 LOGO = 0x20 APP_ICON = 0x40 STAR_RATING = 0x80 PRICE = 0x100 STORE = 0x200 VIDEO = 0x400
recommended_fields	optional	int64	Bitfeld, in dem beschrieben wird, welche Felder vom Publisher empfohlen werden. Alle empfohlenen Felder werden unterstützt, aber es sind nicht alle empfohlenen Felder erforderlich. enum Fields: Definiert die Bits, die in required_fields und recommended_fields verwendet werden. Für jedes Feld in BidResponse.Ad.NativeAd gibt es ein Bit. HEADLINE = 0x1 BODY = 0x2 CALL_TO_ACTION = 0x4 ADVERTISER = 0x8 IMAGE = 0x10 LOGO = 0x20 APP_ICON = 0x40 STAR_RATING = 0x80 PRICE = 0x100 STORE = 0x200 VIDEO = 0x400
headline_max_safe_length body_max_safe_length call_to_action_max_safe_length advertiser_max_safe_length price_max_safe_length	optional	int32	max_safe_length gibt die maximale Anzahl von Unicode-Zeichen an, die garantiert nicht abgeschnitten werden. Längere Strings werden vom Publisher beim Rendern abgeschnitten.
image_width image_height logo_width logo_height app_icon_width app_icon_height	optional	int32	Die Breite und Höhe, aus denen das erforderliche Seitenverhältnis berechnet werden soll. Sie können ein größeres Bild in der Antwort angeben. Bilder mit Seitenverhältnissen, die sich erheblich von den Werten in Höhe und Breite unterscheiden, werden möglicherweise gefiltert.
style_id	optional	int32	Global eindeutige ID für den spezifischen Stil, HTML- und CSS-Code, mit dem die native Anzeige gerendert wird.
style_layout_type	optional	enum	Typ des Designlayouts für jede native Anzeigenvorlage. Standardwert = PIXEL. PIXEL = 0 FLUID = 1
style_height style_width	optional	int32	Wenn style_layout_type den Wert PIXEL hat, werden Breite und Höhe der gesamten nativen Anzeige nach dem Rendering angegeben. Wenn für style_layout_type der Wert FLUID angegeben ist, können style_height und style_width optional nicht ausgefüllt werden.

AutoRefresh-Objekt

Mutter/Vater

Einstellungen für die automatische Aktualisierung.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
refresh_settings	repeated	Einstellungen für die automatische Aktualisierung	Die Einstellungen für die automatische Aktualisierung, die der Publisher für dieses Inventar hat Das wiederholt sich, weil Publisher für ein Inventarelement mehrere Arten der automatischen Aktualisierung vornehmen können.
refresh_count	optional	int32	Die Häufigkeit, mit der diese Anzeigenfläche seit dem letzten Seitenaufbau aktualisiert wurde.

AutoRefreshSettings-Objekt

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
refresh_type	optional	enum	Der Typ der deklarierten automatischen Aktualisierung. Standardwert = UNKNOWN_AUTO_REFRESH_TYPE. UNKNOWN_AUTO_REFRESH_TYPE = 0 USER_ACTION = 1: Die Aktualisierung wird durch eine vom Nutzer ausgelöste Aktion wie Scrollen ausgelöst. EVENT = 2: Ereignisgesteuerte Inhaltsänderung. So werden beispielsweise Anzeigen aktualisiert, wenn sich das Ergebnis eines Fußballspiels auf der Seite ändert. TIME = 3: Zeitbasierte Aktualisierung. Anzeigen werden in einem vordefinierten Zeitintervall aktualisiert, auch wenn der Nutzer nicht aktiv ist.
min_refresh_interval_seconds	optional	int32	Das minimale Aktualisierungsintervall. Dies gilt für alle Aktualisierungsarten.

StickySettings-Objekt

Mutter/Vater

vom Publisher deklarierte fixierte Einstellungen.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
vertical_stickiness	optional	enum	Gibt an, ob die Anzeigenfläche eine Seitenleiste ist, die beim Scrollen des Nutzers auf dem Bildschirm erscheint. Standardwert = UNKNOWN_STICKINESS. UNKNOWN_STICKINESS = 0 IS_STICKY = 1
top_horizontal_stickiness	optional	enum	Gibt an, ob die Anzeigenfläche eine horizontale Fläche ist, die beim Scrollen oben auf dem Bildschirm erscheint. Standardwert = UNKNOWN_STICKINESS. UNKNOWN_STICKINESS = 0 IS_STICKY = 1
bottom_horizontal_stickiness	optional	enum	Gibt an, ob die Anzeigenfläche eine horizontale Anzeigenfläche ist, die beim Scrollen am unteren Bildschirmrand fixiert bleibt. Standardwert = UNKNOWN_STICKINESS. UNKNOWN_STICKINESS = 0 IS_STICKY = 1

SecureSignal-Objekt

Mutter/Vater

Vom Publisher übergebene sichere Signale

Attribut	Erforderlich/Optional	Typ	Details zur Implementierung
data	optional	String	Das sichere Signal
source_js	optional	SourceJs	Veraltet. Diese Funktion wird im Februar 2023 entfernt. Verwenden Sie stattdessen BidRequest.adslot.secure_signals.source.
source	optional	String	Die Quelle des Signals. ID für die Bibliothek oder das SDK, die diese Daten generiert hat.

SourceJs-Objekt

Mutter/Vater

Veraltet. Diese Funktion wird im Februar 2023 entfernt. Verwenden Sie stattdessen BidRequest.adslot.secure_signals.source.

Attribut	Erforderlich/Optional	Typ	Details zur Implementierung
id	optional	String	ID der JavaScript-Bibliothek, die diese Daten generiert hat.

BidResponseFeedback-Objekt

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	Erforderlich/Optional	Typ	Implementierungsdetails
request_id	optional	Byte	Die eindeutige ID aus BidRequest.id
creative_index	optional	int32	Index von BidResponse_Ad, wenn es mehr als einen gibt. Der Index des ersten Creatives beginnt bei null.
creative_status_code	optional	int32	Der Statuscode der Anzeige. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei creative-status-codes.txt.
cpm_micros	optional	int64	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 hätte überschritten werden sollen, um den Zuschlag zu erhalten. Diese Option ist nicht festgelegt, wenn das Gebot vor der Auktion herausgefiltert wurde, der Publisher oder der erfolgreiche Bieter das Preisfeedback deaktiviert hat oder wenn in Ihrem Konto die Freigabe von erfolgreichen Preisen deaktiviert wurde. Bei Erstpreisauktionen wird auch BidRequest.bid_response_feedback[].minimum_bid_to_win ausgefüllt.
minimum_bid_to_win	optional	int64	Der Mindestgebot, der nötig war, um die Auktion zu gewinnen, in Micros 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). Wenn Ihr Gebot die Auktion nicht gewonnen hat, ist dies das Gebot des Gewinners. Dieses Feld wird nur ausgefüllt, wenn Ihr Gebot an einer Erstpreisauktion teilgenommen hat. Wenn es vor der Auktion herausgefiltert wurde, wird es nicht ausgefüllt.
sampled_mediation_cpm_ahead_of_auction_winner	optional	int64	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 „micros“ (Mikros) Ihrer Kontowährung angegeben.
event_notification_token	optional	Byte	Ereignisbenachrichtigungstoken, das in der Gebotsantwort enthalten war.
buyer_creative_id	optional	String	Creative-ID des Käufers, die in der Gebotsantwort enthalten war

SupplyChain-Objekt

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

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
complete	optional	bool	Option, die angibt, ob die Kette alle an der Transaktion beteiligten Knoten enthält, die zum Inhaber der Website, der App oder des anderen Mediums des Inventars führen
nodes	repeated	SupplyChainNode	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.
version	optional	String	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-Objekt

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
advertising_system_identifier	optional	String	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.
seller_identifier	optional	String	Die ID, die mit dem Verkäufer- oder Reseller-Konto im Werbesystem verknüpft ist. Er muss denselben Wert enthalten, der für Transaktionen verwendet wird, z. B. „publisher_id“ im Google-Protokoll. Sollte auf 64 Zeichen begrenzt sein.
handles_payment	optional	bool	Gibt an, ob dieser Knoten am Zahlungsablauf für das Inventar beteiligt ist. Wenn der Wert „true“ ist, zahlt das Werbesystem im Feld „ advertising_system_identifier“ den Verkäufer im Feld „seller_identifier“, der für die Bezahlung des vorherigen Knotens in der Kette verantwortlich ist. Ist sie auf „false“ gesetzt, ist dieser Knoten nicht an der Zahlung für das Inventar beteiligt.

BidResponse-Objekt

Dies ist die Nachricht, die Sie als Antwort auf eine Gebotsanfrage zurückgeben. Sie können keine oder mehrere Anzeigen angeben. Sie sollten für jede Anzeige eine Anzeigenfläche angeben, auf der die Anzeige ausgeliefert werden kann. Eine Anzeigenfläche wird durch den AdSlot.id aus der Gebotsanfrage identifiziert. Wenn Sie kein Gebot abgeben möchten, senden Sie eine Antwort ohne Anzeigen, für die nur processing_time_ms festgelegt ist.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
ad	repeated	Anzeige
debug_string	optional	String	Wenn in der Gebotsanfrage is_test festgelegt wurde, können Sie Debugging-Informationen in diesem Feld als Nur-Text zurückgeben. Legen Sie dieses Feld nicht unter normalen Bedingungen fest und legen Sie Werte für mehr als 100 Zeichen nicht fest. Sie sollten dieses Feld nur verwenden, wenn Sie dazu aufgefordert werden, um bestimmte Probleme zu beheben.
processing_time_ms	optional	int32	Setzen Sie diesen Wert auf die Verarbeitungszeit in Millisekunden vom Eingang der Anfrage bis zur Rückgabe der Antwort.
no_bid_reason	optional	int32	Ein optionaler, vom Bieter angegebener Grund, kein Gebot einzureichen. Dieses Feld entspricht BidResponse.nbr im OpenRTB-Protokoll und verwendet denselben Namespace der Gründe, aus denen keine Gebote abgegeben wurden. Unter developers.google.com/authorized-buyers/rtb/downloads/no-bid-reasons.txt finden Sie eine vollständige Liste der Gründe, aus denen keine Gebote abgegeben werden.

Anzeigenobjekt

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
event_notification_token	optional	Byte	Das Ereignisbenachrichtigungstoken wird zur Fehlerbehebung an Authorized Buyers gesendet. Das Token wird in Authorized Buyers in Echtzeit für das Gebot aufgenommen. Der Inhalt des Tokens wird von Authorized Buyers nicht protokolliert. In Authorized Buyers werden alle Tokens ignoriert, die länger als 128 Byte sind.
buyer_creative_id	optional	String	Eine eindeutige Kennung, die Sie für das Creative in dieser Antwort auswählen. Er muss immer festgelegt sein und darf höchstens 64 Byte enthalten. Außerdem muss ein gültiger UTF8-String vorhanden sein. Jede buyer_creative_id, die Sie verwenden, muss immer mit demselben Creative verknüpft sein. Dieses Feld wird verwendet, um den Genehmigungsstatus zu melden, wenn Probleme gefunden werden. Geben Sie nicht dieselbe ID für verschiedene Creatives an. Andernfalls werden alle Creatives abgelehnt, wenn ein Problem mit einem einzelnen Creative auftritt. Geben Sie keine unterschiedlichen IDs für dasselbe Creative in verschiedenen Antworten an. Sonst werden keine Creatives ausgeliefert, weil der Genehmigungsstatus auf ID-Basis zugewiesen wird.
html_snippet	optional	String	Das HTML-Snippet, das auf der Webseite platziert werden soll, um die Anzeige auszuliefern Geben Sie mit BidResponse.Ad.AdSlot.billing_id an, welcher Abrechnungs-ID dieses Snippet zugeordnet wird.
video_url	optional	String	Die URL zum Abrufen einer Videoanzeige. Die URL sollte eine XML-Antwort zurückgeben, die dem VAST 2.0- oder VAST 3.0-Standard entspricht. Geben Sie unter BidResponse.Ad.AdSlot.billing_id an, welcher Abrechnungs-ID diese Anzeige zugeordnet werden soll. Es sollte nur entweder html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url oder video_vast_xml festgelegt werden. Legen Sie dieses Feld nur fest, wenn die Gebotsanfrage die In-Video-Anzeige (BidRequest.video) enthält.
video_vast_xml	optional	String	Das VAST-Dokument, das zurückgegeben werden soll. Dieses Dokument muss dem VAST 2.0- oder VAST 3.0-Standard entsprechen. Verwenden Sie BidResponse.Ad.AdSlot.billing_id, um anzugeben, welcher Abrechnungs-ID diese Anzeige zugeordnet werden soll. Legen Sie dieses Feld nur fest, wenn die BidRequest für eine In-Video-Anzeige bestimmt ist und die Antwort VAST-XML ist. Es sollte nur entweder html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url oder video_vast_xml festgelegt werden.
amp_ad_url	optional	String	Die URL zum Abrufen einer AMPHTML-Anzeige. Es sollte nur einer der folgenden Werte festgelegt werden: html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url oder video_vast_xml.
native_ad	optional	NativeAnzeige	Der Content einer nativen Anzeige Native Anzeigen bestehen aus mehreren Bausteinen, die vom Publisher gerendert werden.
click_through_url	repeated	String	Eine Gruppe von Ziel-URLs für das Snippet. Dazu gehören die URLs, zu denen der Nutzer gelangt, wenn er auf die angezeigte Anzeige klickt, sowie alle URLs, die in der gerenderten Anzeige sichtbar sind. Binde keine Zwischenaufrufe an den Ad-Server ein, die nichts mit der endgültigen Landingpage zu tun haben. Diese Daten werden unter anderem zum Filtern von vom Publisher blockierten URLs verwendet. Eine BidResponse, die ein Snippet oder eine Videoanzeige zurückgibt, aber nicht click_through_url angibt, wird verworfen. Bei nativen Anzeigen wird nur der erste Wert als Klick-URL verwendet. Alle Werte unterliegen einer Kategorisierung und Überprüfung. Legen Sie dieses Feld nur fest, wenn html_snippet, video_url oder native_ad festgelegt sind. Wenn bei nativen Anzeigen NativeAd.click_link_url nicht festgelegt ist, wird der erste Wert von click_through_url verwendet, um den Nutzer auf die Landingpage zu leiten. Für native Anzeigen empfehlen wir, das Feld click_link_url als Ziel für die Seite zu verwenden, auf die der Nutzer letztendlich gelangt. Sie ist bei dynamischen Landingpages erforderlich.
vendor_type	repeated	int32	Alle Anbietertypen für die Anzeigen, die über dieses Snippet ausgeliefert werden können. Du solltest nur Anbieter-IDs angeben, die in der provider.txt-Datei in der technischen Dokumentation aufgeführt sind. Wir prüfen dann, ob die von Ihnen deklarierten Anbieter in der allowed_vendor_type-Liste enthalten sind, die in der BidRequest gesendet wird.
attribute	repeated	int32	Alle Attribute der Anzeigen, die über dieses Snippet ausgeliefert werden können. In der technischen Dokumentation finden Sie eine Liste der IDs in der Datei buyer-declarable-creative-attributes.txt. Wir prüfen, ob keines dieser Attribute in der BidRequest in der Liste excluded_attribute enthalten ist.
category	repeated	int32	Alle sensiblen Kategorien für die Anzeigen, die über dieses Snippet ausgeliefert werden können. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei ad-sensitive-categories.txt. Wir prüfen dann, ob keine dieser Kategorien in der excluded_sensitive_category-Liste in der BidRequest enthalten ist.
restricted_category	repeated	int32	Alle eingeschränkten Kategorien für die Anzeigen, die über dieses Snippet ausgeliefert werden können. Eine Liste der IDs findest du in der technischen Dokumentation in der Datei ad-restricted-categories.txt. Wir prüfen dann, ob diese Kategorien in der BidRequest in der Liste allowed_restricted_category aufgeführt sind.
advertiser_name	repeated	String	Alle Namen der Werbetreibenden.
bidder_name	optional	String	Bei Bietern, die Anzeigenplattform-Gebote nutzen, werden die Namen der Bieter genannt, die die Anzeigenplattform aufgerufen hat, um die Anzeige bereitzustellen. Dies ist ein beliebiger UTF8-Text, der jedoch zur Identifizierung des Bieters ausreichen sollte und auf denselben Wert für denselben Bieter gesetzt werden muss.
width height	optional	int32	Breite und Höhe der Anzeige in Pixeln Das ist optional. Diese müssen jedoch festgelegt werden, wenn bid BidRequest.AdSlot mehr als eine Breite und Höhe hat oder wenn BidRequest.Mobile.is_interstitial_request wahr ist.
agency_id	optional	int64	Die Agentur, die dieser Anzeige zugewiesen ist. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei agencies.txt. Wenn dieser Anzeige keine Agentur zugeordnet ist, sollte der Wert NONE (agency_id: 1) verwendet werden, anstatt dieses Feld leer zu lassen.
adslot	repeated	Anzeigenfläche
impression_tracking_url	repeated	String	Die URLs, die beim Rendern der Impression aufgerufen werden sollen. Dies wird für alle Inventartypen und alle Formate unterstützt.
click_tracking_url	repeated	String	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.
ad_choices_destination_url	optional	String	Link zur Seite mit den Anzeigenvorgaben. Diese Option wird nur für native Anzeigen unterstützt. Falls vorhanden, wird dem nativen Creative ein standardmäßiges Datenschutzinfo-Symbol hinzugefügt und mit dieser URL verknüpft.
impression_tracking_resource	repeated	ImpressionTrackingRessource	Ressourcen, die beim Rendern der Impression aufgerufen werden sollen. Dies wird nur für native und Banneranzeigenformate und nur für Skripts auf der Zulassungsliste unterstützt.
sdk_rendered_ad	optional	SdkRenderedAd	Eine Anzeige, die von einem dem Käufer bekannten SDK gerendert wird. Dieser Wert kann nur verwendet werden, wenn die BidRequest eine Unternachricht für mobile.installed_sdk enthält.
skadn	optional	SKAdNetworkResponse	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.
advertised_app_id	optional	String	ID der beworbenen App (nur bei App-Werbung). Unter Android sollte dies ein Bundle- oder Paketname wie com.foo.mygame sein. Unter iOS ist es eine numerische ID. Zusätzlich zu diesem Feld können Sie das Feld app_promotion_type unten festlegen, um die spezifischen Funktionen der App-Werbung zu nutzen.
app_promotion_type	optional	enum	Typ der App-Werbung, die der beworbenen App entspricht, die oben im Feld advertised_app_id angegeben ist. Wenn die beworbene App nicht angegeben ist, wird dieses Feld ignoriert. Wenn das Feld advertised_app_id ohne dieses Feld festgelegt wird, wird es so behandelt, als wäre das Feld auf OTHER gesetzt.

NativeAd-Objekt

Mutter/Vater

Der Content einer nativen Anzeige Native Anzeigen bestehen aus mehreren Bausteinen, die vom Publisher gerendert werden. Es sollte nur einer der folgenden Werte festgelegt werden: html_snippet, video_url, video_vast_xml oder native_ad. Legen Sie dieses Feld nur fest, wenn die BidRequest für eine native Anzeige verwendet wird (BidRequest.adslot.native ist vorhanden).

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
headline	optional	String	Ein kurzer Titel für die Anzeige.
body	optional	String	Eine ausführliche Beschreibung der Anzeige.
call_to_action	optional	String	Ein Label für die Schaltfläche, auf die der Nutzer klicken soll.
advertiser	optional	String	Der Name des Werbetreibenden oder Sponsors, der im Creative eingeblendet wird
image	optional	Bild	Ein großes Bild.
logo	optional	Bild	Ein kleineres Bild für das Logo des Werbetreibenden.
app_icon	optional	Bild	Das App-Symbol für App-Download-Anzeigen
video_url	optional	String	Die URL zum Abrufen einer Videoanzeige. Die URL sollte eine XML-Antwort zurückgeben, die dem VAST 2.0-Standard entspricht. Legen Sie dieses Feld nur fest, wenn die BidRequest für native Anzeigen vorgesehen ist und das Videofeld angefordert wird.
star_rating	optional	Doppelwert	App-Bewertung im App-Shop Muss im Bereich [0–5] liegen.
click_link_url	optional	String	Die URL, die vom Browser/SDK geladen wird, wenn der Nutzer auf die Anzeige klickt. Das kann die Landingpage direkt oder der erste Schritt einer Weiterleitungskette sein, die darauf verweist. Wenn dies nicht festgelegt ist, wird die erste Ad.click_through_url verwendet, wenn dies nicht festgelegt ist. Wir empfehlen, für native Anzeigen click_link_url anstelle von click_through_url zu verwenden.
click_tracking_url	optional	String	Veraltet. Die URL, die für das Klick-Tracking verwendet werden soll. Das SDK sendet eine Klick-Tracking-URL an einen Hintergrundthread. Beim Auflösen der URL werden HTTP-30x-Weiterleitungen berücksichtigt. Das SDK ignoriert den Inhalt der Antwort; diese URL hat keine Auswirkungen auf die Landingpage für den Nutzer.
price	optional	String	Der Preis der beworbenen App, einschließlich der Währungsinformationen

Bildobjekt

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
url	optional	String
width height	optional	int32	Die Bildbreite und -höhe werden in Pixeln angegeben. Sie können ein größeres Bild als angefordert angeben, solange das Seitenverhältnis beibehalten wird.

AdSlot-Objekt

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
id	erforderlich	int32	Die Slot-ID aus der BidRequest, in der die Anzeige erscheinen kann.
max_cpm_micros	erforderlich	int64	Der maximale CPM, der Ihnen in Rechnung gestellt werden soll, wenn Sie die Auktion für diese Anzeigenfläche gewinnen, ausgedrückt in Mikros der angegebenen currency oder der Standardwährung für Gebote. Wenn Sie beispielsweise einen CPM von 1, 29 € bieten möchten, legen Sie für „max_cpm_micros“ den Wert „1290000“ fest. Erfolgreiche Gebote werden auf abrechenbare Einheiten aufgerundet. In US-Dollar werden Gebote beispielsweise auf das nächste Vielfache von 10.000 Mikros (1 Cent) aufgerundet.
min_cpm_micros	optional	int64	Der minimale CPM, den Sie zahlen möchten, wenn Sie die Auktion für diese Anzeigenfläche gewinnen, ausgedrückt in Mikros der angegebenen currency oder der Standardgebotswährung. Dies kann ein zweiter Preis sein, wenn Sie max_cpm_micros als höchster von mehreren Geboten auswählen, oder ein beliebiger Mindestpreis, wenn Sie den vom Publisher festgelegten Mindestpreis überschreiben möchten. Das Gebot muss kleiner oder gleich max_cpm_micros sein, sonst wird es ignoriert. Dieses Feld ist optional und muss nicht festgelegt werden. Dieses Feld ist nicht relevant, wenn auf Gebotsanfragen mit FIRST_PRICE-Typ „auktion_type“ geantwortet wird.
billing_id	optional	int64	Die Abrechnungs-ID, der diese Impression zugeordnet werden soll. Der Wert muss sich auf die Abrechnungs-IDs dieses Slots beziehen, die im BidRequest.AdSlot.matching_ad_data.billing_id gesendet wurden. Er muss immer festgelegt werden, wenn die BidRequest mehr als eine BidRequest.AdSlot.matching_ad_data.billing_id hat.
deal_id	optional	int64	Die Deal-ID, an der dieses Gebot teilnehmen soll. Wenn kein Deal verfügbar ist, Sie ihn aber ignorieren und an der offenen Auktion teilnehmen möchten, setzen Sie ihn nicht oder legen Sie ihn auf „1“ fest.
exchange_deal_id	optional	String	Für Anzeigenplattform-Bieter (Anzeigenplattformen von Drittanbietern, die Echtzeitgebote über Ad Manager ausführen), ist die Deal-ID des Namespace der Anzeigenplattform, der mit diesem Gebot verknüpft ist, und wird Publishern angezeigt. Lassen Sie die Option leer, wenn kein Deal verknüpft ist. Dies ist ein beliebiger UTF8-Text und darf höchstens 64 Byte umfassen.
exchange_deal_type	optional	enum	Wenn exchange_deal_id festgelegt ist, der Dealtyp. Das wird den Publishern mitgeteilt und beeinflusst, wie der Deal in der Auktion behandelt wird. OPEN_AUCTION = 0 PRIVATE_AUCTION = 1 PREFERRED_DEAL = 2 EXCHANGE_AUCTION_PACKAGE = 3
buyer_reporting_id	optional	String	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.
third_party_buyer_token	optional	String	Token, das zur Identifizierung von Drittanbieterkäuferdaten verwendet wird, wenn eine Anzeigenplattform als offener Bieter ein Vermittler ist. Diese wird vom Drittanbieterkäufer erfasst und muss unverändert in der Gebotsantwort an Google übergeben werden.
frequency_cap	repeated	Frequency Capping	Die Testfunktion kann sich ändern. Weitere Informationen zum Test mit von Anzeigenplattformen erzwungenem Frequency Capping finden Sie unter github.com/google/ads-privacy/tree/master/experiments/frequency-capping. Wenden Sie sich an Ihren Account Manager, um das Frequency Capping für Ihr Konto zu aktivieren. Legt das Frequency Capping fest, das auf das Gebot angewendet wird. Die Impressionen für jeden Nutzer werden auf das durch Frequency_Cap_ID angegebene Level beschränkt. Ein Gebot nimmt nicht an der Auktion teil, wenn eine zusätzliche Impression für den Nutzer gegen eine der festgelegten Obergrenzen verstoßen würde. Für dieselbe Frequency_Cap_id können mehrere Frequency Cappings angegeben werden. Ein Gebot wird vor der Auktion herausgefiltert, wenn das Frequency Capping fehlerhaft ist. Beispiele für Fälle, in denen das Frequency Capping fehlerhaft ist: Frequency_Cap_ID ist leer oder sehr lang „max_mpressions“ oder „time_range“ sind nicht positiv Für ein einzelnes Gebot gibt es eine große Anzahl von Frequency Capping-Werten. „time_unit“ ist nicht angegeben. Wenn ein nachfolgendes Gebot mit derselben „frequency_cap_id“ eine andere Dauer (durch „time_unit“ und „time_range“ dargestellt) verwendet, werden Impressionen, die mit der bisherigen Häufigkeitsbegrenzung erfasst wurden, nicht auf die neue und die umgekehrte Zeit angerechnet.
currency	optional	String	Die Währung, die von max_cpm_micros und min_cpm_micros unter Verwendung von ISO-4217-Alphacodes verwendet wird. 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 billing_id der Gebotsantwort 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.

FrequencyCap-Objekt

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
frequency_cap_id	optional	String	Eine ID, die den Anwendungsfall eines Bieters für das Frequency Capping darstellen kann, z. B. für die Kampagne, die Anzeige oder die Werbebuchung. Sie darf keine nutzerspezifischen Informationen oder IDs enthalten.
time_unit	optional	enum	Die Zeiteinheiten, für die das Frequency Capping erzwungen werden kann. UNKNOWN_TIME_UNIT = 0 MINUTE = 1 DAY = 2 WEEK = 3 MONTH = 4 INDEFINITE = 5: Wenn INDEFINITE verwendet wird, wird „time_range“ ignoriert. INDEFINITE bedeutet, dass das Frequency Capping über einen längeren Zeitraum (länger als einen Monat) angewendet wird, aber nicht unbedingt für immer.
time_range	optional	int32	Die Länge des Zeitfensters in in „time_unit“ angegebenen Einheiten, für die das Frequency Capping gilt. Wenn „time_unit=WEEK“ und „time_range=3“ beispielsweise angewendet werden, wird das Frequency Capping für einen Zeitraum von drei Wochen angewendet. Wenn „time_unit=INDEFINITE“ gilt, wird das ignoriert.
max_impressions	optional	int32	Die maximale Anzahl von Impressionen, die einem Nutzer für die angegebene „frequency_cap_id“ innerhalb des durch „time_unit“ und „time_range“ beschriebenen Zeitraums angezeigt werden darf.

ImpressionTrackingResource-Objekt

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
script_url	optional	String	Die URL einer JavaScript-Ressource. Die URLs dürfen keine Skript-Tags enthalten. Beispiel: „https://mycdn.com/tracker.js“.
context	repeated	enum	Zusätzlicher Kontext für das Rendering angegeben UNKNOWN_CONTEXT = 0 OMID = 1
verification_parameters	optional	String	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	optional	String	Wird verwendet, um den Anbieter des Überprüfungsskripts eindeutig zu identifizieren.

SdkRenderedAd-Objekt

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
id	optional	String	Die ID für das SDK, das die Anzeige rendert. Muss mit einem mobile.installed_sdk.id übereinstimmen, der in der entsprechenden Gebotsanfrage gesendet wurde.
rendering_data	optional	String	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	optional	DelcaredAd-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_ad fest.

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_ad fest.

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
html_snippet	optional	String	Das HTML-Snippet, das die vom SDK gerenderte Anzeige repräsentiert.
video_url	optional	String	Das ist die URL des VAST-Assets, das in der vom SDK gerenderten Anzeige verwendet wird.
video_vast_xml	optional	String	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_ad	optional	NativeAd	Der Content einer nativen Anzeige Native Anzeigen bestehen aus mehreren Bausteinen, die vom Käufer-SDK gerendert werden.
click_through_url	optional	String	Die endgültigen Landingpages der vom SDK gerenderten Anzeige.

SKAdNetworkResponse-Objekt

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
version	optional	String	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.mobile.skad.versions übereinstimmen.
network	optional	String	Die ID des Werbenetzwerks, die in der Signatur verwendet wird. Dies sollte mit einem der Elemente in BidRequest.mobile.skad.skadnetids übereinstimmen.
campaign	optional	int64	Die Kampagnen-ID ist mit den Spezifikationen von Apple kompatibel. Wird in SKAdNetwork 3.0 und niedriger verwendet. Das Feld BidResponse.ad.skad.source_identifier wurde in SKAdNetwork 4.0 und höher ersetzt.
source_identifier	optional	int64	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.ad.skad.campaign.
itunesitem	optional	String	ID der App des Werbetreibenden im App-Shop von Apple.
product_page_id	optional	String	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	repeated	Zuverlässigkeit	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	optional	String	Eine eindeutige UUID in Kleinbuchstaben, die vom Werbetreibenden zum Generieren der Signatur generiert wird. Hinweis: Dieses Feld wird zugunsten des Felds BidResponse.ad.skadn.fidelities.nonce verworfen, um mehrere Fidelity-Typen zu unterstützen.
sourceapp	optional	String	ID der App des Publishers im App Store von Apple. Sie sollte mit der ID aus „BidRequest.mobile.skad.sourceapp“ übereinstimmen.
timestamp	optional	int64	Die Unix-Zeit in Millisekunden wird zum Zeitpunkt der Signaturgenerierung verwendet. Hinweis: Dieses Feld wird zugunsten des Felds BidResponse.ad.skadn.fidelities.timestamp verworfen, um mehrere Fidelity-Typen zu unterstützen.
signature	optional	String	SKAdNetwork-Signatur wie von Apple angegeben. Hinweis: Dieses Feld wird zugunsten des Felds BidResponse.ad.skadn.fidelities.signature eingestellt, um mehrere Typen von Fidelity zu unterstützen.
skoverlay	optional	SKOverlay-Objekt	Mit diesen Optionen wird angegeben, wie SKOverlay in der beworbenen App empfohlen wird. Wird unter iOS 14 und höher unterstützt.

Fidelity-Objekt

Mutter/Vater

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.

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
fidelity_type	optional	enum	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 dem 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 über die von StoreKit gerenderte Produktseite im App Store initiiert werden, die auf Anzeigenklicks zurückzuführen ist. Wird für alle SKAdNetwork-Versionen unterstützt. Weitere Informationen finden Sie in diesem Artikel.
nonce	optional	String	Eine eindeutige UUID in Kleinbuchstaben, die vom Werbetreibenden zum Generieren der Signatur generiert wird.
timestamp	optional	int64	Die Unix-Zeit in Millisekunden wird zum Zeitpunkt der Signaturgenerierung verwendet.
signature	optional	String	SKAdNetwork-Signatur wie von Apple angegeben.

SKOverlay

Mutter/Vater

Attribut	Erforderlich/Optional	Typ	Implementierungsdetails
delay_seconds	optional	int32	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.
endcard_delay_seconds	optional	int32	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 endcard_delay_seconds festgelegt ist, wird das Overlay automatisch geschlossen, wenn die Anzeige endet, und nach der Wiedergabe des Endbildes noch einmal angezeigt.
dismissible	optional	bool	Gibt an, ob das Overlay vom Nutzer geschlossen werden kann. Der Standardwert ist „true“.