> 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/cs/brand-pages/brand-page-retailer-integration-guide/validation-troubleshooting.md).
# Validace a řešení problémů
## Testování a validace
### Kontrolní seznam pro validaci před spuštěním
**Technická integrace**
* [ ] API :`POST /ads/v3/brand-pages` vrací 200 s `contentData`.
* [ ] Vybrandování : Moduly obsahu se na vaší stránce zobrazují správně a ve správném pořadí.
* [ ] Motivy: `theme` pole jsou správně použita; `null` hodnoty se vrací k výchozím hodnotám podle grafického manuálu prodejce.
* [ ] Volitelná pole: Renderer a logika sledování musí tolerovat vynechaná, nulová nebo prázdná volitelná pole modulů, stejně jako vynechané uzly sledování, bez chyby (ověřte pomocí více živých šablon, ne pouze na jedné ukázkové stránce značky).
* [ ] Stylování : Stránka značky odpovídá designovému systému vaší stránky.
* [ ] Mobilní zařízení : Stránka značky se správně zobrazuje na mobilních zařízeních.
* [ ] Cache-busting : `{TS}` hodnota se mění při každém požadavku.
**Validace sledování**
* [ ] Pixel zobrazení (C2S) : Každá položka v `trackingTemplates.client.impressionPixelUrls` se spustí a vrátí 200 `image/gif`
* [ ] Oznámení o zobrazení (S2S) : Sestavená URL adresa zobrazení na serveru; **GET** nebo **POST** přímo na Epsilon hostitele sledování vrátí 204 No Content.
* [ ] Sledování kliknutí (C2S) : Bud sestavená `client.clickRedirect` URL adresa vrátí 302 na správné cílové místo, nebo sestavená `client.clickEvent` vrátí 204 No Content (podle toho, kterou možnost váš tok používá – ne obě)
* [ ] Oznámení o kliknutí (S2S) : **GET** nebo **POST** přímo na sestavenou URL adresu serveru vrátí 204 No Content
* [ ] Přidání do košíku (C2S) : Sestavená `client.addToCartEvent` spuštěná jako maják události vrátí 204 No Content
* [ ] Přidání do košíku (S2S) : Sestavená `server.addToCartEvent` volaná přímo na hostitele sledování vrátí 204 No Content
**Infrastruktura a soukromí**
* [ ] Reverzní proxy : Požadavky na sledování C2S přesměrované přes vaši doménu; S2S se neposílá přes proxy
* [ ] Hlavičky : `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` jsou přítomny v požadavcích přes proxy
* [ ] Soukromí : Žádné OÚI (PII) nejsou přítomny v žádném parametru ani URL adrese
* [ ] HTTPS : Všechny požadavky používají zabezpečené připojení
* [ ] Stránky produktů : Stránky se po přesměrování z kliknutí zobrazí správně
### Doporučené nástroje
* Vývojářské nástroje prohlížeče: Karta Síť pro kontrolu načítání pixelů a přesměrování.
* Fiddler nebo Charles Proxy: Kontrola chování reverzního proxy a předávání hlaviček.
### Řešení problémů
| Problém | Kontrola |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Pixely se nenačítají | Ověřte DNS/SSL, potvrďte přepsání cesty proxy a zkontrolujte dostupnost pro Epsilon hostitele sledování. |
| Přesměrování se nepředávají | Ujistěte se, že `{RURL}` je zakódována v URL, a ověřte, že proxy zachovává řetězec dotazu (query string). |
| API nevrací žádný obsah | Ověřte, `catalogId` a `urlSlug` odpovídají aktivní kampani na stránce značky. |
| Sledování je blokováno blokátorem reklam | Potvrďte, že je nakonfigurována reverzní proxy – sledování by mělo směrovat přes vaši doménu. |
| Přidání do košíku se nesleduje | Ujistěte se, že po akci v košíku spustíte sestavenou URL adresu pro přidání do košíku na straně klienta nebo serveru. |
| Stránka vyhodí chybu při načítání některých stránek značek | Pravděpodobně považuje pole doc/example za vždy povinná. Zaznamenejte neupravený modul JSON do protokolu, přidejte kontroly pro volitelné klíče a chybějící sledování a potvrďte, že šablona tato pole povoluje nebo zakazuje. |
| Barvy motivu se neaplikují správně | Zkontrolujte, zda `null` pole motivu se vrací k výchozím hodnotám vašeho grafického manuálu, namísto toho, aby se vykreslovala jako doslovné nulové hodnoty (null) nebo prázdné řetězce. |
## Slovníček
**Základní pojmy pro integraci stránek značek**
| Pojem | Definice | Příklad |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| API klíč | Přihlašovací údaj pro vaše Epsilon služby | `Basic abc123xyz...` |
| Stránka značky | Značková cílová stránka na vašem webu | yoursite.com/brands/nike |
| Sledování C2S | Client-to-Server: Sledování v prohlížeči. Zobrazení používají pixely 1x1; kliknutí používají přesměrování 302 nebo beacon události; přidání do košíku používá beacon události. | `
, navigator.sendBeacon(clickEvent)` |
| Sledování S2S | Server-to-Server: Sledování na backendu (GET nebo POST na sestavené sledovací adresy URL) | Váš server → Epsilon server |
| Modul obsahu | Jednotlivé bloky obsahu (hlavní banner, text, produkty atd.) | Hlavní banner, mřížka produktů |
| Značky modulů | Volitelné textové štítky modulu (např. `["header"]`) nastavené v šabloně. Maloobchodníci je používají pro směrování rozvržení, analytiku nebo mapování na vlastní komponenty. Pokud jsou prázdné, v odpovědi se vynechávají. | `"tags": ["header"]` |
| Motiv | V odpovědi API se při úspěchu vždy nachází: vnořené `colors` (pozadí + sedm textových rolí) a `buttons` (`primary` / `secondary` s `background` a `text`). Všechna pole barev motivu jsou povinná (hex6). Viz [Objekt motivu](/retail-media-interface/integration/cs/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } } |
| Zobrazení | Když si uživatel zobrazí stránku značky | Načtení stránky = 1 zobrazení |
| Kliknutí | Když uživatel klikne na obsah stránky značky | Kliknutí na tlačítko výzvy k akci |
| Konverze | Když uživatel přidá produkt do košíku ze stránky značky | Akce přidání do košíku |
| Reverzní proxy | Směruje sledování přes vaši doménu, aby se předešlo blokátorům reklam | `yoursite.com/epsilon/` → Epsilon |
| Slug URL | Identifikátor značky v cestě URL | `nike` in `/brands/nike` |
| ID katalogu | Váš jedinečný identifikátor katalogu produktů | Poskytuje Epsilon |
| Makro | Zástupné symboly v odpovědi (`{TS}`, `{RURL}`) in `tracking.params` které nahrazujete při spuštění; | `{TS} → 1737485823910` |
| IAB TCF | Interactive Advertising Bureau Transparency & Consent Framework | Standard souladu s GDPR |
| PII | Osobní identifikační údaje (tyto údaje nikdy neposílejte!) | E-mail, telefon, skutečné jméno |
| Cache-busting | Přidávání časových razítek zabraňující ukládání odpovědí do mezipaměti | `?ts=1737485823910` |
### Technické zkratky
| Zkratka | Plný název | Co znamená |
| ------- | ---------------------------------------- | ---------------------------------------- |
| RMN | Retail Media Mřížka | Epsilonreklamní platforma |
| CTA | Výzva k akci (Call-to-Action) | Klikatelná tlačítka/odkazy |
| JSON | JavaScript Object Notation | Datový formát pro požadavky/odpovědi API |
| HTTPS | HTTP Secure | Šifrovaný webový protokol |
| GDPR | Obecné nařízení o ochraně osobních údajů | Zákon EU o ochraně soukromí |
| TLS | Transport Layer Security | Šifrovací protokol |
| DNS | Domain Name System | Systém internetových adres |
| SSL | Secure Sockets Layer | Šifrovací protokol |
| RFC | Request for Comments | Dokumenty technických standardů |
---
# 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/cs/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.