Open RTB 2.4 Gebotsantwort

Die Antwort auf eine Gebotsanfrage sollte die folgende Struktur haben:

Bid-Response-Objekt

Attribut	Erforderlich?	Beschreibung
id	Ja	ID der Gebotsanfrage, auf die dies eine Antwort ist (String)
seatbid	Ja	Sammlung von Geboten, die der Bieter im Namen eines bestimmten Seats abgegeben hat (Array)

Hinweis: Die ID muss mit der in der Anfrage angegebenen übereinstimmen

seatbid

Attribut	Erforderlich?	Beschreibung
bid	Ja	Array des Gebotsobjekts, das sich auf die Zielimpression bezieht

seatbid.bid

Attribut	Erforderlich?	Beschreibung
id	Ja	ID für das Gebotsobjekt, verwendet für das Tracking (String)
impid	Ja	ID des Impression-Objekts in der zugehörigen Gebotsanfrage.
price	Ja	Gebotspreis in CPM oder CPC (Float)
adm	Ja	XML-/JSON-Ad-Markup (String)
nurl	Ja	URL für die Gewinnbenachrichtigung, es wird empfohlen, HTTP für nurl (String) über HTTPS zu verwenden
burl	Nein	URL für die Abrechnungsbenachrichtigung, es wird empfohlen, HTTP für burl (String) über HTTPS zu verwenden
crid	Empfohlen	Creative-ID zur Unterstützung der Überprüfung der Anzeigenqualität (String)
iurl	Empfohlen	URL des Creatives
ext	Nein	ExoClick-spezifische Erweiterung (Objekt)

Hinweise:

• Wir unterstützen Video sowohl in Banner- als auch in Interstitial-Platzierungen.
• Die impid muss mit der in der Anfrage angegebenen übereinstimmen.
• Die adm muss je nach dem anvisierten Anzeigenformat in JSON oder XML bereitgestellt werden: JSON für Native, In-Stream und Push-Benachrichtigungen; XML für alle anderen Formate.
• Die nURL muss benachrichtigt werden, um das Kampagnen-Capping sicherzustellen und zu vermeiden, dass jedes Mal dieselbe Antwort zurückgegeben wird.
• Die bURL wird aufgerufen, wenn Impressionen oder Klicks ausgeliefert wurden, abhängig von CPM oder CPC aus dem Feld btype (Standard: CPM).

seatbid.bid.ext

Attribut	Erforderlich?	Beschreibung
btype	Empfohlen	Preismodell. Werte: 1 = CPM, 2 = CPC. Standard = 1 (int). Wenn die Antwort für eine Email-Clicks-Zonenanfrage ist, bedeutet 1 = Smart CPC.
		Hinweis: Nur Push-Benachrichtigungen, Native Ads, Direct Link und Email Clicks dürfen mit dem CPC-Preismodell bieten.

seatbid.bid.ext.dsa

Attribut	Erforderlich?	Beschreibung
behalf	Ja	Advertiser Transparency: Freier UNICODE-Textstring mit dem Namen der Person, in deren Auftrag die Anzeige angezeigt wird. Maximal 100 Zeichen. (String)
paid	Ja	Advertiser Transparency: Freier UNICODE-Textstring der Person, die für die Anzeige bezahlt hat. Muss immer enthalten sein, auch wenn es derselbe Wert wie im Attribut behalf ist. Maximal 100 Zeichen (String)
adrender	Ja	Kennzeichen, das angibt, dass Käufer/Werbetreibender ihre eigenen DSA-Transparenzinformationen im Creative rendern werden. 0 = Käufer/Werbetreibender rendert nicht, 1 = Käufer/Werbetreibender rendert (int)

seatbid.bid.dsa.transparency

Attribut	Erforderlich?	Beschreibung
domain	Ja	Domain der Entität, die Benutzerparameter angewendet hat (String)
params	Ja	Array der vom Buy-Side angewendeten Zielparameter für Benutzerparameter (unter Verwendung der von der DSA Transparency Taskforce bereitgestellten Liste). Unterstützung für mehrere Anbieter einschließen, die ihre eigenen Benutzer-Targeting-Parameter hinzufügen können. (int array)

Keine Gebotsantwort

Um auf eine Gebotsanfrage zu antworten, ohne ein tatsächliches Gebot abzugeben, sollte ein HTTP-Antwortcode 204 "No Content" gesendet werden.

URLs für Gewinn- und Abrechnungsbenachrichtigungen

Wenn entweder die nURL oder die bURL in der Gebotsantwort enthalten sind und gültige URLs sind, sendet die ExoClick-Plattform eine GET-Anfrage an sie. Diese URLs können einige Tokens enthalten, die von ExoClick vor dem GET ersetzt werden:

${AUCTION_ID} - ID der Gebotsanfrage; aus dem Attribut "Bid Request Object -> id".
${AUCTION_BID_ID} - ID des Gebots; aus dem Attribut "Bid Response Object -> bidid".
${AUCTION_IMP_ID} - ID der gerade gewonnenen Impression; aus dem Attribut "Bid Request Object -> Impression Object -> id".
${AUCTION_SEAT_ID} - ID des Bieter-Seats, für den das Gebot abgegeben wurde; aus dem Attribut "Bid Response Object -> Seat Bid Object -> Bid Object -> id".
${AUCTION_AD_ID} - ID des Ad-Markups, das der Bieter ausspielen möchte; aus dem Attribut "Bid Response Object -> Seat Bid Object -> Bid Object -> adid".
${AUCTION_PRICE} - Abrechnungspreis unter Verwendung derselben Währung und Einheiten wie das Konto; aus dem Attribut "Bid Response Object -> Seat Bid Object -> Bid Object -> price".
${AUCTION_CURRENCY} - Die im Gebot verwendete Währung (explizit oder implizit); nur zur Bestätigung.

Beispiel:

https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}&currency=${AUCTION_CURRENCY}

Wenn Sie sowohl nURL als auch bURLverwenden, ruft ExoClick beide auf.

ADM-Struktur

Je nach Anzeigenformat kann der adm Parameter ein Stück XML oder JSON enthalten. Detaillierte Beispiele für ADM-Strukturen finden Sie auf unserer Beispielseite

Beachten Sie beim Erstellen des ADM bitte Folgendes:

• iFrame-Markups (Banner, Fullpage-Interstitial) müssen in Ihrem ExoClick-Konto aktiviert sein, damit Sie sie verwenden können.
• In-Stream, Native als auch Push-Benachrichtigungsanzeigen sollten im adm einen JSON-kodierten String enthalten.
• Der adm-Parameter von In-Stream kann einer von zwei Strukturen folgen: Remote VAST oder Local VAST. Bei Remote VAST müssen Sie lediglich die URL angeben, unter der sich der VAST Wrapper befindet, während Sie bei Local VAST alle "trackingEvents" angeben müssen, die Sie zusätzlich zu "videoURL" und "clickURL" verfolgen möchten.

Derzeit unterstützen wir impression, progress als auch complete Ereignisse. Impression- und progress-Ereignisse sind obligatorisch, während complete nur hinzugefügt werden kann, wenn Sie Local VAST verwenden.

Das ADM muss derselben Struktur folgen, wie sie in unserem Beispiel oben gezeigt wird.

• Als optionalen Parameter können Sie crop_anchor_point im JSON-String aus dem Native Ads adm angeben, um festzulegen, wo sich der Ankerpunkt Ihres nativen Bildes befindet. Die verfügbaren Werte sind:

  • MIDDLE_CENTER = 0,
  • TOP_LEFT = 1,
  • TOP_CENTER = 2,
  • TOP_RIGHT = 3,
  • MIDDLE_LEFT = 4,
  • MIDDLE_RIGHT = 5,
  • BOTTOM_LEFT = 6,
  • BOTTOM_CENTER = 7,
  • BOTTOM_RIGHT= 8

Hier ist eine Visualisierung der verfügbaren Ankerpunkte:

Crop-Ankerpunkt

• Außerdem, in Bezug auf Native Ads, stellen Sie sicher, dass Sie Ihre eventtrackers gemäß der neuesten Native-Spezifikation

Beachten Sie, dass wir zwar auch imptrackers in Native Ads zulassen, wir jedoch dringend empfehlen, eventtrackers stattdessen zu verwenden.

• Push Notification anzeigen erlauben nur ein Bild-Asset pro Benachrichtigung. Breite und Höhe hängen davon ab, was aus der Anfrage kommt, und können 192x192 oder 720x480 sein. Beachten Sie, dass das adm ebenfalls ein JSON-kodierter String sein muss, da die Anfrage von einem Native-Objekt kommen wird.
• Schließlich, Push Notification anzeigen erlauben nur eine "imptracker"-URL

Beispiele

Detaillierte Beispiele für Bid-Responses und ADM-Strukturen finden Sie auf unserer Beispielseite für Advertiser-Antworten