> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/de/campaign-management-api/bannerxcampaign-1.md).

# Banner X-Kampagne

Banner X bietet responsive Banner-Anzeigen mit mehreren Komponenten, die das Online-Shopping-Erlebnis verbessern, indem sie sich nahtlos in die Websites von Händlern integrieren. Epsilon Retail Media stellt die Komponenten bereit, während das Frontend des Händlers das Styling verwaltet, um die Konsistenz mit dem E-Commerce-Design der Website zu gewährleisten. Dieser Ansatz hilft dabei, die Markenintegrität zu wahren und gleichzeitig Kunden effektiv anzusprechen.

<figure><img src="/files/sTLXyZl7YldW0b1uGnrv" alt="" width="100%"><figcaption></figcaption></figure>

## Hauptvorteile

* **Native Integration**: Anzeigen fügen sich natürlich in Produktkarussells ein und wahren den Stil der Website.
* **Personalisierung**: Liefern Sie Anzeigen in Echtzeit personalisiert aus, zugeschnitten auf die Interessen der Nutzer.
* **Erhöhtes Engagement**: Verbessern Sie die Produktsichtbarkeit, steigern Sie das Kunden-Engagement und kurbeln Sie die Verkäufe mit ansprechenden CTAs an.

## Banner X Komponenten

Understand the components of banner X to ensure your design complies with retailer standards. Each component is essential for maintaining visual consistency and functionality.

### Primäres Hintergrundbild

Der primäre Hintergrund ist eine einfache Kulisse, die Designklarheit und Konsistenz über Geräte hinweg gewährleistet. Vermeiden Sie das Einbetten von Produktbildern oder überladenden Inhalten, um Zuschneideprobleme zu vermeiden, insbesondere auf verschiedenen Geräten und Browserbreiten. Die sechs verfügbaren Konfigurationen für den primären Hintergrund sind:

* Wiederholend
* Ausfüllend
* Oben ausgerichtet
* Unten ausgerichtet
* Rechts ausgerichtet
* Links ausgerichtet

<figure><img src="/files/IYFW24CfuaMqwL7MRN74" alt="" width="100%"><figcaption></figcaption></figure>

### Sekundäres Hintergrundbild

Verwenden Sie das sekundäre Hintergrundbild für zusätzliche Dekoration auf Ihrem Banner. Die sechs verfügbaren sekundären Banner-Konfigurationen sind:

* Wiederholend
* Ausfüllend
* Oben ausgerichtet
* Unten ausgerichtet
* Rechts ausgerichtet
* Links ausgerichtet

### Banner-Text

Banner-Text ist der auf Ihrer Banner-Anzeige angezeigte Text, der begrenzte HTML-Tags unterstützt, wie `strong` für fett und `i` für kursiv. Sie können auch die Textfarbe anpassen. Zum Beispiel

<figure><img src="/files/6EA30xXw10mf6Nc9c9AQ" alt="" width="100%"><figcaption></figcaption></figure>

### Hero-Bild

Das Hero-Bild ist das Hauptwerbebild, das typischerweise verwendet wird, um Ihr Produkt oder Logo darzustellen. Die zwei verfügbaren Konfigurationen für das Hero-Bild sind:

* Querformat
* Hochformat

<figure><img src="/files/YkKjDRmTPor8nuyjdsMA" alt="" width="100%"><figcaption></figcaption></figure>

### Sekundäres Hero-Bild

Verwenden Sie das sekundäre Hero-Bild, um Ihr Produkt oder Logo darzustellen. Die zwei verfügbaren Konfigurationen sind:

* Querformat
* Block (ein Bild mit gleicher Breite und Höhe)

<figure><img src="/files/8qGFzuBpdNs6UKAk849N" alt="" width="100%"><figcaption></figcaption></figure>

### Call-to-Action

Ein Call-to-Action (CTA) ist ein klickbarer Text oder Button, der Nutzer zu einer Handlung auffordert, wie etwa einen Kauf zu tätigen oder eine andere Seite zu besuchen. CTAs sollten klar, handlungsorientiert und visuell hervorgehoben sein, um das Engagement zu steigern. Zum Beispiel ermutigt "Jetzt kaufen" zu Käufen.

<figure><img src="/files/0gqyMW850qell7HmpuZV" alt="" width="100%"><figcaption></figcaption></figure>

## Anzeigen-Platzierungstypen

Banner X unterstützt verschiedene strategische [Anzeigenplatzierungen](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) auf Retail-Websites, einschließlich:

* **Suche**: Zeigen Sie Anzeigen an, wenn Kunden konfigurierte Suchbegriffe, wie z. B. Schokolade, in Ihrer Kampagne eingeben. Für weitere Informationen siehe [Suchplatzierungen](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search).
* **Kategorie**: Zeigen Sie Anzeigen auf Kategorieseiten an, die sich auf Ihr Produkt beziehen. Targeten Sie spezifische Kategorien, indem Sie relevante Taxonomie-Details angeben, wie z. B. `Category:Cupboard/Snacks`. Für weitere Informationen siehe [Kategorie-Platzierungen](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category).
* **Kategorie und Suche**: Zeigen Sie Anzeigen an, wenn Kunden eine Kategorieseite besuchen, die sich auf Ihre Produkte bezieht, oder konfigurierte Suchbegriffe in Ihrer Kampagne verwenden.
* **Kategorie-Cross-Selling**: Platzierungen für Kategorie-Cross-Selling ermöglichen es Werbetreibenden, ergänzende Kategorien zusätzlich zu den Standardkategorien ihrer Produkte zu targeten. Dieser Ansatz erhöht die Sichtbarkeit von Produkten in verwandten Kategorien, wie z. B. die Präsentation von Kaffeeprodukten im Molkereibereich der Website eines Händlers. Für weitere Informationen siehe [Cross-Selling-Platzierungen](https://help.citrusad.com/retail-media-interface/integration/de/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements).
* **Broad Match**: Zeigen Sie Anzeigen auf hochfrequentierten Seiten an, die nicht mit spezifischen Kategorien oder Suchbegriffen verknüpft sind. Ideal für allgemeine Bereiche wie Homepages oder Checkout-Seiten. Für weitere Informationen siehe [Breite Übereinstimmung von Platzierungen](https://help.citrusad.com/retail-media-interface/integration/de/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements).

## Unterstützte Werbeflächen-Formate

Banner X kann in den folgenden Formaten eingesetzt werden:

* Einzelne Kachel
* Doppelte Kachel
* Full Banner

<figure><img src="/files/7M4C8xEviMQTGEamf2u4" alt="" width="100%"><figcaption></figcaption></figure>

## Banner-X-Anzeigen implementieren

Um Banner-X-Anzeigen einzurichten, befolgen Sie diese Schritte:

### Schritt 1: Prüfen Sie die Inhaltsstandards des Händlers

Inhaltsstandards sind Richtlinien und technische Parameter, die vorgeben, wie eine Banner X Anzeige innerhalb eines vorgesehenen Bereichs auf einer Website oder digitalen Plattform angezeigt werden sollte. Diese Standards können umfassen:

* **Dimensionen und Größe**: Spezifikationen zur genauen Breite und Höhe des Banners.
* **Dateiformat**: Akzeptierte Bild- oder Videodateiformate wie JPEG, JPG, PNG, SVG oder GIF.
* **Dateigrößenlimit**: Maximal zulässige Dateigröße, um schnelle Ladezeiten und optimale Leistung auf der Webseite zu gewährleisten.
* **Auflösung und Qualität**: Mindestanforderungen an die Auflösung, um sicherzustellen, dass das Banner gestochen scharf und professionell aussieht.
* **Positionierung und Ausrichtung**: Richtlinien dazu, wie das Banner innerhalb des verfügbaren Bereichs ausgerichtet werden sollte.
* **Inhaltseinschränkungen**: Regeln dazu, welche Inhalte im Banner enthalten sein dürfen oder nicht (z. B. keine anstößigen Inhalte, Einbindung obligatorischer rechtlicher Hinweise).
* **Interaktivität**: Spezifikationen für interaktive Elemente wie klickbare Bereiche, Animationen oder vom Nutzer ausgelöste Ereignisse, falls zutreffend.

Machen Sie sich mit den Richtlinien zu Inhaltsstandards des Händlers vertraut, um Ihre Kampagne zu starten. Diese Richtlinien enthalten Beispiel-URLs, Seitenpositionierung und spezifische Einschränkungen für Grafikinhalte. Wenden Sie sich an Ihren Customer Integration Engineer (CIE) für detaillierte Informationen zu verfügbaren Banner-X-Slots und deren Spezifikationen. Hier ist ein Beispiel:

<figure><img src="/files/mfQ3sjdcLbijBnVcACuL" alt="" width="100%"><figcaption></figcaption></figure>

### Schritt 2: Werbemittel vorbereiten

Entwickeln Sie Ihre Werbemittel gemäß den Inhaltsstandards des Händlers. Dies umfasst Elemente wie den primären Hintergrund, den sekundären Hintergrund, das Hero-Bild und das sekundäre Hero-Bild. Verwenden Sie die [Banner X Standard-Inhaltsdetails abrufen](/retail-media-interface/partner/de/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) API, um die Details des Inhaltsstandards abzurufen.

### Schritt 3: Das Werbeflächen-Format identifizieren

Bestimmen Sie das Werbeflächen-Format für Ihre Bereitstellung, was ein Full Banner, eine einzelne Kachel oder eine doppelte Kachel sein könnte.

### Schritt 4: Werbemittel hochladen

Nachdem Sie Ihre Werbemittel erstellt und das Werbeflächen-Format identifiziert haben, laden Sie diese mithilfe der [Laden Sie das Werbemittel-Asset hoch](/retail-media-interface/partner/de/team-user-api/user-1/uploadfile-1.md) API hoch. Die API gibt die Datei-ID und die URL des hochgeladenen Bildes zurück.

* **Datei-IDs**: Die Datei-IDs werden beim Erstellen einer Banner-X-Kampagne benötigt. Sie müssen eine spezifische Datei-ID für jeden Asset-Typ angeben, wie den primären Hintergrund, den sekundären Hintergrund, das Hero-Bild und das sekundäre Hero-Bild.
* **URL**: Die URL wird hauptsächlich verwendet, um eine Vorschau des hochgeladenen Bildes anzuzeigen.

### (Optional) Schritt 5: Rufen Sie die öffentliche URL des Bildes ab

Verwenden Sie die [Datei-URL-API abrufen](/retail-media-interface/partner/de/campaign-management-api/creativeassets/getcampaignfileurl.md) um die öffentliche URL des Bildes zu erhalten. Sie können diese URL verwenden, um das Bild zu überprüfen oder mit Stakeholdern zu teilen.

### Schritt 6: Eine Banner-X-Kampagne erstellen

Erstellen Sie eine Banner-X-Kampagne mit der [Banner X-Kampagne erstellen](/retail-media-interface/partner/de/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) API. Stellen Sie sicher, dass Sie die folgenden Angaben haben: `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`, und `secondaryHeroImageId`welche die Datei-IDs sind, die zurückgegeben werden von der [Laden Sie das Werbemittel-Asset hoch](/retail-media-interface/partner/de/team-user-api/user-1/uploadfile-1.md) API.


---

# 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://help.citrusad.com/retail-media-interface/partner/de/campaign-management-api/bannerxcampaign-1.md?ask=<question>&goal=<endgoal>
```

`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.
