In diesem Leitfaden werden die einzelnen Felder des Protokolls „Real-Time Bidding“ in Authorized Buyers (Version 288) sowie zusätzliche Tipps und Informationen zur Implementierung beschrieben.
Weitere Informationen finden Sie in der Protokolldatei für Echtzeitgebote in Authorized Buyers.
BidRequest-Objekt
Dies ist die Nachricht, die Google zur Anforderung von Geboten verwendet. Eine BidRequest enthält die Anzeigenfläche aus einer einzelnen Impression.
In diesem Abschnitt werden Informationen über den Nutzer aufgeführt.
Informationen zur Webseite oder App, von der die Impression stammt.Attribut | Erforderlich/Optional | Typ | Implementierungsdetails |
---|---|---|---|
id |
erforderlich | Byte | Von Google generierte eindeutige Anfrage-ID. Sie ist 16 Byte lang. |
ip |
optional | Byte | Die ersten 3 Byte der IP-Adresse in Netzwerk-Byte-Reihenfolge für IPv4 oder die ersten 6 Byte für IPv6. Beachten Sie, dass sich die Anzahl und Position der Byte von IPv6-Adressen später ändern können. |
user_data_treatment |
repeated | enum | Wenn „user_data_treatment“ festgelegt ist, werden die Cookie-/ID-Daten des Nutzers aus der Anfrage gelöscht und nicht in den Callouts gesendet. Die betroffenen Felder sind:
|
google |
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 |
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 |
optional | int32 | Die Zeit in Sekunden, seit google_user_id erstellt wurde.
Diese Zahl kann quantisiert werden.
|
hosted |
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 |
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 |
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 |
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
|
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 |
optional | Byte | Verschlüsselte hyperlokale Ausrichtungssignale |
hyperlocal |
optional | HyperlocalSet | Unverschlüsselte Version von encrypted_hyperlocal_set . Dieses Feld wird nur festgelegt, wenn Sie eine SSL-Verbindung verwenden.
|
timezone |
optional | int32 | Die Abweichung der Nutzerzeit in GMT in Minuten. GMT+10 ist beispielsweise timezone_offset = 600 .
|
user |
repeated | Zusatzliste | |
publisher |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 .
|
device |
optional | Gerät | |
key |
repeated | Schlüssel/Wert-Paar | |
mobile |
optional | Mobil | |
video |
optional | Video | |
publisher |
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 |
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 .
|
page |
optional | enum | Der Sichtbarkeitsstatus der Webseite, die die Anzeigenflächen enthält. Weitere Informationen finden Sie unter www.w3.org/TR/page-sichtbarkeit/.
|
adslot |
repeated | Anzeigenfläche | |
bid |
repeated | Feedback für Gebotsantworten | |
response |
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 |
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/VaterAttribut | 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.
|
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/VaterEin 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 |
optional | Hyperlokal |
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/VaterUngefä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/VaterEin 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 .
|
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 |
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 |
optional | int32 | Breite des Gerätebildschirms in Pixeln |
screen |
optional | int32 | Höhe des Gerätebildschirms in Pixeln |
screen |
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 = |
screen |
optional | enum | Die Bildschirmausrichtung des Geräts beim Senden der Anzeigenanfrage.
Standardwert = UNKNOWN_ORIENTATION .
|
hardware |
optional | String | Apple iOS-Gerätemodell, z. B. „iPhone 5S“, „iPhone 6+“, „ipad 4“. |
limit_ad |
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 |
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.
|
OsVersion-Objekt
Mutter/VaterEnthä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
|
optional | int32 |
Schlüssel/Wert-Objekt
Zusätzliche Schlüssel/Wert-Paar-Attribute. Derzeit nicht verwendet.
Attribut | Erforderlich/Optional | Typ |
---|---|---|
key
|
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 |
optional | bool | Bei "true" handelt es sich um eine Vollbildanzeige für Mobilgeräte. |
app |
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 |
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 |
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 |
optional | Byte | Dieses Feld wird für Werbe-IDs verwendet für:
Wenn |
encrypted |
optional | Byte | Weitere Informationen finden Sie in der Beschreibung zu „encrypted_advertising_id “.
|
advertising |
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 |
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 |
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 |
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/VaterIdentifizierung 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/VaterSemantische 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/VaterSKAdNetwork-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.
|
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 .
|
description |
optional | String | Die URL der Seite, die der Publisher Google zur Beschreibung des Videocontents zur Verfügung stellt, wobei Parameter entfernt werden. |
is |
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 =
|
is |
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 |
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 |
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 |
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 |
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 |
optional | enum | Lässt der Publisher überspringbare Videoanzeigen zu? Standardwert = ALLOW_SKIPPABLE .
|
skippable |
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.
|
allowed |
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 |
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.
|
content |
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 |
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.
|
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/VaterInformationen 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 |
repeated | enum | Das sind die Formate der Creatives, die auf dieser Companion-Anzeigenfläche zulässig sind.
|
ContentAttributes-Objekt
Mutter/VaterAttribute 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 |
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 |
optional | uint64 | Eine stabile Kennung für die Kombination aus Publisher, Anzeigenfläche und Seite. |
targetable |
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
|
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 |
optional | FlexibleAdSlotSettings | Wenn die Anzeigenfläche flexibel ist, enthält sie Einstellungen zur Größenanpassung der Anzeigenfläche. |
excluded |
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 |
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 |
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. |
excluded |
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 |
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 |
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 |
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 |
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 |
repeated | MatchingAdData | Informationen zu passenden Pre-Targeting-Konfigurationen. |
exchange |
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 |
optional | OpenBidding | Die Parameter werden in allen Open Bidding-Anfragen gesendet. |
ad_unit |
optional | AdUnitMapping | Anzeigenblockzuordnungen, die der angegebenen Anzeigenfläche entsprechen. |
dfp_ad |
optional | String | Der Ad Manager-Anzeigenblockcode Diese Einstellung wird derzeit nur für Open Bidding-Anfragen festgelegt. |
slot |
optional | enum | Sichtbarkeitsinformationen für die Anzeigenfläche. Standardwert = NO_DETECTION .
|
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 |
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 |
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 |
optional | enum | iFraming-Status der Anzeigenfläche auf der Webseite, auf der sie vorhanden ist
Standardwert = UNKNOWN_IFRAME_STATE .
|
iframing |
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 .
|
native |
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 |
optional | enum | Beschreibt die Platzierung der nativen Anzeigenfläche in Bezug auf den Kontext.
|
mediation |
optional | enum | Ob die Anzeigenanfrage direkt vom Publisher stammt Standardwert = UNKNOWN .
|
auto |
optional | Automatisch aktualisieren | |
sticky |
optional | Fixierte Einstellungen | |
non |
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 .
|
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.
|
amp_ad |
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 .
|
is |
optional | enum | Gibt an, ob es eine AMP-Seite ist oder nicht.
|
amp_ad |
optional | enum | Mögliche Typen von AMP-Anzeigen
|
is |
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 |
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.
|
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 |
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 | Sichere |
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:
|
billable_event |
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.
|
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/VaterEinstellungen 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/VaterInformationen 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/VaterEin 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/VaterDie 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 |
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 |
repeated | DirectDeal |
DirectDeal-Objekt
Mutter/VaterInformationen zu Deals, die für dieses Inventar übereinstimmen.
Attribut | Erforderlich/Optional | Typ | Implementierungsdetails |
---|---|---|---|
direct |
optional | int64 | Eine ID zur Identifizierung des Deals. |
fixed |
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 .
|
publisher |
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.
|
must |
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/VaterParameter 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 |
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/VaterDie 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/VaterAdUnitMapping 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:
|
Keyval-Objekt
Mutter/VaterEs 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/VaterEine 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_ |
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.
HEADLINE = 0x1
|
recommended |
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.
HEADLINE = 0x1
|
headline_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
|
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 |
optional | enum | Typ des Designlayouts für jede native Anzeigenvorlage. Standardwert = PIXEL .
|
style_height
|
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/VaterEinstellungen für die automatische Aktualisierung.
Attribut | Erforderlich/Optional | Typ | Implementierungsdetails |
---|---|---|---|
refresh |
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 |
optional | int32 | Die Häufigkeit, mit der diese Anzeigenfläche seit dem letzten Seitenaufbau aktualisiert wurde. |
AutoRefreshSettings-Objekt
Mutter/VaterAttribut | Erforderlich/Optional | Typ | Implementierungsdetails |
---|---|---|---|
refresh |
optional | enum | Der Typ der deklarierten automatischen Aktualisierung. Standardwert = UNKNOWN_AUTO_REFRESH_TYPE .
|
min |
optional | int32 | Das minimale Aktualisierungsintervall. Dies gilt für alle Aktualisierungsarten. |
StickySettings-Objekt
Mutter/Vatervom Publisher deklarierte fixierte Einstellungen.
Attribut | Erforderlich/Optional | Typ | Implementierungsdetails |
---|---|---|---|
vertical |
optional | enum | Gibt an, ob die Anzeigenfläche eine Seitenleiste ist, die beim Scrollen des Nutzers auf dem Bildschirm erscheint. Standardwert = UNKNOWN_STICKINESS .
|
top |
optional | enum | Gibt an, ob die Anzeigenfläche eine horizontale Fläche ist, die beim Scrollen
oben auf dem Bildschirm erscheint. Standardwert = UNKNOWN_STICKINESS .
|
bottom |
optional | enum | Gibt an, ob die Anzeigenfläche eine horizontale Anzeigenfläche ist, die beim Scrollen am unteren Bildschirmrand fixiert bleibt. Standardwert = UNKNOWN_STICKINESS .
|
SecureSignal-Objekt
Mutter/VaterVom 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/VaterVeraltet. 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 |
optional | Byte | Die eindeutige ID aus BidRequest.id |
creative |
optional | int32 | Index von BidResponse_Ad , wenn es mehr als einen gibt.
Der Index des ersten Creatives beginnt bei null.
|
creative |
optional | int32 | Der Statuscode der Anzeige. Eine Liste der IDs finden Sie in der technischen Dokumentation in der Datei creative-status-codes.txt. |
cpm |
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 |
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 |
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 |
optional | Byte | Ereignisbenachrichtigungstoken, das in der Gebotsantwort enthalten war. |
buyer |
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/VaterAttribut | 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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
optional | NativeAnzeige | Der Content einer nativen Anzeige Native Anzeigen bestehen aus mehreren Bausteinen, die vom Publisher gerendert werden. |
click |
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 |
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 |
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 |
repeated | String | Alle Namen der Werbetreibenden. |
bidder |
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
|
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 |
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 |
repeated | String | Die URLs, die beim Rendern der Impression aufgerufen werden sollen. Dies wird für alle Inventartypen und alle Formate unterstützt. |
click |
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 |
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 |
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/VaterDer 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 |
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 |
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 |
optional | Doppelwert | App-Bewertung im App-Shop Muss im Bereich [0–5] liegen. |
click |
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 |
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/VaterAttribut | Erforderlich/Optional | Typ | Implementierungsdetails |
---|---|---|---|
url |
optional | String | |
width
|
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/VaterAttribut | Erforderlich/Optional | Typ | Implementierungsdetails |
---|---|---|---|
id |
erforderlich | int32 | Die Slot-ID aus der BidRequest, in der die Anzeige erscheinen kann. |
max_cpm |
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 |
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 |
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 |
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 |
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.
|
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: Wenn ein nachfolgendes Gebot mit derselben „frequency_cap_id“ eine andere Dauer (durch „time_unit“ und „time_range“ dargestellt) verwendet, werden Impressionen, die mit der bisherigen Häufigkeitsbegrenzung erfasst wurden, nicht auf die neue und die umgekehrte Zeit angerechnet. |
currency |
optional | String | Die Währung, die von max_cpm_micros und min_cpm_micros unter Verwendung von ISO-4217-Alphacodes verwendet wird. Wenn dieses Feld ausgefüllt ist, wird die angegebene Währung verwendet, um das Gebot zu interpretieren. Andernfalls wird die Standardgebotwährung verwendet, die in der folgenden Priorität bestimmt wird:
Die Währung eines Käuferkontos wird bei der Kontoerstellung festgelegt und kann durch einen Technical Account Manager überprüft werden. |
FrequencyCap-Objekt
Mutter/VaterAttribut | 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.
|
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/VaterAttribut | 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
|
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/VaterAttribut | 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.
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/VaterAttribut | 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/VaterDie 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 .
|
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/VaterAttribut | 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“. |