> 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/hu/references/banner-x-reference-1.md). # Banner X referencia Az alábbiakban a szabványos kérésben lehetséges tulajdonságok találhatók, amelyeket a(z) [Hirdetések kérése](/retail-media-interface/integration/hu/generating-ads/banner-x-responsive/requesting-banner-x-ads.md) fejezet részletez a kéréséhez, valamint a válasz, ha hirdetést kap. ## Kért elemek | Karakterlánc | Leírás | Kötelező/Opcionális | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | | `BannerSlotIds` | A kért bannerhely slotId-jainak JSON-tömbje. | Kötelező | | `catalogId` | A webhelyéhez tartozó termékkatalógus-azonosító. | Kötelező | | `contentStandardId` | A webhelyéhez tartozó tartalom-standard azonosító. | Kötelező | | `customerId` | A hirdetésekkel kiszolgált ügyfél egyedi azonosítója. | Opcionális | | `filterMode` | Opcionális módja a kérés szerkezetének meghatározására. Lásd a(z) [Hirdetésgenerálási szűrés](/retail-media-interface/integration/hu/data-api/api-overview/ad-generation-filtering-1.md) részt további információkért. | Opcionális, preferált | | `maxNumberOfAds` | Az egyes bannerhelyek maximális száma, amelyet vissza szeretne kapni. | Kötelező | | `options` |

Opcionális módja a kérés szerkezetének meghatározására. Lásd a Hirdetésgenerálási szűrés részt további információkért.

Ez az az objektum is, ahol hirdetői információkat kérhet az olyan helyi hirdetési jogszabályoknak való megfelelés érdekében, mint Európában a Digitális szolgáltatásokról szóló jogszabály .

| Opcionális, preferált | | `placement` | Az egyedi elhelyezés, amelyhez hirdetéseket kér. | Kötelező | | `productFilters` | A kéréséhez kapcsolódó bármely termékszűrő. Például kategória-, hely- vagy méretszűrő. | Kategóriaelhelyezéseknél kötelező | | `searchTerm` | Az ügyfél által a webhelyén megadott keresési kifejezés. | Keresési elhelyezéseknél kötelező | | `sessionId` | Az ügyfél munkamenetének egyedi azonosítója. Szabványos integrációkban az attribúcióhoz használatos. Tekintse át a következőt: [Integrációs munkafolyamat-opciók](/retail-media-interface/integration/hu/data-api/api-overview/integration-workflow-options-1.md)részt további információkért. | Szabványos integrációkban kötelező | | `slotId` | Ez tartalmazza a kontextusban kért összes SlotId-t. Egy vagy több is lehet. | Kötelező | | `dtmCookieId` | A webhely által létrehozott és tárolt sütik, amelyeket a felhasználói viselkedés nyomon követésére használnak ugyanazon a tartományon. | Opcionális | | `audience` | Meghatározza azokat a specifikus célközönség-szegmenseket, amelyekhez a vásárló tartozik. Csak akkor releváns, ha a következőt használja: [Célközönség-célzás 3. opció](/retail-media-interface/integration/hu/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Opcionális | ## Visszaküldött elemek | Karakterlánc | Leírás | Példa érték | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.backgroundColour` | A banner háttérszíne - csak HEX értékek. | `6e6c6c` | | `ads.backgroundImage` | A banner háttérképének képlinkje. | `[]\() | | `ads.backgroundImagePosition` | Ez határozza meg a háttérkép pozíciójának típusát. Ha nincs érték, az alapértelmezett értékre kell váltania: `leftaligned` . |

leftaligned
rightaligned
fill
repeating

| | `ads.bannerText` | A bannerben megjelenített szöveg. HTML-tageket is tartalmazhat | `Double Fudge Ice Cream` | | `ads.bannerTextColour` | A banner szövegszíne - csak HEX értékek. A Citrus nem küldi a következőt: `#`. | `1dc711` | | `ads.citrusAdId` |

A hirdetés egyedi azonosítója.
Ez egyedi minden egyes kérésnél, amely a következőhöz érkezik: Epsilon Retail Media és nem gyorsítótárazható.

| `shotgun_wIpZraEXcIu0daC5YMQewPil2S83NzE0MTA3` | | `ads.citrusCampaignName` | A hirdetés kampányneve. | `Epsilon-Example-Category-Banner-X-Ad-ae536b0d5c3ded28ea624ab4285facd6` | | `ads.citrusContentStandardId` | A slothelyhez kapcsolódó tartalom-standard azonosító. | `8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c` | | `ads.citrusExpiry` | A hirdetés lejárata. Ez a legkésőbbi időpont, amikor egy kattintás még jelenthető a következőknek: Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` | | `ads.citrusSlotId` | A kért banner specifikus slotjának azonosítója. | `Category_Top` | | `ads.contentStandardId` | A slothelyhez kapcsolódó tartalom-standard azonosító. A következő duplikátuma: `citrusContentStandardId` | `8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c` | | `ads.ctaFlag` | Ez határozza meg, hogy megjelenjen-e a CTA vagy sem. |

true
false

| | `ads.ctaLink` | A CTA-ról továbbított URL (ez olyan, mint a bannerhelyek linkUrl-je). Csak akkor kerül kiszolgálásra, ha a ctaFlag értéke `true` | ` | | `ads.ctaText` | A CTA-n belüli szöveg. | `Shop now` | | `ads.ctaTextAccessibility` | A CTA kisegítő lehetőségek szerinti szövege a képernyőolvasót használók számára. | `for Double Fudge Ice Cream` | | `ads.gtins` |

Legfeljebb 20 termékkódból álló tömb a kampány hirdetett termékei közül kiválasztva.

A kiskereskedők ezt a listát használhatják a listarészletező oldalak automatizálására a bannerre kattintáskor, vagy bizonyos renderelési funkciók (jelvények, árazás, másodlagos készletszint-ellenőrzés) automatizálására.

| `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` | | `ads.headingText` | Címsorszöveg a képernyőolvasót használók számára. | `Banner Advertisement for Fudge Double Ice Cream with a product image and shop now button` | | `ads.heroImageAltText` | Alternatív szöveg a fő képhez (hero image) abban a ritka esetben, ha nem jelenik meg. | `Image of double fudge iced cream` | | `ads.heroImage` | A banner fő képének (hero image) képlinkje. | `[]\() | | `ads.position` | A banner pozíciója a következőkben: Epsilon Retail Media válasz. Ezt a pozíciót tiszteletben kell tartania Fix elhelyezés kampányok használata esetén. | 1 | | `ads.secondaryBackgroundImage` | A másodlagos háttérkép képlinkje. | `[]\() | | `ads.secondaryBackgroundImagePosition` | Ez határozza meg a másodlagos háttérkép pozíciójának típusát. |

leftaligned
rightaligned

| | `ads.secondaryHeroImageAltText` | A másodlagos kiemelt kép alternatív szövege arra a ritka esetre, ha nem jelenne meg. | `Image of [brand] logo` | | `ads.secondaryHeroImage` | A másodlagos kiemelt kép képhivatkozása. | `[]\() | | `ads.secondaryHeroMode` | Ez határozza meg a másodlagos kiemelt kép megjelenítési módját. Ha nincs értéke, az alábbi alapértelmezést kell használnia: `block` . |

block
landscape

| | `ads.slotId` | A kért banner hely-azonosítója (slot ID). Több banner kérése esetén ez használható a kért azonosítókra való hivatkozáshoz. | `Category_Top` | | `ads.tags` | Ez a mező a hirdető által a kampányában megadott harmadik féltől származó címkéket adja vissza. A x banner jelenleg nem támogatja ezt, bár az API-válasz formázva van. | `{}` | | `ads.sellerId` | Az eladó egyedi ID-ja. Csak akkor van kitöltve, ha be van állítva a sellerId egy csapatnál. A sellerId-kat jellemzően a marketplace eladók bevezetésekor használják. | `73nns-32sxr-32ss` Integrációnként egyedi | | `ads.metadata` |

A hirdetői információkat tartalmazó objektum, amely segít a hirdetőknek megfelelni a helyi hirdetési jogszabályoknak, mint például a Digitális szolgáltatásokról szóló jogszabály Európában.

advertiser a beszállítói csapatban lévő Cégnévből származik.

onBehalfOf a beszállítói csapatban lévő Hirdetés finanszírozójából származik.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `ads.adm` | A videóhirdetés részleteit – beleértve a VAST-címkéket is – tartalmazó objektum. | "\n\\n \\n \\n \Epsilon Retail Media\\n \!\[CDATA\[]] \\n \\n \!\[CDATA\[]] \\n \\\n \\\n \\n \VAST-4.0-Short-Intro.mp4\\n \\n \\n \VAST-4.0-Short-Intro.mp4\\n \\n \\\n \\n \!\[CDATA\[]] \\n \!\[CDATA\[]] \\n \\n \\n \!\[CDATA\[]] \\n \\\n \\n \\n \\n \\n \\n \\n\" | | `ads.companionProducts` | Kísérőtermékek részletei. |

“companionProducts”: \[
"Banana14-simfk15"
"Oranges5-qgxeb6",
"Incaberries20-ppscn21"

| | `metadata.warnings` | A hirdetési kéréssel kapcsolatos figyelmeztető információkat tartalmazó objektum. Jelenleg csak akkor ad figyelmeztetést, ha a szegmensek maximális számát meghaladják. | `"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of {maxSegmentIds} and were truncated"
]
}` | {% hint style="info" %} Ha egy mező nincs beállítva a hirdetés kampányának részeként, nem kerül kiszolgálásra. Vagyis ha a hirdető nem állított be `heroImage`, Epsilon Retail Media akkor nem fogja kiszolgálni a követezőt: `heroImage` tulajdonság. {% endhint %} --- # 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/hu/references/banner-x-reference-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.