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

# Banner X kampány

Banner X a válaszkész, több komponensű bannerhirdetések széles választékát kínálja, amelyek a kiskereskedők webhelyeibe zökkenőmentesen integrálódva javítják az online vásárlási élményt. Epsilon Retail Media biztosítja a komponenseket, míg a kiskereskedő frontendje kezeli a stílust a webhely e-kereskedelmi dizájnjával való konzisztencia biztosítása érdekében. Ez a megközelítés segít megőrizni a márka integritását, miközben hatékonyan bevonja a vásárlókat.

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

## Fő előnyök

* **Natív integráció**: A hirdetések természetes módon illeszkednek a termék-körhintákba, megőrizve a webhely stílusát.
* **Személyre szabás**: Szállítson valós időben személyre szabott, a felhasználó érdeklődési köréhez igazított hirdetéseket.
* **Fokozott elköteleződés**: Növelje a termék láthatóságát, ösztönözze az ügyfelek elköteleződését, és növelje az eladásokat meggyőző CTA-kkal.

## Banner X komponensek

Ismerje meg a(z) X banner komponenseit, hogy a dizájn megfeleljen a kiskereskedő szabványainak. Működés és a vizuális konzisztencia fenntartása szempontjából mindegyik komponens elengedhetetlen.

### Elsődleges háttérkép

Az elsődleges háttér egy egyszerű háttér, amely biztosítja a dizájn tisztaságát és konzisztenciáját az eszközök között. Kerülje a termékképek beágyazását vagy a tartalom elnyomását, hogy megelőzze a levágási problémákat, különösen a különböző eszközökön és böngészőszélességeknél. A hat elérhető elsődleges háttérkonfiguráció a következő:

* Ismétlődő
* Kitöltés
* Felülre igazított
* Alulra igazított
* Jobbra igazított
* Balra igazított

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

### Másodlagos háttérkép

Használja a másodlagos háttérképet a banner további díszítéséhez. A hat elérhető másodlagos bannerkonfiguráció a következő:

* Ismétlődő
* Kitöltés
* Felülre igazított
* Alulra igazított
* Jobbra igazított
* Balra igazított

### Banner szövege

A banner szövege a bannerhirdetésen megjelenő szöveg, amely támogatja az korlátozott HTML-tageket, mint például a `strong` a félkövérhez és a `i` a dőlthöz. A szöveg színét is testreszabhatja. Például,

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

### Hero kép

A Hero kép a fő promóciós kép, amelyet általában a termék vagy a logó megjelenítésére használnak. A Hero képhez elérhető két konfiguráció a következő:

* Fekvő
* Álló

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

### Másodlagos hero kép

Használja a másodlagos hero képet a termék vagy a logó megjelenítésére. A két elérhető konfiguráció a következő:

* Fekvő
* Blokk (azonos szélességű és magasságú kép)

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

### Call-to-action

A call-to-action (CTA) egy kattintható szöveg vagy gomb, amely cselekvésre ösztönzi a felhasználókat, például vásárlásra vagy egy másik oldal meglátogatására. A CTA-knak egyértelműnek, cselekvésorientáltnak és vizuálisan kiemelkedőnek kell lenniük az elköteleződés növelése érdekében. Például a "Vásároljon most" vásárlásra ösztönöz.

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

## Hirdetéselhelyezési típusok

Banner X különféle stratégiai [hirdetéselhelyezéseket](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) támogat a kiskereskedelmi webhelyeken, beleértve a következőket:

* **Keresés**: Hirdetések megjelenítése, amikor a vásárlók a kampányában beállított keresési kifejezéseket adnak meg, például csokoládé. További információért lásd: [Keresési elhelyezések](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search).
* **Kategória**: Hirdetések megjelenítése a termékéhez kapcsolódó kategóriaoldalakon. Célozzon meg konkrét kategóriákat releváns taxonómiai adatok megadásával, mint például `Category:Cupboard/Snacks`. További információért lásd: [Kategória elhelyezések](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category).
* **Kategória és keresés**: Hirdetések megjelenítése, amikor a vásárlók a termékeihez kapcsolódó kategóriaoldalt látogatnak meg, vagy a kampányában beállított keresési kifejezéseket használják.
* **Kategóriák közötti keresztértékesítés**: A kategóriák közötti keresztértékesítési elhelyezések lehetővé teszik a hirdetők számára, hogy a termékeik alapértelmezett kategóriáin kívül kiegészítő kategóriákat is megcélozzanak. Ez a megközelítés növeli a termékek láthatóságát a kapcsolódó kategóriákban, például a kávétermékek bemutatását egy kiskereskedő webhelyének tejtermék részlegén. További információért lásd: [keresztértékesítési elhelyezések](https://help.citrusad.com/retail-media-interface/integration/hu/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements).
* **Általános egyezés**: Hirdetések megjelenítése olyan nagy forgalmú oldalakon, amelyek nem kapcsolódnak konkrét kategóriákhoz vagy keresési kifejezésekhez. Ideális olyan általános helyekre, mint a kezdőlapok vagy a pénztároldalak. További információért lásd: [Általános egyezésű elhelyezések](https://help.citrusad.com/retail-media-interface/integration/hu/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements).

## Támogatott hirdetéshely-formátumok

Banner X a következő formátumokban telepíthető:

* Egyetlen csempe
* Dupla csempe
* Teljes banner

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

## X bannerhirdetések megvalósítása

Az X bannerhirdetések beállításához kövesse az alábbi lépéseket:

### 1. lépés: Tekintse át a kiskereskedő tartalomra vonatkozó szabványait

A tartalmi szabványok olyan irányelvek és műszaki paraméterek, amelyek meghatározzák, hogyan kell egy Banner X hirdetést megjeleníteni egy webhely vagy digitális platform kijelölt helyén. Ezek a szabványok a következőket tartalmazhatják:

* **Méretek**: A banner pontos szélességére és magasságára vonatkozó specifikációk.
* **Fájlformátum**: Elfogadott kép- vagy videófájl-formátumok, például JPEG, JPG, PNG, SVG vagy GIF.
* **Fájlméret-korlát**: A maximálisan megengedett fájlméret a gyors betöltési idő és az optimális teljesítmény biztosítása érdekében a weboldalon.
* **Felbontás és minőség**: Minimális felbontási követelmények annak biztosítására, hogy a banner éles és professzionális megjelenésű legyen.
* **Pozicionálás és igazítás**: Irányelvek arra vonatkozóan, hogyan kell a bannert elhelyezni a rendelkezésre álló helyen.
* **Tartalmi korlátozások**: Szabályok arra vonatkozóan, hogy milyen tartalom szerepelhet vagy nem szerepelhet a bannerben (pl. nincs sértő tartalom, kötelező jogi nyilatkozatok feltüntetése).
* **Interaktivitás**: Az interaktív elemekre vonatkozó specifikációk, mint például a kattintható területek, animációk vagy felhasználó által kiváltott események, ha alkalmazhatók.

Ismerkedjen meg a kiskereskedő tartalomra vonatkozó szabványainak irányelveivel a kampány elindításához. Ezek az irányelvek példa URL-eket, oldali pozicionálást és konkrét vizuális tartalmi korlátozásokat tartalmaznak. Forduljon ügyfél-integrációs mérnökéhez (CIE) a rendelkezésre álló X bannerhelyekről és azok specifikációiról szóló részletes információkért. Íme egy példa:

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

### 2. lépés: Kreatív anyagok előkészítése

Készítse el kreatív anyagait a kiskereskedő tartalmi szabványainak megfelelően. Ez magában foglalja az olyan elemeket, mint az elsődleges háttér, a másodlagos háttér, a hero kép és a másodlagos hero kép. Használja a [Get Banner X content standard details](/retail-media-interface/partner/hu/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) API-t a tartalmi szabvány részleteinek lekéréséhez.

### 3. lépés: Az hirdetéshely-formátum azonosítása

Határozza meg a telepítéshez használt hirdetéshely-formátumot, amely lehet teljes banner, egyetlen csempe vagy dupla csempe.

### 4. lépés: A kreatív anyagok feltöltése

A kreatív anyagok létrehozása és a hirdetéshely-formátum azonosítása után töltse fel azokat a következőt használva: [Upload the creative asset](/retail-media-interface/partner/hu/team-user-api/user-1/uploadfile-1.md) API. Az API visszaadja a feltöltött kép fájlazonosítóját és URL-jét.

* **Fájlazonosítók**: A fájlazonosítók szükségesek a banner X kampány létrehozásához. Minden eszköztípushoz (például az elsődleges háttérhez, a másodlagos háttérhez, a hero képhez és a másodlagos hero képhez) meg kell adnia egy konkrét fájlazonosítót.
* **URL**: Az URL elsősorban a feltöltött kép előnézetének megtekintésére szolgál.

### (Opcionális) 5. lépés: A kép nyilvános URL-jének lekérése

Használja a [fájl URL-jének lekérése API-t](/retail-media-interface/partner/hu/campaign-management-api/creativeassets/getcampaignfileurl.md) a kép nyilvános URL-jének megszerzéséhez. Ezt az URL-t használhatja a kép ellenőrzésére vagy megosztására az érintettekkel.

### 6. lépés: Hozzon létre egy banner X kampányt

Hozzon létre egy banner X kampányt a következőt használva: [Banner X kampány létrehozása](/retail-media-interface/partner/hu/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) API segítségével. Győződjön meg arról, hogy rendelkezik a következőkkel: `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`, és `secondaryHeroImageId`amelyek a következők által visszaadott fájlazonosítók: [Upload the creative asset](/retail-media-interface/partner/hu/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/hu/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.
