> 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/cs/campaign-management-api/bannerxcampaign-1.md).

# Kampaň Banner X

Banner X nabízí responzivní vícesložkové bannerové reklamy, které vylepšují zážitek z nakupování online díky bezproblémové integraci do webových stránek prodejců. Epsilon Retail Media poskytuje komponenty, zatímco frontend prodejce spravuje styl, aby byla zajištěna konzistence s designem e-shopu. Tento přístup pomáhá zachovat integritu značky a zároveň efektivně zapojit zákazníky.

<figure><img src="/files/9QMLSACMKQ3Frq4UXkSs" alt="" width="100%"><figcaption></figcaption></figure>

## Hlavní výhody

* **Nativní integrace**: Reklamy přirozeně zapadají do produktových karuselů a zachovávají styl webu.
* **Personalizace**: Doručujte reklamy personalizované v reálném čase, přizpůsobené zájmům uživatele.
* **Vyšší zapojení**: Zlepšete viditelnost produktů, podpořte zapojení zákazníků a zveřejte prodeje pomocí přesvědčivých výzev k akci (CTA).

## Banner X komponenty

Pochopení komponent banneru X zajistí, že váš návrh bude odpovídat standardům prodejce. Každá komponenta je nezbytná pro zachování vizuální konzistence a funkčnosti.

### Obrázek hlavního pozadí

Hlavní pozadí je jednoduchý podklad, který zajišťuje přehlednost a konzistenci designu napříč zařízeními. Vyhněte se vkládání obrázků produktů nebo dominantního obsahu, abyste předešli problémům s ořezem, zejména na různých zařízeních a při různých šířkách prohlížeče. Šest dostupných konfigurací hlavního pozadí je:

* Opakující se
* Výplň
* Zarovnáno nahoru
* Zarovnáno dolů
* Zarovnáno doprava
* Zarovnáno doleva

<figure><img src="/files/4p1FgcrNt38Lg97KwIaI" alt="" width="100%"><figcaption></figcaption></figure>

### Obrázek vedlejšího pozadí

Použijte obrázek vedlejšího pozadí pro dodatečnou dekoraci banneru. Šest dostupných konfigurací vedlejšího banneru je:

* Opakující se
* Výplň
* Zarovnáno nahoru
* Zarovnáno dolů
* Zarovnáno doprava
* Zarovnáno doleva

### Text banneru

Text banneru je text zobrazený v bannerové reklamě, který podporuje omezené HTML tagy jako `strong` pro tučné a `i` pro kurzívu. Můžete také přizpůsobit barvu textu. Například

<figure><img src="/files/ha9Cxu07opcINj48AETw" alt="" width="100%"><figcaption></figcaption></figure>

### Obrázek hero

Obrázek hero je hlavní propagační obrázek, který se obvykle používá k zobrazení vašeho produktu nebo loga. Dvě dostupné konfigurace pro obrázek hero jsou:

* Na šířku
* Na výšku

<figure><img src="/files/dJ9P02YeJpMc60y6OYel" alt="" width="100%"><figcaption></figcaption></figure>

### Vedlejší obrázek hero

Použijte vedlejší obrázek hero k zobrazení svého produktu nebo loga. Dvě dostupné konfigurace jsou:

* Na šířku
* Blok (obrázek se stejnou šířkou a výškou)

<figure><img src="/files/jqYz84yxVZfs8KJOJY3v" alt="" width="100%"><figcaption></figcaption></figure>

### Výzva k akci

Výzva k akci (CTA) je klikatelný text nebo tlačítko, které vybízí uživatele k akci, jako je nákup nebo návštěva jiné stránky. Prvky CTA by měly být jasné, orientované na akci a vizuálně výrazné pro zvýšení zapojení. Například „Koupit nyní“ podporuje nákupy.

<figure><img src="/files/dHYsoGoyKp69IMqrfoDy" alt="" width="100%"><figcaption></figcaption></figure>

## Typy umístění reklamy

Banner X podporuje různá strategická [umístění reklam](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) na webových stránkách prodejců, včetně:

* **Vyhledávání**: Zobrazujte reklamy, když zákazníci zadají v kampani nakonfigurované vyhledávací dotazy, například čokoláda. Další informace naleznete v části [Umístění ve vyhledávání](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search).
* **Kategorie**: Zobrazujte reklamy na stránkách kategorií souvisejících s vaším produktem. Cílejte na konkrétní kategorie poskytnutím relevantních podrobností o taxonomii, jako je `Category:Cupboard/Snacks`. Další informace naleznete v části [Umístění v kategoriích](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category).
* **Kategorie a vyhledávání**: Zobrazujte reklamy, když zákazníci navštíví stránku kategorie související s vašimi produkty nebo použijí nakonfigurované vyhledávací dotazy ve vaší kampani.
* **Křížový prodej v kategorii**: Umístění křížového prodeje v kategorii umožňují inzerentům cílit na doplňkové kategorie kromě výchozích kategorií jejich produktů. Tento přístup zvyšuje viditelnost produktů v souvisejících kategoriích, například prezentaci kávových produktů v sekci mléčných výrobků na webu prodece. Další informace naleznete v části [umístění křížového prodeje](https://help.citrusad.com/retail-media-interface/integration/cs/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements).
* **Volná shoda**: Zobrazujte reklamy na stránkách s vysokou návštěvností, které nejsou propojeny se konkrétními kategoriemi nebo vyhledávacími dotazy. Ideální pro obecné lokace, jako jsou domovské stránky nebo stránky pokladny. Další informace naleznete v části [Umístění s volnou shodou](https://help.citrusad.com/retail-media-interface/integration/cs/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements).

## Podporované formáty reklamních pozic

Banner X lze nasadit v následujících formátech:

* Jednoduchá dlaždice
* Dvojitá dlaždice
* Plný banner

<figure><img src="/files/lgtywsKj5vDMdLZIuV5s" alt="" width="100%"><figcaption></figcaption></figure>

## Implementace reklam typu banner X

Chcete-li nastavit reklamy typu banner X, postupujte podle následujících kroků:

### Krok 1: Kontrola obsahových standardů prodejce

Obsahové standardy jsou pokyny a technické parametry, které určují, jak se má Banner X reklama zobrazovat ve vyhrazeném prostoru na webové stránce nebo digitální platformě. Tyto standardy mohou zahrnovat:

* **Rozměry a velikost**: Specifikace přesné šířky a výšky banneru.
* **Formát souboru**: Akceptované formáty obrázků nebo videí, například JPEG, JPG, PNG, SVG nebo GIF.
* **Limit velikosti souboru**: Maximální povolená velikost souboru pro zajištění rychlého načítání a optimálního výkonu na webové stránce.
* **Rozlišení a kvalita**: Minimální požadavky na rozlišení, aby banner vypadal ostře a profesionálně.
* **Umístění a zarovnání**: Pokyny k tomu, jak by měl být banner zarovnán v rámci dostupného prostoru.
* **Omezení obsahu**: Pravidla pro to, jaký obsah může nebo nemůže být v banneru obsažen (např. žádný urážlivý obsah, zahrnutí povinných právních prohlášení).
* **Interaktivita**: Specifikace pro interaktivní prvky, jako jsou klikatelné oblasti, animace nebo události spouštěné uživatelem, pokud jsou použitelné.

Seznamte se s pokyny pro obsahové standardy prodejce a zahajte svou kampaň. Tyto pokyny obsahují ukázkové URL adresy, umístění na stránce a konkrétní omezení obsahu podkladů. Podrobné informace o dostupných pozicích pro banner X a jejich specifikacích vám poskytne váš Customer Integration Engineer (CIE). Zde je příklad:

<figure><img src="/files/mNMBGBIxY1L7qEGM0nlo" alt="" width="100%"><figcaption></figcaption></figure>

### Krok 2: Příprava reklamních podkladů

Vytvořte své reklamní podklady podle obsahových standardů prodejce. To zahrnuje prvky, jako je hlavní pozadí, vedlejší pozadí, obrázek hero a vedlejší obrázek hero. Použijte API [Získat podrobnosti obsahového standardu pro Banner X](/retail-media-interface/partner/cs/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) k získání podrobností o obsahovém standardu.

### Krok 3: Identifikace formátu reklamní pozice

Určete formát reklamní pozice pro vaše nasazení, kterým může být plný banner, jednoduchá dlaždice nebo dvojitá dlaždice.

### Krok 4: Nahrání reklamních podkladů

Po vytvoření reklamních podkladů a identifikaci formátu reklamní pozice je nahrajte pomocí [Nahrát reklamní podklad](/retail-media-interface/partner/cs/team-user-api/user-1/uploadfile-1.md) API. API vrací ID souboru a URL nahraného obrázku.

* **ID souborů**: ID souborů jsou vyžadována při vytváření kampaně s bannerem X. Pro každý typ podkladu, jako je hlavní pozadí, vedlejší pozadí, hlavního obrázek a vedlejší hlavní obrázek, musíte poskytnout konkrétní ID souboru.
* **URL**: URL se používá především k náhledu nahraného obrázku.

### (Volitelné) Krok 5: Získání veřejné URL obrázku

Použijte [API pro získání URL souboru](/retail-media-interface/partner/cs/campaign-management-api/creativeassets/getcampaignfileurl.md) ke získání veřejné URL obrázku. Tuto URL můžete použít k ověření nebo sdílení obrázku se zainteresovanými stranami.

### Krok 6: Vytvoření kampaně s bannerem X

Vytvořte kampaň s bannerem X pomocí [Vytvoření kampaně s bannerem X](/retail-media-interface/partner/cs/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) API. Ujistěte se, že máte `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`a `secondaryHeroImageId`což jsou ID souborů vrácená z [Nahrát reklamní podklad](/retail-media-interface/partner/cs/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/cs/campaign-management-api/bannerxcampaign-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.
