> 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/partner/sk/campaign-management-api/bannerxcampaign-1.md).
# Banner X kampaň
Banner X ponúka responzívne, viacprvkové bannerové reklamy, ktoré zlepšujú zážitok z online nakupovania vďaka bezšvovej integrácii do webových stránok maloobchodníkov. Epsilon Retail Media poskytuje komponenty, zatiaľ čo frontend maloobchodníka spravuje štýlovanie, aby sa zabezpečila konzistentnosť s dizajnom e-shopu. Tento prístup pomáha zachovať integritu značky a zároveň efektívne zapájať zákazníkov.
## Kľúčové výhody
* **Natívna integrácia**: Reklamy prirodzene zapadajú do produktových kolotočov a zachovávajú štýl stránky.
* **Personalizácia**: Doručujte reklamy personalizované v reálnom čase, prispôsobené záujmom používateľa.
* **Vyššia angažovanosť**: Zlepšite viditeľnosť produktov, zvýšte angažovanosť zákazníkov a podporte predaj pomocou presvedčivých CTA.
## Banner X komponenty
Pochopte komponenty bannera X, aby ste sa uistili, že váš dizajn spĺňa štandardy maloobchodníka. Každý komponent je nevyhnutný na udržanie vizuálnej konzistentnosti a funkčnosti.
### Hlavný obrázok pozadia
Hlavné pozadie je jednoduchý podklad, ktorý zabezpečuje jasnosť a konzistentnosť dizajnu naprieč zariadeniami. Vyhnite sa vkladaniu produktových obrázkov alebo dominantného obsahu, aby ste predišli problémom s orezaním, najmä na rôznych zariadeniach a šírkach prehliadača. Šesť dostupných konfigurácií hlavného pozadia je:
* Opakujúce sa
* Výplň
* Zarovnané nahor
* Zarovnané nadol
* Zarovnané doprava
* Zarovnané doľava
### Sekundárny obrázok pozadia
Použite sekundárny obrázok pozadia pre dodatočnú dekoráciu vášho bannera. Šesť dostupných konfigurácií sekundárneho bannera je:
* Opakujúce sa
* Výplň
* Zarovnané nahor
* Zarovnané nadol
* Zarovnané doprava
* Zarovnané doľava
### Text bannera
Text bannera je text zobrazený vo vašej bannerovej reklame, ktorý podporuje obmedzené HTML tagy ako `strong` pre tučné písmo a `i` pre kurzívu. Môžete si tiež prispôsobiť farbu textu. Napríklad
### Hlavný obrázok (hero)
Hlavný obrázok (hero) je hlavný propagačný obrázok, ktorý sa zvyčajne používa na zobrazenie vášho produktu alebo loga. Dve dostupné konfigurácie pre hlavný obrázok (hero) sú:
* Na šírku
* Na výšku
### Sekundárny hlavný obrázok (hero)
Použite sekundárny hlavný obrázok (hero) na zobrazenie vášho produktu alebo loga. Dve dostupné konfigurácie sú:
* Na šírku
* Blok (obrázok s rovnakou šírkou a výškou)
### Výzva na akciu
Výzva na akciu (CTA) je klikateľný text alebo tlačidlo, ktoré nabáda používateľov k akcii, ako je uskutočnenie nákupu alebo návšteva inej stránky. CTA by mali byť jasné, orientované na akciu a vizuálne výrazné, aby sa zvýšila angažovanosť. Napríklad "Kúpiť teraz" nabáda k nákupu.
## Typy umiestnenia reklamy
Banner X podporuje rôzne strategické [umiestnenia reklamy](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) na webových stránkach maloobchodníkov, vrátane:
* **Vyhľadávanie**: Zobrazte reklamy, keď zákazníci vo vašej kampani zadajú nakonfigurované vyhľadávacie výrazy, ako napríklad čokoláda. Pre viac informácií si pozrite [Umiestnenia vo vyhľadávaní](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search).
* **Kategória**: Zobrazte reklamy na stránkach kategórií súvisiacich s vaším produktom. Cieľte na špecifické kategórie poskytnutím relevantných podrobností o taxonómii, ako napríklad `Category:Cupboard/Snacks`. Pre viac informácií si pozrite [Umiestnenia v kategóriách](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category).
* **Kategória a vyhľadávanie**: Zobrazte reklamy, keď zákazníci navštívia stránku kategórie súvisiacu s vašimi produktmi alebo použijú nakonfigurované vyhľadávacie výrazy vo vašej kampani.
* **Krížový predaj v kategórii**: Umiestnenia pre krížový predaj v kategórii umožňujú inzerentom meTargetovať doplnkové kategórie okrem východiskových kategórií ich produktov. Tento prístup zvyšuje viditeľnosť produktov v súvisiacich kategóriách, ako je napríklad prezentácia kávových produktov v mliečnej sekcii stránky maloobchodníka. Pre viac informácií si pozrite [umiestnenia pre krížový predaj](https://help.citrusad.com/retail-media-interface/integration/sk/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements).
* **Voľná zhoda**: Zobrazujte reklamy na stránkach s vysokou návštevnosťou, ktoré nie sú prepojené so špecifickými kategóriami alebo vyhľadávacími výrazmi. Ideálne pre všeobecné miesta, ako sú domovské stránky alebo stránky pokladne. Pre viac informácií si pozrite [Umiestnenia s voľnou zhodou](https://help.citrusad.com/retail-media-interface/integration/sk/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements).
## Podporované formáty reklamných pozícií
Banner X je možné nasadiť v nasledujúcich formátoch:
* Jednoduchá dlaždica
* Dvojitá dlaždica
* Plný banner
## Implementácia reklám banner X
Ak chcete nastaviť reklamy banner X, postupujte podľa týchto krokov:
### Krok 1: Skontrolujte štandardy obsahu maloobchodníka
Štandardy obsahu sú pokyny a technické parametre, ktoré určujú, ako by sa mala Banner X reklama zobraziť na vyhradenom mieste na webovej stránke alebo digitálnej platforme. Tieto štandardy môžu zahŕňať:
* **Rozmery a veľkosť**: Špecifikácie presnej šírky a výšky bannera.
* **Formát súboru**: Akceptované formáty obrázkových alebo videových súborov, ako napríklad JPEG, JPG, PNG, SVG alebo GIF.
* **Limit veľkosti súboru**: Maximálna povolená veľkosť súboru na zabezpečenie rýchleho načítania a optimálneho výkonu na webovej stránke.
* **Rozlíšenie a kvalita**: Minimálne požiadavky na rozlíšenie, aby banner vyzeral ostro a profesionálne.
* **Umiestnenie a zarovnanie**: Pokyny na zarovnanie bannera v rámci dostupného priestoru.
* **Obmedzenia obsahu**: Pravidlá týkajúce sa toho, aký obsah môže alebo nemôže byť súčasťou bannera (napr. žiadny urážlivý obsah, zahrnutie povinných právnych vyhlásení).
* **Interaktivita**: Špecifikácie pre interaktívne prvky, ako sú klikateľné oblasti, animácie alebo udalosti spúšťané používateľom, ak sa uplatňujú.
Zoznámte sa s pokynmi pre štandardy obsahu maloobchodníka, aby ste mohli spustiť svoju kampaň. Tieto pokyny obsahujú príklady URL adries, umiestnenie na stránke a špecifické obmedzenia obsahu podkladov. Podrobné informácie o dostupných pozíciách pre banner X a ich špecifikáciách získate od svojho Customer Integration Engineera (CIE). Tu je príklad:
### Krok 2: Pripravte reklamné materiály
Vyviňte svoje reklamné materiály podľa štandardov obsahu maloobchodníka. To zahŕňa prvky, ako je hlavné pozadie, sekundárne pozadie, hlavný obrázok (hero) a sekundárny hlavný obrázok (hero). Použite [Get Banner X content standard details](/retail-media-interface/partner/sk/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) API na získanie podrobností o štandarde obsahu.
### Krok 3: Identifikujte formát reklamnej pozície
Určite formát reklamnej pozície pre vaše nasadenie, ktorým môže byť plný banner, jednoduchá dlaždica alebo dvojitá dlaždica.
### Krok 4: Nahrajte reklamné materiály
Po vytvorení reklamných materiálov a identifikácii formátu reklamnej pozície ich nahrajte pomocou [Upload the creative asset](/retail-media-interface/partner/sk/team-user-api/user-1/uploadfile-1.md) API. API vracia ID súboru a URL adresu nahraného obrázka.
* **ID súborov**: ID súborov sú povinné pri vytváraní kampane s bannerom X. Pre každý typ podkladu musíte poskytnúť konkrétne ID súboru, ako je hlavné pozadie, sekundárne pozadie, hlavný obrázok (hero image) a sekundárny hlavný obrázok.
* **URL**: URL adresa sa používa predovšetkým na náhľad nahraného obrázka.
### (Voliteľné) Krok 5: Získanie verejnej URL adresy obrázka
Použite [API na získanie URL adresy súboru](/retail-media-interface/partner/sk/campaign-management-api/creativeassets/getcampaignfileurl.md) na získanie verejnej URL adresy obrázka. Túto URL adresu môžete použiť na overenie alebo zdieľanie obrázka so zainteresovanými stranami.
### Krok 6: Vytvorenie kampane s bannerom X
Vytvorte kampaň s bannerom X pomocou [Vytvoriť kampaň s bannerom X](/retail-media-interface/partner/sk/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) API. Uistite sa, že máte `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`a `secondaryHeroImageId`čo sú ID súborov vrátené cez [Upload the creative asset](/retail-media-interface/partner/sk/team-user-api/user-1/uploadfile-1.md) 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/partner/sk/campaign-management-api/bannerxcampaign-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.