> 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/sk/references/banner-x-reference-1.md). # Referencia pre banner X Nižšie sú uvedené vlastnosti, ktoré sú možné v štandardnej požiadavke, ako je popísané v [Požadovanie reklám](/retail-media-interface/integration/sk/generating-ads/banner-x-responsive/requesting-banner-x-ads.md) pre vašu požiadavku a odpoveď, ak dostanete reklamu. ## Požadované položky | Retezec (String) | Popis | Povinné/voliteľné | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | `BannerSlotIds` | Pole typu JSON s bannerovými slotId, ktoré sú požadované. | Povinné | | `catalogId` | Identifikátor vášho katalógu produktov pre vašu webovú lokalitu. | Povinné | | `contentStandardId` | Standardný identifikátor obsahu pre vašu webovú lokalitu. | Povinné | | `customerId` | Unikátny identifikátor pre zákazníka, ktorému sa zobrazujú reklamy. | Voliteľné | | `filterMode` | Voliteľný spôsob definovania štruktúry vašej požiadavky. Pozrite si [Filtrovanie generovania reklám](/retail-media-interface/integration/sk/data-api/api-overview/ad-generation-filtering-1.md) pre viac informácií. | Voliteľné, preferované | | `maxNumberOfAds` | Maximálny počet z každej bannerovej pozície, ktorý chcete vrátiť. | Povinné | | `options` |

Voliteľný spôsob definovania štruktúry vašej požiadavky. Pozrite si Filtrovanie generovania reklám pre viac informácií.

Toto je tiež objekt, v ktorom môžete požiadať o informácie o inzerentovi, aby ste vyhoveli miestnej legislatíve o reklame, ako je európsky Zákon o digitálnych službách .

| Voliteľné, preferované | | `placement` | Unikátne umiestnenie, pre ktoré požadujete reklamy. | Povinné | | `productFilters` | Akékoľvek filtre produktov relevantné pre vašu požiadavku. Napríklad filter kategórie, lokality alebo veľkosti. | Vyžaduje sa pre umiestnenia v kategórii | | `searchTerm` | Hľadaný výraz zadaný vaším zákazníkom na vašej webovej lokalite. | Vyžaduje sa pre umiestnenia vo vyhľadávaní | | `sessionId` | Unikátny identifikátor relácie zákazníka. Používa sa na atribúciu v štandardných integráciách. Pozrite si [Možnosti integračného pracovného postupu](/retail-media-interface/integration/sk/data-api/api-overview/integration-workflow-options-1.md)pre viac informácií. | Vyžaduje sa v štandardných integráciách | | `slotId` | Toto obsahuje akékoľvek požadované SlotId v kontexte. Môže ich byť jedno alebo viac. | Povinné | | `dtmCookieId` | Súbory cookie vytvorené a uložené webovou lokalitou, používané na sledovanie správania používateľov na rovnakej doméne. | Voliteľné | | `audience` | Špecifikuje konkrétne segmenty publika, do ktorých kupujúci patrí. Relevantné len pri použití [Možnosť cielenia na publikum 3](/retail-media-interface/integration/sk/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Voliteľné | ## Vrátené položky | Retezec (String) | Popis | Príklad hodnoty | | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.backgroundColour` | Farba pozadia bannera – iba hodnoty HEX. | `6e6c6c` | | `ads.backgroundImage` | Odkaz na obrázok pozadia bannera. | `[]\() | | `ads.backgroundImagePosition` | Definuje typ pozície obrázka na pozadí. Ak nie je zadaná žiadna hodnota, budete musieť použiť predvolenú hodnotu `leftaligned` . |

leftaligned
rightaligned
fill
repeating

| | `ads.bannerText` | Text zobrazený v bannery. Môže obsahovať značky HTML | `Double Fudge Ice Cream` | | `ads.bannerTextColour` | Farba textu bannera – iba hodnoty HEX. Citrus neodosiela `#`. | `1dc711` | | `ads.citrusAdId` |

Unikátne id reklamy.
Toto je unikátne pre každú požiadavku odoslanú na Epsilon Retail Media a nemožno to ukladať do vyrovnávacej pamäte.

| `shotgun_wIpZraEXcIu0daC5YMQewPil2S83NzE0MTA3` | | `ads.citrusCampaignName` | Názov kampane reklamy. | `Epsilon-Example-Category-Banner-X-Ad-ae536b0d5c3ded28ea624ab4285facd6` | | `ads.citrusContentStandardId` | Štandardné id obsahu súvisiace s pozíciou. | `8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c` | | `ads.citrusExpiry` | Exspirácia reklamy. Toto je najneskorší moment, kedy je možné nahlásiť kliknutie na Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` | | `ads.citrusSlotId` | Id konkrétnej pozície pre banner, ktorý ste požadovali. | `Category_Top` | | `ads.contentStandardId` | Štandardné id obsahu súvisiace s pozíciou. Duplikát `citrusContentStandardId` | `8jsuwnfwe-1435-460b-9d2b-5d838e3dba9c` | | `ads.ctaFlag` | Definuje, či sa zobrazuje CTA alebo nie. |

true
false

| | `ads.ctaLink` | URL presmerovaná z CTA (toto je ako linkUrl pre bannery). Poskytuje sa len vtedy, ak ctaFlag je `true` | ` | | `ads.ctaText` | Text v rámci CTA. | `Shop now` | | `ads.ctaTextAccessibility` | Text prístupnosti pre CTA pre používateľov čítačiek obrazovky. | `for Double Fudge Ice Cream` | | `ads.gtins` |

Pole až 20 kódov produktov vybraných z inzerovaných produktov kampane.

Maloobchodníci môžu tento zoznam použiť na automatizáciu stránok so zoznamom produktov po kliknutí na banner alebo na automatizáciu určitej funkčnosti vykresľovania (odznaky, tvorba cien, sekundárna kontrola skladových zásob).

| `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` | | `ads.headingText` | Text nadpisu pre používateľov čítačiek obrazovky. | `Banner Advertisement for Fudge Double Ice Cream with a product image and shop now button` | | `ads.heroImageAltText` | Alternatívny text pre hlavný obrázok (hero image) v zriedkavých prípadoch, keď sa nezobrazí. | `Image of double fudge iced cream` | | `ads.heroImage` | Odkaz na hlavný obrázok (hero image) bannera. | `[]\() | | `ads.position` | Pozícia bannera v Epsilon Retail Media odpovedi. Túto pozíciu by ste mali rešpektovať v prípade, že sa využívajú kampane s fixným umiestnením. | 1 | | `ads.secondaryBackgroundImage` | Odkaz na sekundárny obrázok pozadia. | `[]\() | | `ads.secondaryBackgroundImagePosition` | Týmto sa definuje typ pozície sekundárneho obrázka na pozadí. |

leftaligned
rightaligned

| | `ads.secondaryHeroImageAltText` | Alternatívny text pre sekundárny hlavný obrázok hero v zriedkavom prípade, že sa nezobrazí. | `Image of [brand] logo` | | `ads.secondaryHeroImage` | Odkaz na sekundárny hlavný obrázok hero. | `[]\() | | `ads.secondaryHeroMode` | Týmto sa definuje režim zobrazenia sekundárneho hlavného obrázka hero. Ak hodnota chýba, budete musieť použiť ako predvolenú hodnotu `block` . |

block
landscape

| | `ads.slotId` | ID pozície pre banner, o ktorý ste požiadali. Pri žiadosti o viacero bannerov sa to môže použiť na odkazovanie na požadované ID. | `Category_Top` | | `ads.tags` | Toto pole vracia akékoľvek tagy tretích strán zadané inzerentom v jeho kampani. V súčasnosti to banner x nepodporuje, hoci odpoveď API je formátovaná. | `{}` | | `ads.sellerId` | Unikátne Id predajcu. Vačšinou sa vyplní len vtedy, ak je na tíme nastavené sellerId. sellerIds sa zvyčajne používajú pri registrácii predajcov na trhovisku. | `73nns-32sxr-32ss` Vlastné podľa integrácie | | `ads.metadata` |

Objekt obsahujúci informácie o inzerentovi potrebné na to, aby inzerenti spĺňali miestne právne predpisy o reklame, ako je napríklad Zákon o digitálnych službách v Európe.

advertiser sa preberá z názvu spoločnosti v tíme dodávateľa.

onBehalfOf sa preberá od Financovateľa reklamy v tíme dodávateľa.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `ads.adm` | Objekt obsahujúci podrobnosti o video reklame vrátane tagov VAST. | "\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` | Podrobnosti o sprievodných produktoch. |

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

| | `metadata.warnings` | Objekt obsahujúci varovné informácie o žiadosti o reklamu. V súčasnosti varuje iba vtedy, ak je prekročený maximálny počet segmentov. | `"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of {maxSegmentIds} and were truncated"
]
}` | {% hint style="info" %} Ak pole nie je nakonfigurované ako súčasť kampane reklamy, nebude sa zobrazovať. t. j. ak inzerent nenakonfiguroval `heroImage`, Epsilon Retail Media nebude zobrazovať vlastnosť `heroImage` . {% 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/sk/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.