> 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/integration/de/brand-pages/brand-page-retailer-integration-guide/overview-1.md). # Übersicht ## Was sind Markenseiten? Markenseiten sind maßgeschneiderte Landingpage-Erlebnisse, die auf Ihrer Website eingebunden sind und spezifische Markeninhalte präsentieren. Sie werden auf Ihrer Domain gehostet und über Ihre UI-Komponenten gerendert. Markenseiten werden separat von Standard-Werbekampagnen in der Epsilon Plattform verwaltet.\ Obwohl sie einen ähnlichen Erstellungs- und Überprüfungs-Workflow nutzen, repräsentieren sie Marken-Landingpage-Erlebnisse auf der Website eines Händlers und keine traditionelle Werbeanzeigen. **Beispiel:** Ein Benutzer besucht `yoursite.com/brands/nike` und sieht eine Seite der Marke Nike mit Nike-Produkten, die sich jedoch wie ein nahtloser Teil Ihrer Website anfühlt. ## Was Sie aufbauen werden Als Entwickler auf Händlerseite werden Sie: * Eine Route für Markenseiten-URLs hinzufügen (zum Beispiel `/brands/{slug}`). {% hint style="info" %} Händler sind nicht verpflichtet, für jede Markenseite eine URL bereitzustellen. URLs werden automatisch von der Plattform verwaltet. Die Basis-URL der Markenseite (einschließlich des Präfix) muss jedoch während des Onboardings konfiguriert werden (z. B. im Händler-Styleguide). Wenn die vollständige URL oder das Präfix nicht angegeben ist, wird die Markenseiten-URL auf der Einrichtungsseite nicht ausgefüllt. {% endhint %} * Die Brand Pages API unter Verwendung des extrahierten Slugs aufrufen. * Die zurückgegebenen Inhaltsmodule rendern. * Impression-, Klick- und Add-to-Cart-Tracking implementieren. * Einen Reverse Proxy für First-Party-Tracking konfigurieren. {% hint style="info" %} Dieser Schritt ist nur für clientseitiges Tracking erforderlich. {% endhint %} ### Ihre Verantwortlichkeiten im Vergleich zu Epsilon's | Sie übernehmen | Epsilon Bietet | | ------------------------------------------ | -------------------------------------- | | ✅ API-Integration zum Abrufen von Inhalten | ✅ Inhalt und Vorlagen für Markenseiten | | ✅ Rendern von Inhalten auf Ihrer Website | ✅ Tracking-Infrastruktur | | ✅ Einrichten des Reverse Proxys | ✅ Analysen und Berichterstattung | | ✅ Bereitstellung Ihres Styleguides | ✅ Kampagnen-Management-Tools | | ✅ Testen und Validieren | ✅ Technischer Support | ## Wie Markenseiten funktionieren ### End-to-End-Ablauf {% hint style="info" %} Inhalte von Markenseiten werden in der Epsilon -Benutzeroberfläche konfiguriert und in der Vorschau angezeigt. Händler integrieren Markenseiten ausschließlich über APIs und sind dafür verantwortlich, das finale Erlebnis auf ihren Websites zu rendern. {% endhint %} Während des Überprüfungsprozesses können Händler vor der Genehmigung eine Vorschau der konfigurierten Markenseiten-Inhalte anzeigen. ### Vorlagen & Module Während des Onboardings Epsilon arbeitet mit Ihrem Team zusammen, um Vorlagen zu erstellen, die Folgendes definieren: * Die verfügbaren Inhaltsmodule (wie Hero, Produktraster, Text und Bilder), wobei die Modulnamen in der Benutzeroberfläche konfiguriert werden können, um sie an Ihre Händler-Taxonomie anzupassen. * Die Einschränkungen für jedes Modul (Zeichenlimits, Bildabmessungen usw.). * Styling, das Ihren Markenrichtlinien entspricht. Marken wählen beim Erstellen ihrer Kampagne eine Vorlage aus und füllen dann die Inhalte innerhalb dieser Einschränkungen aus. {% hint style="info" %} Die Brand Pages API gibt Inhaltsmodule und Tracking-URLs zurück. Händler sind dafür verantwortlich, das Styling über ihre eigenen UI-Komponenten und ihr Design-System anzuwenden. {% endhint %} **Beispiele** Die folgenden Beispiele veranschaulichen, wie Marken gängige Inhaltsmodule beim Erstellen einer Markenseite befüllen können. Dies sind nur Beispiel-Eingaben, die basierend auf der ausgewählten Vorlage und den Kampagnenzielen angepasst werden können. **HERO-Modul** * **Überschrift:** Entdecken Sie die neueste Sommerkollektion * **Unterüberschrift:** Frische Styles für jeden Anlass * **CTA:** Jetzt shoppen **TEXT-Modul** Entdecken Sie unsere neuesten Eingänge, die auf Komfort, Stil und Leistung ausgelegt sind – perfekt für den Alltag. **BILD-Modul** * Bildunterschrift:\*\* Neue Eingänge jetzt verfügbar * **Alt-Text:** Modell trägt die Sommerkollektion * URL: **PRODUCT\_GRID-Modul** Verwenden Sie ein Produktraster, um Bestseller oder saisonale Produkte zu präsentieren und Engagement sowie Konversionen zu steigern. #### Modulkonfiguration: | Modul | Beschreibung | Konfigurierbare Elemente (Zusammenfassung) | | -------------- | ----------------------------------------------------- | ------------------------------------------------------------------- | | HERO | Banner in voller Breite mit Bild, Überschrift und CTA | Überschrift, Unterüberschrift, CTA, Bild, Overlay | | PRODUCT\_GRID | Raster oder Karussell von Produkten | Produkte, Abschnittstitel, Beschreibung, CTA | | TEXT | Textinhaltsblock (Überschrift, Textkörper) | Textfelder, CTA | | IMAGE | Einzelbild mit optionalem Link | Bild, Bildunterschrift, Alt-Text, optionaler Link | | IMAGE\_GALLERY | Mehrere Bilder im Raster-Layout | Bilder, Bildunterschriften, Alt-Text, Abschnittstitel, Beschreibung | | FILTER\_MENU | Horizontale Filter-Registerkarten für Produkt-Raster | Filter-Bezeichnungen und Sortierung | | SPLIT\_LAYOUT | Mehrspaltiges Layout mit verschachtelten Modulen | Layout-Struktur und verschachtelte Module | {% hint style="info" %} Jedes konfigurierbare Element kann je nach Modul- und Händleranforderungen als erforderlich, optional (erlaubt) oder deaktiviert eingestellt werden. Einige Felder können auch maximale Zeichenbegrenzungen erzwingen, wenn sie als erforderlich oder erlaubt markiert sind. {% endhint %} ### Modul-Tags Vorlagen können ein optionales `tags` -Feld für jedes Modul enthalten – eine Liste kurzer Zeichenfolgen-Bezeichnungen (z. B. `["header"]`), die Ihre Integration für Layout-Entscheidungen, Analysen oder die Zuordnung von Modulen zu Ihren eigenen Komponenten verwenden kann. #### Wie Tags in der API-Antwort funktionieren * Wenn ein Modul Tags hat, erscheinen diese als ein `tags` -Array auf dem entsprechenden Element in `contentData`. * Wenn ein Modul keine Tags hat, wird die `tags` -Eigenschaft in der Antwort vollständig weggelassen – sie erscheint nicht als `"tags": []`. * Behandeln Sie ein fehlendes `tags` -Feld genauso wie „keine Tags“ – werfen Sie keinen Fehler, wenn es nicht vorhanden ist. * Tags werden auch für verschachtelte Module innerhalb von `SPLIT_LAYOUT` unterstützt – nicht nur für das Root-Split-Modul. {% hint style="info" %} Wichtig Tags sind transparente Bezeichnungen, die zwischen dem Händler und seinem Integrations-Team vereinbart wurden. Sie stehen in keinem Zusammenhang mit Ad-Tracking-Tags oder anderen Systemen – beziehen Sie sich immer auf diese als *„Modul-Tags“* oder *„Markenseiten-Modul-Tags“*, um Verwirrung zu vermeiden. {% endhint %} Beispiel für ein Antwort-Modul mit einem Tag ```json { "id": "image-1", "contentType": "IMAGE", "order": 1, "tags": ["header"], "imageUrl": "https://example.com/images/banner.jpg" } ``` **Beispiel für ein Antwort-Modul ohne Tag (Tags-Eigenschaft weggelassen):** ```json { "id": "image-2", "contentType": "IMAGE", "order": 2, "imageUrl": "https://example.com/images/promo.jpg" } ``` #### Was dies für die API-Antwort bedeutet Die `POST /ads/v3/brand-pages` -Antwort spiegelt dieselben Regeln wider: Ein Modul-Typ erscheint nur dann in `contentData` , wenn er Teil der Live-Vorlage ist und die Markenseite konfigurierten Inhalt für dieses Modul hat. Felder innerhalb eines Moduls können im JSON fehlen, `null`oder leer sein, wenn die Vorlage sie als optional oder deaktiviert markiert oder wenn die Marke sie ungesetzt lässt – dies ist zu erwarten und weist nicht auf eine fehlerhafte Nutzlast hin. Implementieren Sie das Rendering mit optionalen Typen und sicheren Accessoren – rendern Sie beispielsweise einen CTA-Block nur, wenn `ctaText` und ein Navigationsziel vorhanden sind; blenden Sie Hero-Medien aus, wenn `mediaUrl`fehlt. `trackers`auf Seitenebene oder auf einem Knoten kann weggelassen werden, wenn keine verfolgbare Interaktion vorliegt. Erstellen Sie URLs nur dann, wenn Sie sowohl einen anwendbaren Vorlagenschlüssel aus `trackingTypes` als auch die entsprechende `trackers.`\`.params`, sofern von der API bereitgestellt, haben. --- # 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/integration/de/brand-pages/brand-page-retailer-integration-guide/overview-1.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.