> 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-ad-static-reference.md).
# Referencia pre bannerovú reklamu (statickú)
Nižšie sú uvedené vlastnosti, ktoré sú možné v štandardnej požiadavke, ako je popísané v [Požadovanie bannerových reklám](/retail-media-interface/integration/sk/generating-ads/banner-ads-static/requesting-banner-ads.md) pre vašu požiadavku a odpoveď, ak dostanete reklamu.
{% hint style="info" %}
Bannerové reklamy sa požadujú na rovnakom `/generate` koncovom bode ako produktové reklamy. Jednu požiadavku je možné použiť na získanie oboch typov reklám.
{% endhint %}
## Požadované položky
| String | Popis | Povinné/voliteľné |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| `bannerSlots` | Pole bannerových pozícií, pre ktoré si želáte dostávať bannerové reklamy. Určením maxNumberOfAds pre bannerové pozície môžete získať viac ako jeden banner pre danú pozíciu. Takýto prípad použitia by bol pre umiestnenia typu karusel. | Povinné |
| `bannerSlotIds` | Pole bannerových pozícií, pre ktoré si želáte dostávať bannerové reklamy | Povinné, nahradené bannerSlots |
| `catalogId` | Váš identifikátor produktového katalógu pre vašu webovú lokalitu. | Povinné |
| `contentStandardId` | Identifikátor štandardu 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 produktových reklám, ktoré chcete vrátiť, až do 15. | Povinné, umožňuje poskytovať produktové reklamy v rovnakej požiadavke. Ak nechcete žiadne produktové reklamy, nastavte na `0` |
| `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žadovať informácie o inzerentovi, aby ste vyhoveli miestnej legislatíve o reklame, ako je európsky Akt o digitálnych službách .
| Voliteľné, preferované |
| `placement` | Unikátne umiestnenie, pre ktoré požadujete reklamy. | Povinné |
| `productFilters` | Akékoľvek produktové filtre relevantné pre vašu požiadavku. Napríklad kategória, lokalita alebo veľkosť. | Povinné |
| `sessionId` | Unikátny identifikátor relácie zákazníka. Používa sa na atribuciu v štandardných integráciách. Pre viac informácií si pozrite možnosti pracovného postupu integrácie. | Vyžaduje sa v štandardných integráciách |
| `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í [Cielenie na publikum – možnosť 3](/retail-media-interface/integration/sk/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Voliteľné |
## Vrátené položky
| String | Popis | Príklad hodnoty |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `banners.altText` | Alternatívny text pre hlavný obrázok (hero image) v zriedkavom prípade, že sa nezobrazí. | `Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.` |
| `banners.contentStandardId` | Identifikátor štandardu obsahu pre vašu webovú lokalitu. | \`4ffb80ba-b9a9-4567-8069-79b2eca93473 |
| `banners.expiry` | Expirácia reklamy. Toto je najneskorší moment, kedy je možné nahlásiť kliknutie pre Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` |
| `banners.id` | Unikátne ID reklamy.
Toto je unikátne pre každú požiadavku odoslanú na Epsilon Retail Media a nie je možné ho ukladať do vyrovnávacej pamäte.
| `banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=` |
| `banners.imageUrl` | Odkaz na obrázok bannera. | `[]\() |
| `banners.gtins` | Pole až 20 kódov produktov vybraných z propagovaných produktov kampane. | `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` |
| `banners.linkUrl` | URL adresa presmerovaná z bannera, keď zákazník klikne na banner. | ` |
| `banners.slotId` | ID konkrétnej pozície pre banner, ktorú ste požadovali. | `Category_Top` |
| `banners.tags` | Toto pole vracia akékoľvek značky tretích strán zadané inzerentom v jeho kampani. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` |
| `banners.text` | Používa sa v riadkových integráciách na mieru ako dodatočné textové pole. | |
| `banners.position` | Pozícia reklamy 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 |
| `banners.sellerId` | Unikátne ID predajcu. Populuje sa len vtedy, ak je sellerId nastavené v tíme. sellerId sa zvyčajne používajú pri registrácii predajcov na trhovisku. | `73nns-32sxr-32ss` Vlastné pre každú integráciu |
| `banners.metadata` | Objekt obsahujúci informácie o inzerentovi potrebné na to, aby inzerentom pomohol dodržiavať miestnu legislatívu o reklame, ako je napríklad Akt 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"
}
...` |
| `metadata.warnings` | Objekt obsahujúci varovné informácie o požiadavke na 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 100 and were truncated"
]
}` |
---
# 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-ad-static-reference.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.