> 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/overview-1.md). # Přehled ## Co jsou značkové stránky? Značkové stránky jsou přizpůsobené vstupní stránky, které se nacházejí na vašem webu a prezentují konkrétní obsah značky. Jsou hostovány na vaší doméně a vykreslovány pomocí vašich prvků uživatelského rozhraní. Značkové stránky se spravují odděleně od standardních reklamních kampaní v platformě Epsilon .\ Ačkoli využívají podobný postup vytváření a kontroly, představují značkové vstupní stránky na webu prodejce, nikoli tradiční reklamy. **Příklad:** Uživatel navštíví `yoursite.com/brands/nike` a uvidí stránku značky Nike s produkty Nike, která však vypadá a působí jako součást vašeho webu. ## Co budete budovat Jako vývojář na straně prodejce budete mít za úkol: * Přidat směrování (route) pro URL značkových stránek (například `/brands/{slug}`). {% hint style="info" %} Prodejci nemusí vyhrazovat URL pro každou značkovou stránku zvlášť. URL jsou automaticky spravována platformou. Základní URL značkové stránky (včetně předpony) však musí být nakonfigurována během přípravy (onboardingu), například v příručce stylu prodejce. Pokud není zadána celá URL nebo její předpona, URL značkové stránky se na stránce nastavení nevyplní. {% endhint %} * Zavolat API pro značkové stránky pomocí získaného identifikačního řetězce (slug). * Vykreslit vrácené moduly obsahu. * Implementovat sledování zobrazení, kliknutí a přidání do košíku. * Nakonfigurovat reverse proxy pro sledování v rámci první strany (first-party tracking). {% hint style="info" %} Tento krok je vyžadován pouze pro sledování na straně klienta. {% endhint %} ### Vaše odpovědnost vs. Epsilon's | Zajišťujete vy | Epsilon Poskytuje | | ----------------------------------- | ----------------------------------------- | | ✅ Integrace API pro načítání obsahu | ✅ Obsah a šablony značkových stránek | | ✅ Vykreslování obsahu na vašem webu | ✅ Infrastruktura pro sledování (tracking) | | ✅ Nastavení reverse proxy | ✅ Analytika a reportování | | ✅ Poskytnutí vaší příručky stylu | ✅ Nástroje pro správu kampaní | | ✅ Testování a ověřování | ✅ Technická podpora | ## Jak značkové stránky fungují ### Kompletní proces (End-to-End) {% hint style="info" %} Obsah značkové stránky se konfiguruje a zobrazuje v náhledu v rozhraní Epsilon . Prodejci integrují značkové stránky výhradně prostřednictvím API a odpovídají za vykreslení finálního vzhledu na svých webech. {% endhint %} Během schvalovacího procesu si prodejci mohou nakonfigurovaný obsah značkové stránky před schválením prohlédnout v náhledu. ### Šablony a moduly Během přípravy (onboardingu) Epsilon spolupracuje s vaším týmem na vytvoření šablon, které definují: * Dostupné moduly obsahu (například hlavní banner/hero, mřížka produktů, text a obrázky), přičemž názvy modulů lze konfigurovat v rozhraní tak, aby odpovídaly taxonomii prodejce. * Omezení pro jednotlivé moduly (limity znaků, rozměry obrázků atd.). * Stylování, které je v souladu s pokyny pro vaši značku. Značky si při vytváření kampaně vyberou šablonu a následně vyplní obsah v rámci daných omezení. {% hint style="info" %} API pro značkové stránky vrací moduly obsahu a URL pro sledování. Prodejci odpovídají za aplikaci stylování pomocí vlastních prvků uživatelského rozhraní a designového systému. {% endhint %} **Příklady** Následující příklady ilustrují, jak mohou značky při vytváření značkové stránky naplnit běžné moduly obsahu. Jedná se pouze o vzorové vstupy, které lze upravit na základě vybrané šablony a cílů kampaně. **Modul HERO** * **Hlavní nadpis:** Objevte nejnovější letní kolekci * **Podnadpis:** Svěží styly pro každou příležitost * **CTA:** Nakupovat nyní **Modul TEXT** Prozkoumejte naše nejnovější kousky navržené pro pohodlí, styl a výkon – ideální pro každodenní nošení. **Modul OBRÁZEK** * Popisek:\*\* Novinky právě v prodeji * **Alternativní text:** Modelka v letní kolekci * URL: **PRODUCT\_Modul MŘÍŽKA** Použijte mřížku produktů k prezentaci nejprodávanějších nebo sezónních produktů a podpořte zapojení uživatelů a konverze. #### Konfigurace modulu: | Modul | Popis | Konfigurovatelné prvky (přehled) | | -------------- | -------------------------------------------------------- | -------------------------------------------------------- | | HERO | Banner na celou šířku s obrázkem, hlavním nadpisem a CTA | Hlavní nadpis, podnadpis, CTA, obrázek, překryvná vrstva | | PRODUCT\_GRID | Mřížka nebo karusel produktů | Produkty, název sekce, popis, CTA | | TEXT | Textový blok (hlavní nadpis, tělo textu) | Textová pole, CTA | | IMAGE | Samostatný obrázek s volitelným odkazem | Obrázek, popisek, alternativní text, volitelný odkaz | | IMAGE\_GALLERY | Množství obrázků v mřížkovém rozvržení | Obrázky, popisky, alternativní text, název sekce, popis | | FILTER\_MENU | Horizontální záložky filtru pro mřížky produktů | Štítky filtru a řazení | | SPLIT\_LAYOUT | Vícesloupcové rozvržení s vloženými moduly | Struktura rozvržení a vložené moduly | {% hint style="info" %} Každý konfigurovatelný prvek lze nastavit jako povinný, volitelný (povolený) nebo zakázaný, v závislosti na požadavcích modulu a prodejce. Některá pole mohou také vynucovat maximální limity znaků, pokud jsou označena jako povinná nebo povolená. {% endhint %} ### Značky modulu Šablony mohou obsahovat volitelné `tags` pole na každém modulu — seznam krátkých textových štítků (např. `["header"]`), které může vaše integrace použít pro rozhodování o rozvržení, analytiku nebo mapování modulů na vaše vlastní komponenty. #### Jak fungují značky v odpovědi API * Pokud má modul značky, zobrazí se jako `tags` pole na odpovídající položce v `contentData`. * Pokud modul nemá žádné značky, `tags` vlastnost je z odpovědi zcela vynechána - neobjeví se jako `"tags": []`. * Považujte chybějící `tags` pole za stejné jako "žádné značky" - pokud chybí, nevyvolávejte chybu. * Značky jsou podporovány také u vložených modulů v rámci `SPLIT_LAYOUT` - nejen na kořenovém rozděleném modulu. {% hint style="info" %} Důležité Značky jsou netransparentní štítky dohodnuté mezi prodejcem a jeho integračním týmem. Nesouvisejí se značkami pro sledování reklam ani jiným systémem — abyste předešli zmatkům, vždy je označujte jako *"značky modulu"* nebo *"značky modulu stránky značky"*. {% endhint %} Příklad odpovědi modulu se značkou ```json { "id": "image-1", "contentType": "IMAGE", "order": 1, "tags": ["header"], "imageUrl": "https://example.com/images/banner.jpg" } ``` **Příklad odpovědi modulu bez značky (vlastnost tags je vynechána):** ```json { "id": "image-2", "contentType": "IMAGE", "order": 2, "imageUrl": "https://example.com/images/promo.jpg" } ``` #### Co to znamená pro odpověď API Odpověď `POST /ads/v3/brand-pages` odráží tato stejná pravidla: typ modulu se objeví pouze v `contentData` pokud je součástí živé šablony a stránka značky má pro tento modul nakonfigurovaný obsah. Pole uvnitř modulu mohou v JSON chybět, `null`nebo být prázdná, pokud je šablona označí jako volitelná nebo zakázaná, nebo pokud je značka ponechá nenastavená - toto se očekává a neznamená to vadný obsah. Implementujte vykreslování s volitelnými typy a bezpečnými přístupovými prvky - například blok CTA vykreslete pouze tehdy, když `ctaText` a cíl navigace jsou přítomny; média hlavního banneru skryjte, pokud `mediaUrl`chybí. `trackers`na úrovni stránky nebo na uzlu může být vynecháno, pokud neexistuje žádná sledovatelná interakce. Sestavujte URL pouze tehdy, když máte jak použitelný klíč šablony z `trackingTypes` tak odpovídající `trackers.`\`.params`, pokud je poskytnuto rozhraním 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/cs/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.