Anfrage verarbeiten
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Eine Echtzeitgebotsinteraktion beginnt, wenn Google eine Gebotsanfrage an Ihre Anwendung sendet. In diesem Leitfaden wird erläutert, wie Sie Ihre Anwendung so programmieren, dass sie die Gebotsanfrage verarbeitet.
Anfrage parsen
Google sendet eine Gebotsanfrage, die entweder im OpenRTB-JSON- oder im Protobuf-Format serialisiert ist und als Nutzlast einer HTTP-POST-Anfrage angehängt wird. Das empfangene Format hängt von der Konfiguration Ihres Endpunkts ab. Ein Beispiel finden Sie unter Beispiel für eine Gebotsanfrage.
Sie müssen diese Anfrage parsen, um die serialisierte BidRequest zu erhalten. Wenn Sie das Protobuf-Format verwenden, müssen Sie openrtb.proto und openrtb-adx.proto von der Seite Referenzdaten herunterladen und damit eine Bibliothek generieren, mit der die BidRequest-Nachricht geparst werden kann. Der folgende C++-Code parst beispielsweise eine Anfrage mit einer POST-Nutzlast in einem String:
Sobald Sie die BidRequest haben, können Sie sie als Objekt verwenden und die benötigten Felder extrahieren und interpretieren. In C++ könnte das Durchlaufen von Deals in einem OpenRTB-`BidRequest` beispielsweise so aussehen:
Sie erhalten eine Gebotsanfrage, wenn das Anzeigeninventar eines Publishers von einer oder mehreren Ihrer Pre-Targeting-Konfigurationen angesprochen wird. BidRequest.imp.ext.billing_id wird mit den Abrechnungs-IDs aller berechtigten Käufer und den relevanten Pre-Targeting-Konfigurationen gefüllt. Außerdem können Sie für Dealinventar die Abrechnungs-IDs der relevanten Käufer mit BidRequest.imp.pmp.deal.ext.billing_id abrufen. Bei der Abgabe eines Gebots können nur Abrechnungs-IDs von Käufern angegeben werden, die in der Gebotsanfrage enthalten sind.
Wenn in der Gebotsanfrage mehrere Abrechnungs-IDs enthalten sind, müssen Sie im Feld BidResponse.seatbid.bid.ext.billing_id die Abrechnungs-ID des Käufers angeben, dem Sie Ihr Gebot zuordnen möchten.
imp {
ext {
// The billing IDs of all of your matching pretargeting configs and eligible child seats are
// stored in a flat list here.
billing_id: 123
billing_id: 456
billing_id: 789
}
pmp {
// All eligible deals are stored in a single flat list.
deal {
id: 1000
ext {
// The specific billing IDs eligible to bid on this deal are indicated here.
billing_id: 789
}
...
}
deal {
id: 2000
ext {
billing_id: 123
billing_id: 456
}
...
}
}
...
}
...
Blockierte Kategorien ermitteln
Wenn Sie ein Gebot abgeben, darf das enthaltene Creative keine Kategorien enthalten, die vom Publisher blockiert wurden. Andernfalls wird das Gebot aus der Auktion herausgefiltert.
Die blockierten Kategorien für eine Impression finden Sie im Feld BidRequest.bcat, das mit Kategorien aus der für Ihr Konto konfigurierten Taxonomie gefüllt ist.
Das folgende Beispiel zeigt blockierte Kategorien basierend auf einer konfigurierten Taxonomie für Anzeigenkategorien:
Version 1.0 der IAB-Taxonomie für Inhalte
// Bid request{// Indicates the blocked categories using IAB Content 1.0 Taxonomy."bcat":["IAB9-9",// Cigars"IAB8-18"// Wine]"imp":{...}}
Google-Taxonomie für Anzeigenkategorien
// Bid request{// Indicates the blocked categories using Google Ad Category Taxonomy."bcat":["10138",// Cigar and tobacco collecting"10080",// Tobacco"11649",// Wine"10674",// Wine collecting"13008"// Wine clubs]"imp":{...}}
Kontextbezogene Kategorien bestimmen
Gebotsanfragen können Felder für kontextbezogene Kategorien enthalten, die die Website oder App beschreiben, auf der eine Impression erfolgt. In diesen Feldern werden auch Taxonomien für Anzeigenkategorien verwendet. Sie stellen jedoch den Kontext der Impression dar und nicht die Einschränkungen für das Creative. Diese Felder verwenden möglicherweise nicht dieselbe Taxonomie wie das Feld BidRequest.bcat. Diese Kontextkategorien können von Google oder dem Publisher bereitgestellt werden. Die Verwendung von Kontextkategorien kann die Bewertung von Impressionen, das Kontext-Targeting und die Markensicherheit verbessern.
Von Google erkannte Kontextkategorien
Google füllt die folgenden Felder mit erkannten IAB-Inhaltskategorien für die Website, App oder Seite aus:
Feld
Beschreibung
BidRequest.site.cat
Ein Array von Inhaltskategorie-IDs, die die Website beschreiben.
BidRequest.site.pagecat
Ein Array von Inhaltskategorie-IDs, die die aktuelle Seite oder Ansicht der Website beschreiben.
BidRequest.app.cat
Ein Array von Inhaltskategorie-IDs, die die App beschreiben.
BidRequest.app.pagecat
Ein Array von Inhaltskategorie-IDs, die die aktuelle Seite oder Ansicht der App beschreiben.
Die genaue Taxonomie, die für diese Felder für eine bestimmte Gebotsanfrage verwendet wird, finden Sie in den Feldern BidRequest.site.cattax oder BidRequest.app.cattax. Kontextbezogene Kategoriefelder werden aufgrund von Publisher-Einstellungen oder regulatorischen Bedenken möglicherweise nicht immer ausgefüllt.
Weitere Informationen finden Sie unter Kontextbezogene OpenRTB-Kategorien in Google Ad Manager.
Vom Publisher bereitgestellte Signale
Zusätzlich zu den von Google erkannten Kontextkategorien können Gebotsanfragen auch vom Publisher bereitgestellte Signale enthalten, die ebenfalls den Kontext einer Impression beschreiben. Im Gegensatz zu den von Google erkannten Kontextkategorien werden diese Signale nur dann ausgefüllt, wenn sie vom Publisher bereitgestellt werden. Diese Signale werden in den Objekten BidRequest.site.content und BidRequest.app.content gesendet, z. B. content.data.segment und content.genre. Die für content.data.segment-Einträge verwendete Taxonomie wird in content.data.ext.segtax angegeben. Weitere Informationen finden Sie unter Vom Publisher bereitgestellte Signale (PPS, Publisher Provided Signals) für Echtzeitgebote (RTB, Real-time Bidding).
Wörterbuchdateien
In der Gebotsanfrage werden Kennungen verwendet, die in Wörterbuchdateien definiert sind. Diese sind auf der Seite Referenzdaten verfügbar.
Bieter-URL-Makros
Optional können einige Informationen aus dem BidRequest mithilfe von Makros in die URLs des Gebotsendpunkts eingefügt werden. Wenn Sie eine Endpunkt-URL mit einem oder mehreren Makros konfigurieren, werden diese erweitert, wenn die entsprechenden Informationen in der Gebotsanfrage vorhanden sind. Das kann beispielsweise nützlich sein, wenn Sie Load Balancing basierend auf Informationen im BidRequest durchführen möchten.
Wenden Sie sich an Ihren Account Manager, um Unterstützung für neue Makros anzufordern.
Macro
Beschreibung
%%GOOGLE_USER_ID%%
Ersetzt durch die Google-Nutzer-ID in BidRequest.user.id. Beispielsweise wird die Bieter-URL http://google.bidder.com/path?gid=%%GOOGLE_USER_ID%% bei der Anfrage durch etwas wie http://google.bidder.com/path?gid=dGhpyBhbiBleGFtGxl ersetzt.
Wenn die Google-Nutzer-ID unbekannt ist, wird der leere String ersetzt. Das Ergebnis sieht dann so aus:
http://google.bidder.com/path?gid=
%%HAS_MOBILE%%
Wird durch 1 ersetzt, um anzugeben, dass die Gebotsanfrage von einem Mobilgerät stammt, andernfalls durch 0. Dies basiert auf dem Wert von BidRequest.device.devicetype, wobei Mobilgeräte durch HIGHEND_PHONE (4) oder Tablet (5) gekennzeichnet sind.
%%HAS_VIDEO%%
Wird durch 1 ersetzt, um anzugeben, dass die Gebotsanfrage Videoinventar enthält, andernfalls durch 0. Dies hängt davon ab, ob BidRequest.imp.video in der Gebotsanfrage ausgefüllt ist.
%%IS_CTV%%
Wird durch 1 ersetzt, um anzugeben, dass die Gebotsanfrage von einem CTV-Gerät stammt, andernfalls durch 0. Dies basiert auf dem Wert von BidRequest.device.devicetype. In Protobuf sind CTV-Geräte CONNECTED_TV, CONNECTED_DEVICE oder SET_TOP_BOX, was in JSON den Ganzzahlwerten 3, 6 oder 7 entspricht.
%%HOSTED_MATCH_DATA%%
Ersetzt durch einen Wert, der auf BidRequest.user.buyeruid basiert.
%%MOBILE_IS_APP%%
Wird durch 1 ersetzt, um anzugeben, dass sich die Gebotsanfrage auf Inventar für mobile Apps bezieht, andernfalls durch 0. Dies hängt davon ab, ob BidRequest.app ausgefüllt ist.
ID einer mobilen App über die Transaktions-URL ermitteln
Bei Transaktionen in mobilen Apps werden URLs wie die folgenden angezeigt:
mbappgewtimrzgyytanjyg4888888.com
Verwenden Sie einen Base32-Decoder, um den fett formatierten Teil des Strings (gewtimrzgyytanjyg4888888) zu decodieren.
Sie können einen Online-Decoder verwenden, müssen aber die Buchstaben großschreiben und nachfolgende 8-Werte durch =-Werte ersetzen.
So decodieren Sie diesen Wert:
GEWTIMRZGYYTANJYG4======
ergibt:
1-429610587
Der String 429610587 ist die App-ID für die iOS-App iFunny.
Ein weiteres Beispiel: Die gemeldete URL lautet:
mbappgewtgmjug4ytmmrtgm888888.com
Wert decodieren:
GEWTGMJUG4YTMMRTGM======
ergibt:
1-314716233
Das Ergebnis 314716233 ist die App-ID für die iOS-App TextNow.
Name der mobilen App anhand der Transaktions-URL ermitteln
Hier ein Beispiel für das Abrufen des App-Namens: Die gemeldete URL lautet:
Das Ergebnis entspricht der Android-App slither.io.
Open Bidding-Felder
Gebotsanfragen, die an Exchange- und Netzwerkbieter gesendet werden, die an Open Bidding teilnehmen, ähneln denen von Authorized Buyers, die an standardmäßigen Echtzeitgeboten teilnehmen. Open Bidding-Kunden erhalten eine kleine Anzahl zusätzlicher Felder und einige vorhandene Felder können alternativ verwendet werden. Dazu gehören:
OpenRTB
Details
BidRequest.imp.ext.dfp_ad_unit_code
Enthält den Ad Manager-Netzwerkcode des Publishers, gefolgt von der Anzeigenblockhierarchie, getrennt durch Schrägstriche.
Beispiel für die Formatierung: /1234/cruises/mars.
BidRequest.user.data.segment
Wiederholte Schlüssel/Wert-Paare, die vom Publisher an den Anzeigenplattform-Bieter gesendet werden.
Sie können festlegen, dass die Werte Schlüssel/Wert-Paare sind, die vom Publisher gesendet werden, wenn BidRequest.user.data.name auf “Publisher Passed” gesetzt ist.
Zulässige Anbieter deklarieren
Technologieanbieter, die Dienste wie Marktforschung, Remarketing und Ad Serving anbieten, können bei der Interaktion zwischen Käufern und Verkäufern eine Rolle spielen. Es sind nur Anbieter zulässig, die von Google für die Teilnahme an Authorized Buyers-Interaktionen geprüft wurden.
Um die BidRequest zu verstehen und die BidResponse zu erstellen, müssen Sie die beiden verschiedenen Möglichkeiten zur Deklaration von Technologieanbietern kennen:
Andere Anbieter können nur teilnehmen, wenn sie in der BidRequest deklariert sind:
Im BidRequest gibt das Feld BidRequest.imp.ext.allowed_vendor_type an, welche Anbieter der Verkäufer zulässt. Anbieter, die im allowed_vendor_type gesendet werden, sind in der Wörterbuchdatei vendors.txt aufgeführt.
Beispiel einer Gebotsanfrage
Die folgenden Beispiele zeigen menschenlesbare Beispiele für Protobuf- und JSON-Anfragen.
Wenn Sie die Gebotsanfrage in ein Binärformat konvertieren möchten, wie Sie es bei einer echten Anfrage aus der POST-Nutzlast erhalten würden, können Sie Folgendes tun (in C++). Beachten Sie jedoch, dass dies nicht für OpenRTB JSON gilt.
Echtzeit-Feedback ist für Authorized Buyers sowie für Anzeigenplattformen und Netzwerke verfügbar, die Open Bidding verwenden.
Echtzeit-Feedback wird in BidRequest.ext.bid_feedback basierend auf dem Ergebnis eines oder mehrerer Gebote, die Sie zuvor abgegeben haben, eingefügt. Es kann verwendet werden, um Details wie den Gewinn der Auktion oder das Mindestgebot, das für den Gewinn der Auktion erforderlich gewesen wäre, zu ermitteln. Wenden Sie sich an Ihren Account Manager, um Echtzeit-Feedback zu aktivieren.
Zusätzlich zu den Standardfeldern, die im Feedback zur Gebotsantwort gesendet werden, können Sie mit dem Feld BidResponse.seatbid.bid.ext.event_notification_token auch benutzerdefinierte Daten in der Gebotsantwort senden. event_notification_token sind beliebige Daten, die nur dem Bieter bekannt sind und die beispielsweise bei der Fehlerbehebung helfen können: eine neue Targeting-ID oder Gebots-ID, die eine neue Taktik darstellt, oder Metadaten, die mit dem Creative verknüpft sind und nur dem Bieter bekannt sind. Weitere Informationen finden Sie in der Datei für den OpenRTB-Erweiterungsprotokollzwischenspeicher.
Wenn Authorized Buyers eine Gebotsanfrage an einen Bieter sendet, antwortet der Bieter mit einer BidResponse. Wenn der Bieter Echtzeit-Feedback aktiviert hat, sendet Authorized Buyers in einer nachfolgenden Gebotsanfrage Feedback zur Antwort in einer BidFeedback-Nachricht:
messageBidFeedback{//TheuniqueidfromBidRequest.id.optionalstringrequest_id=1;//Thestatuscodeforthead.Seecreative-status-codes.txtinthe//technicaldocumentationforalistofids.optionalint32creative_status_code=2;//Deprecated.ThisfieldisnotpopulatedandwillberemovedafterMarch,//2025.Ifthebidwontheauction,thisisthepricepaidinyouraccount//currency.Ifthebidparticipatedintheauctionbutwasout-bid,this//istheCPMthatshouldhavebeenexceededinordertowin.Thisisnot//setifthebidwasfilteredpriortotheauction,ifthepublisheror//winningbidderhasoptedoutofpricefeedbackorifyouraccounthas//optedoutofsharingwinningpriceswithotherbidders.Forfirst-price//auctions,minimum_bid_to_winispopulatedinsteadofthisfield.optionaldoubleprice=3[deprecated=true];//Theminimumbidvaluenecessarytohavewontheauction,inyouraccount//currency.Ifyourbidwontheauction,thisisthesecondhighestbid//thatwasnotfiltered(includingthefloorprice).Ifyourbiddidn't win//theauction,thisisthewinningcandidate's bid. This field will only be//populatedifyourbidparticipatedinafirst-priceauction,andwillnot//bepopulatedifyourbidwasfilteredpriortotheauction.optionaldoubleminimum_bid_to_win=6;//Billableeventratemultiplierthatwasappliedtothisbidduring//ranking.Theadjustmentreflectsthelikelihoodthatyourbidwould//generateabillableevent(namely,theadrenderssuccessfully)ifitwon//theauction,relativetotheprobabilitythatotherbidsgeneratea//billableeventiftheywontheauction.Thisadjustmentcanbelargeror//smallerthan1.Thisaffectsthefinalrankingintheauctiononly;in//particular,thismultiplierdoesnotaffectthepaymentorwhetherthe//bidclearsanyfloorprice.optionalfloatbillable_event_rate_bid_adjustment=13[default=1];//WhenapublisherusesanRTBauctionandwaterfall-basedSDKmediationon//thesamequery,thewinnerofthereal-timeauctionmustalsocompetein//amediationwaterfall(whichisorderedbyprice)towintheimpression.//Ifthebidparticipatedintheauctionandtherewasnowaterfall,the//valueofthisfieldis0.Ifthebidparticipatedintheauctionand//therewasawaterfall,thevalueofthisfieldisapricerepresentinga//samplebidfromtheeligiblemediationnetworksthatwerehigherthanthe//auctionwinner,weightedbyexpectedfillrate.Thisfieldcanbeused//inconjunctionwithminimum_bid_to_wintotrainbiddingmodels.TheCPM//isinyouraccountcurrency.optionaldoublesampled_mediation_cpm_ahead_of_auction_winner=8;messageEventNotificationToken{//Thecontentsofthetoken.optionalstringpayload=1;}//Thetokenincludedinthecorrespondingbid.optionalEventNotificationTokenevent_notification_token=4;//ThecreativeIDincludedinthecorrespondingbid.optionalstringbuyer_creative_id=5;}
Das erste Feld, das Sie in dieser Nachricht prüfen sollten, ist bid_feedback.creative_status_code. Die Bedeutung des Codes finden Sie in creative-status-codes.txt. Wenn Sie den Zuschlag erhalten, können Sie das Preisfeedback deaktivieren. Weitere Informationen finden Sie unter Deaktivierung.
Das Echtzeit-Feedback enthält die Gebotsanfrage-ID und eines der folgenden Elemente:
Auktionsergebnis
Echtzeit-Feedback
Der Käufer hat kein Gebot abgegeben.
Nichts.
Der Käufer hat ein Gebot abgegeben, das herausgefiltert wurde, bevor es die Auktion erreicht hat.
Nachdem Sie ein Gebot in einer Erstpreisauktion abgegeben haben, erhalten Sie Echtzeit-Feedback, einschließlich der Felder minimum_bid_to_win und sampled_mediation_cpm_ahead_of_auction_winner, sofern das Gebot nicht aus der Auktion herausgefiltert wurde. Diese Signale können verwendet werden, um Ihre Gebotslogik darüber zu informieren, wie viel höher oder niedriger Ihr Gebot hätte sein können, um die Impression zu gewinnen.
minimum_bid_to_win: Das Mindestgebot, das hätte abgegeben werden können, um die Echtzeitgebote-Auktion zu gewinnen. Wenn Sie die Auktion gewonnen haben, ist dies das niedrigste Gebot, das Sie hätten abgeben können, um die Auktion zu gewinnen. Wenn Sie die Auktion verloren haben, ist dies das Gewinnergebot.
sampled_mediation_cpm_ahead_of_auction_winner: Wenn sich in der Vermittlungskette andere Netzwerke befinden, ist der Wert dieses Felds ein Preis, der ein Beispielgebot von einem der infrage kommenden Vermittlungsnetzwerke darstellt, die höher als der Auktionsgewinner waren, gewichtet nach der erwarteten Ausführungsrate. Dieser Wert wird auf 0 gesetzt, wenn keines der Netzwerke in der Vermittlungskette voraussichtlich Anzeigen ausliefert oder wenn der Publisher keine SDK-Vermittlung verwendet.
Funktionsweise
Um die Berechnungen zur Bestimmung der möglichen Werte für minimum_bid_to_win und sampled_mediation_cpm_ahead_of_auction_winner zu beschreiben, müssen wir zuerst Folgendes definieren:
Die CPMs in der Vermittlungskette werden in absteigender Reihenfolge dargestellt:
\[C_1, C_2, …, C_n\]
Die folgenden Werte sind die entsprechenden Ausführungsraten für die CPMs in der Vermittlungskette:
\[f_1, f_2, …, f_n\]
Die folgende Funktion wird verwendet, um den erwarteten CPM und seine Wahrscheinlichkeit aus dem Element \(i\)der Vermittlungskette basierend auf der angegebenen Ausführungsrate zu bestimmen:
\(X_i = \{C_i\) mit Wahrscheinlichkeit \(f_i\); \(0\) mit Wahrscheinlichkeit \(1 - f_i\}\)
Die endgültige Vermittlungskette sieht dann so aus:
\[\{C_1, C_2, …, C_K, W\}\]
Dabei ist \(W\) das erfolgreiche Gebot und \(C_K > W >= C_{K+1}\)
Der Mindestpreis wird als \(F\)bezeichnet.
Das zweitplatzierte Gebot wird als \(R\)bezeichnet.
Berechnungen für den Gewinner der Auktion
Feld
Berechnung
minimum_bid_to_win
\(max\{F, R, X_{K+1}, …, X_n\}\)
sampled_mediation_cpm_ahead_ of_auction_winner
\(\{C_i\) mit Wahrscheinlichkeit \(\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}\)
Für \(1 <= i <= K\).
Berechnungen für den Verlierer der Auktion
Feld
Berechnung
minimum_bid_to_win
\(max\{F, W\}\)
sampled_mediation_cpm_ahead_ of_auction_winner
\(max\{X_1, …, X_K\}\)
Beispiel mit einer einfachen Vermittlungskette
Angenommen, ein Publisher verwendet sowohl Echtzeitgebote als auch eine SDK-Vermittlungskette:
SDK-Vermittlungskette
Erwarteter CPM
Ausführungsrate
Netzwerk 1
\(C_1 = $3.00\)
\(f_1 = 5\%\)
Netzwerk 2
\(C_2 = $2.00\)
\(f_2 = 45\%\)
Netzwerk 3
\(C_3 = $0.50\)
\(f_3 = 80\%\)
Netzwerk 4
\(C_4 = $0.10\)
\(f_4 = 85\%\)
Angenommen, die RTB-Auktion hat folgendes Ergebnis:
RTB-Auktion
CPM
Auktionsgewinner (W)
1,00 $
Zweitplatzierter in der Auktion (R)
0,05 $
Mindestpreis (F)
0 $
Gebot, mit dem die Auktion gewonnen wurde
Im Folgenden finden Sie ein Beispiel dafür, wie Werte und Wahrscheinlichkeiten für minimum_bid_to_win und sampled_mediation_cpm_ahead_of_auction_winner für ein erfolgreiches Gebot berechnet werden.
Im Folgenden finden Sie ein Beispiel dafür, wie Werte und Wahrscheinlichkeiten für minimum_bid_to_win und sampled_mediation_cpm_ahead_of_auction_winner für ein Gebot berechnet werden, das nicht erfolgreich war.
minimum_bid_to_win
Probability
\(max(F, W) = $1.00\)
\(100\%\)
sampled_mediation_cpm_ ahead_of_auction_winner
Probability
\(C_1 = $3.00\)
\(f_1 = 5\%\)
\(C_2 = $2.00\)
\((1-f_1) \cdot f_2 =~ 42.8\%\)
\(0\)
\((1-f_1) \cdot (1-f_2) =~ 52.2\%\)
Aufschlüsselung von Gebotsanfragen
Die Aufschlüsselung von Gebotsanfragen beschreibt die Verarbeitung einer einzelnen komplexen BidRequest in mehrere Gebotsanfragen, die an Ihre Anwendung gesendet werden. Wenn eine Gebotsanfrage vereinfacht wird, können Sie erkennen, welche Gebotsanfragen Teil des Originals waren, da sie im Feld BidRequest.ext.google_query_id einen identischen Wert haben.
Die Aufschlüsselung von Gebotsanfragen ist standardmäßig aktiviert. Wenn Sie sie deaktivieren möchten, wenden Sie sich an Ihren Account Manager.
Anzeigenformate
Bei einigen Anzeigenflächen sind mehrere Formate möglich. Bei der Aufschlüsselung von Gebotsanfragen wird jedes Format in einer separaten Gebotsanfrage gesendet, wobei Attribute wie berechtigte Abrechnungs-IDs für das in der Anfrage angegebene Format relevant sind.
Gebotsanfragen, die die folgenden Formate enthalten, werden in separate Gebotsanfragen aufgeschlüsselt:
Banner
Video
Audio
Nativ
Beispiel für die Vereinfachung von Anzeigenformaten
Im Folgenden finden Sie ein Beispiel für eine vereinfachte OpenRTB-JSON-Gebotsanfrage ohne Aufschlüsselung des Anzeigenformats im Vergleich zu einer entsprechenden Gruppe von aufgeschlüsselten Anfragen:
Eine Anzeigenmöglichkeit für einen bestimmten Bieter kann neben der offenen Auktion auch für verschiedene Deal-Typen gelten. Bei der Aufschlüsselung von Gebotsanfragen für Deals wird eine Gebotsanfrage für die offene Auktion und eine für jeden Festpreis-Dealtyp gesendet. In der Praxis können sich die Einschränkungen für Anzeigen zwischen Auktionen und Festpreisangeboten unterscheiden. Bei einer bestimmten Videoanzeigenfläche, die sowohl für die offene Auktion als auch für ein Festpreisangebot verfügbar ist, erhält ein Bieter beispielsweise für jede Fläche separate Gebotsanfragen, bei denen sich Einschränkungen wie die maximale Anzeigendauer und die Zulässigkeit überspringbarer Anzeigen unterscheiden können. Durch die Vereinfachung der Anzeigenfläche können Sie die Einschränkungen für die offene Auktion und das Festpreisangebot leichter erkennen.
Überspringbarkeit und Videodauer
In der OpenRTB-Spezifikation gibt es keine separaten Felder, um die maximale Videodauer von überspringbaren und nicht überspringbaren Anzeigen anzugeben. Bei der Implementierung von Google wird die Aufschlüsselung von Gebotsanfragen verwendet, um mithilfe der vorhandenen Felder BidRequest.video.maxduration und BidRequest.video.skip zwischen diesen zu unterscheiden.
Im folgenden Beispiel wird gezeigt, wie Videoinventar abgeflacht wird, wenn die maximale Dauer einer nicht überspringbaren Anzeige 15 und die maximale Dauer einer überspringbaren Anzeige 60 beträgt.
Beispiel
max_ad_duration
skip (true ODER false)
Ursprüngliche Anfrage ohne Vereinfachung
15
true
Aufgeschlüsselte Anfrage 1: Nicht überspringbar
15
false
Aufgeschlüsselte Anfrage 2: Überspringbar
60
true
Die Aufschlüsselung von Gebotsanfragen für die Dauer überspringbarer Videos erfolgt nur, wenn die folgenden Bedingungen erfüllt sind:
Die Anfrage lässt Videos zu.
Sowohl überspringbare als auch nicht überspringbare Videos sind zulässig und die beiden jeweiligen maximalen Dauern unterscheiden sich im Wert.
Diese Anfrage ist für private Auktionen oder offene Auktionen geeignet.
Sie können diese Art der Vereinfachung deaktivieren, indem Sie sich an Ihren Technical Account Manager wenden. Wenn die Option deaktiviert ist und der Publisher sowohl überspringbare als auch nicht überspringbare Videoanzeigen mit unterschiedlichen maximalen Dauern basierend auf der Überspringbarkeit zulässt, wird skip auf true und maxduration auf die kürzere Dauer zwischen den Einschränkungen für überspringbare und nicht überspringbare Anzeigen festgelegt.
Video-Pods
Gebotsanfragen für einen Videopod mit mehreren Anzeigenflächen werden so aufgeschlüsselt, dass jede Gebotsanfrage für eine einzelne Anzeigenfläche aus diesem Pod gilt.
So können Sie für einen bestimmten Pod auf mehrere Anzeigenflächen bieten.
Open Measurement
Mit Open Measurement können Sie Drittanbieter angeben, die unabhängige Mess- und Überprüfungsdienste für Anzeigen in mobilen App-Umgebungen anbieten.
Sie können in der Gebotsanfrage feststellen, ob ein Publisher Open Measurement unterstützt, indem Sie prüfen, ob die Anzeigenmöglichkeit das Attribut OmsdkType:
OMSDK 1.0 ausschließt, das Sie unter Vom Publisher ausschließbare Creative-Attribute finden. Diese Information finden Sie je nach Format unter dem Attribut battr für Banner oder Video.
Weitere Informationen zur Interpretation von Gebotsanfragen mit Open Measurement-Signalen finden Sie im Hilfeartikel zum Open Measurement SDK.
Beispiele für Gebotsanfragen
In den folgenden Abschnitten finden Sie Beispiele für Gebotsanfragen für verschiedene Anzeigentypen.
[null,null,["Zuletzt aktualisiert: 2026-11-17 (UTC)."],[],["Bid requests are HTTP POSTs using OpenRTB Protobuf, replacing the deprecated Google RTB protocol. Parsing involves `ParseFromString()` to access fields in the `BidRequest` object. Billing IDs, found in `BidRequest.imp.ext.billing_id` and `BidRequest.imp.pmp.deal.ext.billing_id`, must be specified in `BidResponse.seatbid.bid.ext.billing_id`. Key information comes from dictionary files. Bid URL macros dynamically insert `BidRequest` data. Complex bid requests can be broken into simpler, flattened requests per format or deal, such as skippable/non-skippable video ads, or video pods. Bidders get real-time feedback. The provided sample requests are used to help the process.\n"]]