> 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/validation-troubleshooting.md).
# Validierung & Fehlerbehebung
## Testen und Validieren
### Checkliste für die Validierung vor dem Launch
**Technische Integration**
* [ ] API:`POST /ads/v3/brand-pages` liefert 200 mit `contentData`.
* [ ] Rendering: Inhaltsmodule werden auf Ihrer Website korrekt und in der richtigen Reihenfolge gerendert.
* [ ] Theme: `theme` -Felder werden korrekt angewendet; `null` -Werte fallen auf die Standardwerte des Retailer-Styleguides zurück.
* [ ] Optionale Felder: Renderer und Tracking-Logik müssen ausgelassene, null- oder leere optionale Modulfelder sowie ausgelassene Tracking-Knoten ohne Fehler tolerieren (validieren Sie anhand mehrerer Live-Templates, nicht nur einer einzelnen Demo-Markenseite).
* [ ] Styling: Markenseite entspricht dem Design-System Ihrer Website.
* [ ] Mobil: Markenseite wird auf Mobilgeräten korrekt angezeigt.
* [ ] Cache-Busting: `{TS}` -Wert ändert sich bei jeder Anfrage.
**Tracking-Validierung**
* [ ] Impression-Pixel (C2S): Jeder Eintrag in `trackingTemplates.client.impressionPixelUrls` wird ausgelöst und liefert 200 `image/gif`
* [ ] Impression-Benachrichtigung (S2S): Zusammengesetzte Server-Impression-URL; **GET** oder **POST** direkt an den Epsilon Tracking-Host liefert 204 No Content.
* [ ] Klick-Tracking (C2S): Entweder liefert die zusammengesetzte `client.clickRedirect` -URL 302 an das korrekte Ziel oder die zusammengesetzte `client.clickEvent` liefert 204 No Content (je nachdem, welche Option Ihr Ablauf nutzt – nicht beide)
* [ ] Klick-Benachrichtigung (S2S): **GET** oder **POST** direkt an die zusammengesetzte Server-URL liefert 204 No Content
* [ ] In den Warenkorb (C2S): Zusammengesetzte `client.addToCartEvent` , die als Event-Beacon ausgelöst wird, liefert 204 No Content
* [ ] In den Warenkorb (S2S): Zusammengesetzte `server.addToCartEvent` , die direkt an den Tracking-Host aufgerufen wird, liefert 204 No Content
**Infrastruktur & Datenschutz**
* [ ] Reverse Proxy: C2S-Tracking-Anfragen werden über Ihre Domain weitergeleitet; S2S wird nicht über den Proxy gesendet
* [ ] Header: `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` sind bei geproxyted Anfragen vorhanden
* [ ] Datenschutz: Keine PII in Parametern oder URLs vorhanden
* [ ] HTTPS: Alle Anfragen verwenden sichere Verbindungen
* [ ] Produktseiten: Seiten werden nach Klick-Weiterleitung korrekt gerendert
### Empfohlene Tools
* Browser-Entwicklertools: Netzwerk-Tab zur Überprüfung von Pixel-Ladevorgängen und Weiterleitungen.
* Fiddler oder Charles Proxy: Verhalten des Reverse Proxy und Header-Weiterleitung überprüfen.
### Fehlerbehebung
| Problem | Prüfung |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pixel werden nicht geladen | DNS/SSL überprüfen, Proxy-Pfad-Rewrite bestätigen, Erreichbarkeit des Epsilon Tracking-Hosts prüfen. |
| Weiterleitungen werden nicht weitergeleitet | Sicherstellen, dass `{RURL}` URL-encodiert ist, überprüfen, ob der Proxy den Query-String beibehält. |
| API liefert keinen Inhalt | Überprüfen, ob `catalogId` und `urlSlug` mit einer aktiven Markenseiten-Kampagne übereinstimmen. |
| Tracking durch Ad-Blocker blockiert | Bestätigen, dass der Reverse Proxy konfiguriert ist – Tracking sollte über Ihre Domain geroutet werden. |
| In den Warenkorb nicht getrackt | Stellen Sie sicher, dass Sie die zusammengesetzte Client- oder Server-URL für 'In den Warenkorb' nach der Warenkorb-Aktion auslösen. |
| Seite wirft Fehler beim Laden einiger Markenseiten | Wahrscheinlich werden Doc-/Beispielfelder als immer erforderlich behandelt. Protokollieren Sie das Roh-Modul-JSON, fügen Sie Schutzprüfungen (Guards) für optionale Schlüssel und fehlendes Tracking hinzu und bestätigen Sie, dass das Template diese Felder zulässt oder deaktiviert. |
| Theme-Farben werden nicht korrekt angewendet | Überprüfen Sie, ob `null` Theme-Felder auf die Standardwerte Ihres Styleguides zurückfallen, anstatt als wörtliche null-Werte oder leere Zeichenketten gerendert zu werden. |
## Glossar
**Wichtige Begriffe für die Markenseiten-Integration**
| Begriff | Definition | Beispiel |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
| API-Schlüssel | Ihre Authentifizierungsanmeldedaten für Epsilon Dienste | `Basic abc123xyz...` |
| Markenseite | Ein Markenseiten-Erlebnis auf Ihrer Website | yoursite.com/brands/nike |
| C2S-Tracking | Client-to-Server: Browserbasiertes Tracking. Impressionen verwenden 1x1-Pixel; Clicks verwenden eine 302-Weiterleitung oder ein Event-Beacon; In-den-Warenkorb verwendet ein Event-Beacon. | `
, navigator.sendBeacon(clickEvent)` |
| S2S-Tracking | Server-to-Server: Backend-Tracking (GET oder POST an die zusammengesetzten Tracking-URLs) | Ihr Server → Epsilon Server |
| Inhaltsmodul | Einzelne Inhaltsblöcke (Hero, Text, Produkte usw.) | Hero-Banner, Produktraster |
| Modul-Tags | Optionale Zeichenfolgen-Labels für ein Modul (z. B. `["header"]`), die im Template festgelegt werden. Von Händlern für Layout-Routing, Analysen oder die Zuordnung zu eigenen Komponenten verwendet. Wird aus der Antwort ausgelassen, wenn leer. | `"tags": ["header"]` |
| Theme | Bei Erfolg in der API-Antwort immer vorhanden: verschachteltes `colors` (Hintergrund + sieben Textrollen) und `buttons` (`primary` / `secondary` mit `background` und `text`). Alle Theme-Farbfelder sind erforderlich (hex6). Siehe [Theme-Objekt](/retail-media-interface/integration/de/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } } |
| Impression | Wenn eine Markenseite von einem Benutzer angesehen wird | Seitenaufruf = 1 Impression |
| Click | Wenn ein Benutzer auf Inhalte der Markenseite klickt | CTA-Button-Klick |
| Conversion | Wenn ein Benutzer von der Markenseite aus ein Produkt zum Warenkorb hinzufügt | In-den-Warenkorb-Aktion |
| Reverse Proxy | Leitet das Tracking über Ihre Domain um, um Ad-Blocker zu vermeiden | `yoursite.com/epsilon/` → Epsilon |
| URL-Slug | Kennung der Marke im URL-Pfad | `nike` in `/brands/nike` |
| Katalog-ID | Ihre eindeutige Produktkatalog-Kennung | Bereitgestellt von Epsilon |
| Makro | Antwort-Platzhalter (`{TS}`, `{RURL}`) in `tracking.params` die Sie zur Laufzeit ersetzen; | `{TS} → 1737485823910` |
| IAB TCF | Interactive Advertising Bureau Transparency & Consent Framework | DSGVO-Compliance-Standard |
| PII | Personenbezogene Daten (niemals senden!) | E-Mail, Telefon, echter Name |
| Cache-Busting | Hinzufügen von Zeitstempeln zur Verhinderung von zwischengespeicherten Antworten | `?ts=1737485823910` |
### Technische Akronyme
| Akronym | Vollständiger Begriff | Bedeutung |
| ------- | --------------------------- | --------------------------------------- |
| RMN | Retail Media Netzwerk | Epsilons Werbeplattform |
| CTA | Call-to-Action | Klickbare Schaltflächen/Links |
| JSON | JavaScript Object Notation | Datenformat für API-Anfragen/-Antworten |
| HTTPS | HTTP Secure | Verschlüsseltes Webprotokoll |
| DSGVO | Datenschutz-Grundverordnung | EU-Datenschutzgesetz |
| TLS | Transport Layer Security | Verschlüsselungsprotokoll |
| DNS | Domain Name System | Internet-Adresssystem |
| SSL | Secure Sockets Layer | Verschlüsselungsprotokoll |
| RFC | Request for Comments | Technische Standarddokumente |
---
# 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/validation-troubleshooting.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.