Protokoll für Echtzeitgebote in Authorized Buyers

In diesem Leitfaden werden die einzelnen Felder des Proto-Protokolls für Echtzeitgebote in Authorized Buyers (Version 276) beschrieben.Außerdem finden Sie zusätzliche Tipps und Informationen zur Implementierung.

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:
  1. iOS-Geräte (wird in diesem Hilfeartikel als IDFA (Identifier for Advertising) bezeichnet))
  2. Android-Geräte
  3. Roku-Geräte
  4. Microsoft Xbox-Geräte
  5. 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.
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:

    1. Die Währung auf Bieterebene, falls in den Einstellungen für Echtzeitgebote konfiguriert.
    2. 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“.