> 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/overview-1.md).

# Prehľad

## Čo sú značkové stránky (Brand Pages)?

Značkové stránky sú prispôsobené vstupný stránky, ktoré sa nachádzajú na vašej webovej lokalite a prezentujú špecifický obsah značky. Sú hostované na vašej doméne a vyrenderované pomocou vašich komponentov používateľského rozhrania.

Značkové stránky sa spravujú oddelene od štandardných reklamných kampaní v Epsilon platforme.\
Hoci využívajú podobný postup vytvorenia a kontroly, predstavujú branded vstupné stránky na stránke predajcu, nie tradičné reklamy.

**Príklad:** Používateľ navštívi `yoursite.com/brands/nike` a uvidí stránku značky Nike s produktmi Nike, ale vyzerá a pôsobí ako súčasť vašej webovej lokality.

## Čo budete budovať

Ako inžinier predajcu budete:

* Pridávať trasu pre URL adresy značkových stránok (napríklad `/brands/{slug}`).

{% hint style="info" %}
Od predajcov sa nevyžaduje vyhradenie URL adresy pre každú značkovú stránku. URL adresy sú automaticky spravované platformou.

Však základná URL adresa značkovej stránky (vrátane prefixu) musí byť nakonfigurovaná počas onboardingu (napríklad v príručke štýlov predajcu). Ak nie je poskytnutá úplná URL adresa alebo prefix, URL adresa značkovej stránky sa na stránke nastavenia nevyplní.
{% endhint %}

* Robiť volania na Brand Pages API pomocou získaného identifikátora (slug).
* Renderovať vrátené obsahové moduly.
* Implementovať sledovanie zobrazení (impression), kliknutí a pridaní do košíka.
* Nakonfigurovať reverzný proxy pre sledovanie prvej strany (first-party).

{% hint style="info" %}
Tento krok sa vyžaduje iba pre sledovanie na strane klienta (client-side).
{% endhint %}

### Vaše zodpovednosti vs. Epsilon's

| Vy riešite                              | Epsilon Poskytuje                   |
| --------------------------------------- | ----------------------------------- |
| ✅ API integráciu na získanie obsahu     | ✅ Obsah a šablóny značkovej stránky |
| ✅ Renderovanie obsahu na vašej lokalite | ✅ Infraštruktúru sledovania         |
| ✅ Nastavenie reverzného proxy           | ✅ Analytiku a štatistiky            |
| ✅ Poskytnutie vašej príručky štýlov     | ✅ Nástroje na správu kampaní        |
| ✅ Testovanie a overovanie               | ✅ Technickú podporu                 |

## Ako fungujú značkové stránky

### Tok od začiatku do konca

{% hint style="info" %}
Obsah značkovej stránky sa konfiguruje a zobrazuje v náhľade v Epsilon používateľskom rozhraní. Predajcovia integrujú značkové stránky výhradne prostredníctvom API a sú zodpovední za vyrenderovanie konečného zážitku na svojich lokalitách.
{% endhint %}

Počas procesu kontroly si predajcovia môžu pred schválením pozrieť náhľad nakonfigurovaného obsahu značkovej stránky.

### Šablóny a moduly

Počas onboardingu Epsilon spolupracuje s vaším tímom na vytvorení šablón, ktoré definujú:

* Dostupné obsahové moduly (ako napríklad hero, mriežka produktov, text a obrázky), pričom názvy modulov je možné nakonfigurovať v používateľskom rozhraní tak, aby zodpovedali taxatómii vášho predajcu.
* Obmedzenia pre každý modul (limity znakov, rozmery obrázkov atď.).
* Štýl, ktorý je v súlade s vašimi pravidlami pre značku.

Značky si pri vytváraní kampane vyberú šablónu a potom vyplnia obsah v rámci týchto obmedzení.

{% hint style="info" %}
Brand Pages API vracia obsahové moduly a sledovacie URL adresy. Predajcovia sú zodpovední za aplikovanie štýlov pomocou vlastných UI komponentov a dizajnového systému.
{% endhint %}

**Príklady**

Nasledujúce príklady ilustrujú, ako môžu značky vyplniť bežné obsahové moduly pri vytváraní značkovej stránky. Ide len o vzorové vstupy, ktoré je možné upraviť na základe zvolenej šablóny a cieľov kampane.

**HERO modul**

* **Nadpis:** Objavte najnovšiu letnú kolekciu
* **Podnadpis:** Svieže štýly pre každú príležitosť
* **CTA:** Nakupovať teraz

**TEXTOVÝ modul**

Preskúmajte naše najnovšie prírastky navrhnuté pre pohodlie, štýl a výkon - ideálne na každodenné nosenie.

**OBRÁZKOVÝ modul**

* Popisok:\*\* Najnovšie prírastky sú už dostupné
* **Alt text:** Modelka v letnej kolekcii
* URL: <https://example-cdn.com/summer-collection.jpg>

**PRODUCT\_GRID modul**

Použite mriežku produktov na prezentáciu najpredávanejších alebo sezónnych produktov a zvýšte zapojenie a konverzie.

#### Konfigurácia modulu:

| Modul          | Popis                                              | Nakonfigurovateľné prvky (Zhrnutie)                      |
| -------------- | -------------------------------------------------- | -------------------------------------------------------- |
| HERO           | Banner na celú šírku s obrázkom, nadpisom a CTA    | Nadpis, podnadpis, CTA, obrázok, prekrývacia vrstva      |
| PRODUCT\_GRID  | Mriežka alebo karusel produktov                    | Produkty, názov sekcie, popis, CTA                       |
| TEXT           | Blok textového obsahu (nadpis, telo textu)         | Textové polia, CTA                                       |
| IMAGE          | Samostatný obrázok s voliteľným odkazom            | Obrázok, titulok, alternatívny text, voliteľný odkaz     |
| IMAGE\_GALLERY | Viaceré obrázky v mriežkovom rozložení             | Obrázky, titulky, alternatívny text, názov sekcie, popis |
| FILTER\_MENU   | Horizontálne záložky filtrov pre mriežky produktov | Štítky filtrov a poradie                                 |
| SPLIT\_LAYOUT  | Viacstĺpcové rozloženie s vloženými modulmi        | Štruktúra rozloženia a vložené moduly                    |

{% hint style="info" %}
Každý konfigurujúci prvok je možné nastaviť ako povinný, voliteľný (povolený) alebo zakázaný, v závislosti od modulu a požiadaviek predajcu.

Niektoré polia môžu tiež presadzovať maximálne limity znakov, keď sú označené ako povinné alebo povolené.
{% endhint %}

### Značky modulu

Šablóny môžu obsahovať voliteľné `tags` pole na každom module — zoznam krátkych textových štítkov (napr., `["header"]`), ktoré môže vaša integrácia použiť na rozhodnutia o rozložení, analytiku alebo mapovanie modulov na vaše vlastné komponenty.

#### Ako fungujú značky v odpovedi API

* Keď má modul značky, zobrazia sa ako `tags` pole na zodpovedajúcej položke v `contentData`.
* Keď modul nemá žiadne značky, `tags` vlastnosť je úplne vynechaná z odpovede - nezobrazí sa ako `"tags": []`.
* Považujte chýbajúce `tags` pole za rovnaké ako "žiadne značky" - nevyhadzujte chybu, ak chýba.
* Značky sú podporované aj na vložených moduloch v rámci `SPLIT_LAYOUT` - nie len na koreňovom rozdelenom module.

{% hint style="info" %}
Dôležité

Značky sú nepriehľadné štítky dohodnuté medzi predajcom a ich integračným tímom. Nesúvisia so značkami na sledovanie reklám ani s žiadnym iným systémom — vždy ich označujte ako *"značky modulu"* alebo *"značky modulu stránky značky"*, aby ste predišli zámene.
{% endhint %}

Príklad modulu odpovede so značkou

```json
{
  "id": "image-1",
  "contentType": "IMAGE",
  "order": 1,
  "tags": ["header"],
  "imageUrl": "https://example.com/images/banner.jpg"
}
```

**Príklad modulu odpovede bez značky (vlastnosť tags bola vynechaná):**

```json
{
  "id": "image-2",
  "contentType": "IMAGE",
  "order": 2,
  "imageUrl": "https://example.com/images/promo.jpg"
}
```

#### Čo to znamená pre odpoveď API

The `POST /ads/v3/brand-pages` odpoveď odráža rovnaké pravidlá: typ modulu sa zobrazí iba v `contentData` keď je súčasťou živej šablóny a stránka značky má nakonfigurovaný obsah pre tento modul.

Polia vo vnútri modulu môžu v JSON chýbať, `null`, alebo byť prázdne, keď ich šablóna označí ako voliteľné alebo zakázané, alebo keď ich značka ponechá nenastavené - toto sa očakáva a nesignalizuje chybné dáta.

Implementujte rendering s voliteľnými typmi a bezpečnými prístupovými prvkami - napríklad vykreslite blok CTA iba vtedy, keď `ctaText` a cieľ navigácie sú prítomné; skryte hlavné médiá (hero media), keď `mediaUrl`chýba.

`trackers`na úrovni stránky alebo na uzle môžu byť vynechané, keď neexistuje žiadna sledovateľná interakcia. Skladajte URL adresy iba vtedy, keď máte k dispozícii aj použiteľný kľúč šablóny z `trackingTypes` a zodpovedajúce `trackers.`\<slot>`.params`, ak ich poskytuje 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/integration/sk/brand-pages/brand-page-retailer-integration-guide/overview-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.