> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/de/werbetreibende/open-rtb/adv-open-rtb-2.4-response.md). # 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) | {% hint style="info" %} **Hinweis:** Die ID muss mit der in der Anfrage angegebenen übereinstimmen {% endhint %} ### 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) | {% hint style="info" %} **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). {% endhint %} ### 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}¤cy=${AUCTION_CURRENCY} ``` Wenn Sie sowohl **nURL** als auch **bURL**verwenden, 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**](/rtb/de/werbetreibende/open-rtb/open-rtb-advertiser-code-examples.md) 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](/rtb/de/werbetreibende/open-rtb/open-rtb-advertiser-code-examples.md) 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](/files/ad74d4f7c178634e65cd510de29d4d1e8ba1772b) * Außerdem, in Bezug auf **Native Ads**, stellen Sie sicher, dass Sie Ihre **eventtrackers** gemäß der [neuesten Native-Spezifikation](https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf) 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](/rtb/de/werbetreibende/open-rtb/open-rtb-advertiser-code-examples.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/rtb/de/werbetreibende/open-rtb/adv-open-rtb-2.4-response.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.