> 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/sk/brand-pages/brand-page-retailer-integration-guide/validation-troubleshooting.md).
# Validácia a riešenie problémov
## Testovanie a validácia
### Kontrolný zoznam pred spustením
**Technická integrácia**
* [ ] API :`POST /ads/v3/brand-pages` vracia 200 s `contentData`.
* [ ] Vykresľovanie : Moduly obsahu sa na vašej lokalite vykresľujú správne a v správnom poradí.
* [ ] Téma: `theme` polia sa aplikujú správne; `null` hodnoty sa vracajú k predvoleným hodnotám sprievodcu štýlom predajcu.
* [ ] Voliteľné polia: Logika vykresľovania a sledovania musí tolerovať vynechané, null alebo prázdne voliteľné polia modulov, ako aj vynechané uzly sledovania bez chýb (overte pomocou viacerých živých šablón, nie len z jednej ukážkovej stránky značky).
* [ ] Štýl : Stránka značky zodpovedá dizajnovému systému vašej lokality.
* [ ] Mobilné zariadenia : Stránka značky sa na mobilných zariadeniach zobrazuje správne.
* [ ] Cache-busting : `{TS}` hodnota sa mení pri každej požiadavke.
**Validácia sledovania**
* [ ] Pixel zobrazenia (C2S) : Každá položka v `trackingTemplates.client.impressionPixelUrls` sa spustí a vráti 200 `image/gif`
* [ ] Oznámenie o zobrazení (S2S) : Zostavená URL adresa zobrazenia servera; **GET** alebo **POST** priamo na Epsilon hostiteľa sledovania vráti 204 No Content.
* [ ] Sledovanie kliknutí (C2S) : Buď zostavená `client.clickRedirect` URL adresa vráti 302 na správne cieľové miesto, alebo zostavená `client.clickEvent` vráti 204 No Content (podľa toho, ktorú možnosť váš tok používa – nie obidve)
* [ ] Oznámenie o kliknutí (S2S) : **GET** alebo **POST** priamo na zostavenú URL adresu servera vráti 204 No Content
* [ ] Pridanie do košíka (C2S) : Zostavená `client.addToCartEvent` spustená ako beacon udalosti vráti 204 No Content
* [ ] Pridanie do košíka (S2S) : Zostavená `server.addToCartEvent` volaná priamo na hostiteľa sledovania vráti 204 No Content
**Infraštruktúra a súkromie**
* [ ] Reverzný proxy : Požiadavky na sledovanie C2S sa preposielajú cez vašu doménu; S2S sa cez proxy neodosiela
* [ ] Hlavičky : `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` sú prítomné v požiadavkách cez proxy
* [ ] Súkromie : Žiadne PII nie sú prítomné v žiadnom parametri ani URL adrese
* [ ] HTTPS : Všetky požiadavky používajú zabezpečené pripojenia
* [ ] Stránky produktov : Stránky sa po presmerovaní kliknutia vykresľujú správne
### Odporúčané nástroje
* Vývojárske nástroje prehliadača: Karta Siet na kontrolu načítania pixelov a presmerovaní.
* Fiddler alebo Charles Proxy: Kontrola správania reverzného proxy a preposielania hlavičiek.
### Riešenie problémov
| Problém | Kontrola |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pixely sa nenačítajú | Overte DNS/SSL, potvrďte prepísanie cesty proxy, skontrolujte dostupnosť k Epsilon hostiteľovi sledovania. |
| Presmerovania sa nepreposielajú | Uistite sa, že `{RURL}` je zakódovaná v URL, overte, či proxy zachováva dopytový reťazec. |
| API nevracia žiadny obsah | Overte, či `catalogId` a `urlSlug` zodpovedajú aktívnej kampani na stránke značky. |
| Sledovanie blokované blokovačom reklám | Potvrďte, že je nakonfigurovaný reverzný proxy – sledovanie by malo smerovať cez vašu doménu. |
| Pridanie do košíka sa nesleduje | Uistite sa, že po akcii košíka spustíte zostavenú klientsku alebo serverovú URL adresu pre pridanie do košíka. |
| Stránka vyhodí chybu pri načítavaní niektorých stránok značky | Pravdepodobne sa s poľami doc/example zaobchádza ako s vždy povinnými. Zaznamenajte neupravený JSON modulu, pridajte ochrany pre voliteľné kľúče a chýbajúce sledovanie a potvrďte, že šablóna tieto polia povoľuje alebo zakazuje. |
| Farby témy sa neaplikujú správne | Skontrolujte, či sa `null` polia témy vracajú k predvoleným hodnotám vášho sprievodcu štýlom, namiesto toho, aby sa vykresľovali ako doslovné hodnoty null alebo prázdne reťazce. |
## Slovník
**Základné pojmy pre integráciu stránok značky**
| Pojem | Definícia | Príklad |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| API kľúč | Vaše autentifikačné údaje pre Epsilon služby | `Basic abc123xyz...` |
| Stránka značky | Značková cieľová stránka na vašom webe | yoursite.com/brands/nike |
| Sledovanie C2S | Client-to-Server: Sledovanie založené na prehliadači. Zobrazenia používajú pixely 1x1; kliknutia používajú presmerovanie 302 alebo event beacon; pridanie do košíka používa event beacon. | `
, navigator.sendBeacon(clickEvent)` |
| Sledovanie S2S | Server-to-Server: Backendové sledovanie (GET alebo POST na zostavené sledovacie URL) | Váš server → Epsilon server |
| Obsahový modul | Jednotlivé obsahové bloky (hero, text, produkty atď.) | Hero banner, mriežka produktov |
| Značky modulov | Voliteľné textové štítky na module (napr. `["header"]`) nastavené v šablóne. Používané maloobchodníkmi na rozvrhnutie smerovania, analytiku alebo mapovanie na ich vlastné komponenty. Vynechané z odpovede, keď sú prázdne. | `"tags": ["header"]` |
| Téma | Vždy prítomné pri úspechu v odpovedi API: vložené `colors` (pozadie + sedem textových rolí) a `buttons` (`primary` / `secondary` s `background` a `text`). Všetky polia farieb témy sú povinné (hex6). Pozrite si [Objekt témy](/retail-media-interface/integration/sk/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } } |
| Zobrazenie | Keď si používateľ zobrazí stránku značky | Načítanie stránky = 1 zobrazenie |
| Kliknutie | Keď používateľ klikne na obsah stránky značky | Kliknutie na tlačidlo CTA |
| Konverzia | Keď používateľ pridá produkt do košíka zo stránky značky | Akcia pridania do košíka |
| Reverzný proxy | Smeruje sledovanie cez vašu doménu, aby sa predišlo blokovačom reklám | `yoursite.com/epsilon/` → Epsilon |
| URL Slug | Identifikátor značky v ceste URL | `nike` in `/brands/nike` |
| ID katalógu | Váš jedinečný identifikátor katalógu produktov | Poskytuje Epsilon |
| Makro | Zástupné symboly v odpovedi (`{TS}`, `{RURL}`) in `tracking.params` ktoré nahradíte počas spúšťania; | `{TS} → 1737485823910` |
| IAB TCF | Interactive Advertising Bureau Transparency & Consent Framework | Štandard súladu s GDPR |
| PII | Osobne identifikovateľné údaje (toto nikdy neposielajte!) | E-mail, telefón, skutočné meno |
| Cache-busting | Pridávanie časových pečiatok na zabránenie vyrovnávaniu odpovedí v pamäti cache | `?ts=1737485823910` |
### Technické skratky
| Skratka | Plný výraz | Čo to znamená |
| -------------------- | ------------------------------------- | ----------------------------------------- |
| RMN | Retail Media Sieť | Epsilonreklamná platforma spoločnosti |
| Výzva na akciu (CTA) | Výzva na akciu | Klikateľné tlačidlá/odkazy |
| JSON | JavaScript Object Notation | Dátový formát pre požiadavky/odpovede API |
| HTTPS | HTTP Secure | Šifrovaný webový protokol |
| GDPR | Všeobecné nariadenie o ochrane údajov | Zákon EÚ o ochrane súkromia |
| TLS | Transport Layer Security | Šifrovací protokol |
| DNS | Domain Name System | Systém internetových adries |
| SSL | Secure Sockets Layer | Šifrovací protokol |
| RFC | Request for Comments | Dokumenty technických štandardov |
---
# 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/sk/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.