> 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/product-ad-reference-1.md). # Referencia pre produktovú reklamu Nižšie sú uvedené vlastnosti, ktoré sú možné v štandardnej požiadavke, a odpoveď, ktorú dostanete, ak získate reklamu. ## Požadované položky | String | Popis | Povinné/voliteľné | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | `catalogId` | Váš identifikátor katalógu produktov 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. Viac informácií nájdete v časti Filtrovanie generovania reklám. | Voliteľné, preferované | | `maxNumberOfAds` | Maximálny počet reklám, ktoré chcete vrátiť, až do 10. | Povinné | | `options` |

Voliteľný spôsob definovania štruktúry vašej požiadavky. Viac informácií nájdete v časti Filtrovanie generovania reklám.

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 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. Viac informácií nájdete v časti Možnosti pracovného postupu integrácie. | Vyžaduje sa pri štandardných integráciách | | `memoryToken` |

Používa sa na stránkovanie. Použite token poskytnutý v predchádzajúcej požiadavke na reklamu, aby sa zabezpečilo, Epsilon Retail Media zobrazuje vašim zákazníkom iba nové reklamy.

Ak je poskytnutý, Epsilon Retail Media vylúči zoznam skôr zobrazených reklám v odpovedi na reklamu. Prečítajte si Stránkovanie aby ste sa dozvedeli viac.

| Voliteľné | | `dtmCookieId` | Súbory cookie vytvorené a uložené webovou lokalitou, ktoré sa používajú 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é je len použitie [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 | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.customPayload` |

Tento vlastný payload, ktorý by mal byť prepojený zo súboru katalógu do generovania reklamy.

Pole by malo obsahovať platný objekt JSON serializovaný do poľa bajtov a zakódovaný do Base64. Objekt JSON by mal zodpovedať schéme.

| Vlastné podľa integrácie | | `ads.sellerId` | Unikátne Id predajcu. Populačne sa vyplní len vtedy, ak je sellerId nastavené v tíme. sellerIds sa zvyčajne používajú pri registrácii predajcov na trhovisku. | `73nns-32sxr-32ss` Vlastné podľa integrácie | | `ads.id` |

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

| `display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4` | | `ads.gtin` | Kód produktu reklamy. Toto bude kód produktu synchronizovaný vo vašom katalógu produktov. | `25813383` | | `ads.discount` | Zastarané, možno ignorovať. | `{
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
}` | | `ads.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 typu Fixné umiestnenie. | 1 | | `ads.memoryToken` |

Používa sa na stránkovanie a spájanie požiadaviek na reklamu.

Ak je poskytnutý vo vašej ďalšej požiadavke na reklamu pre rovnaký kontext, Epsilon Retail Media vylúči zoznam skôr zobrazených reklám v odpovedi na reklamu. Prečítajte si Stránkovanie aby ste sa dozvedeli viac.

| | | `ads.metadata` |

Objekt obsahujúci informácie o inzerentovi potrebné na pomoc inzerentom dodržiavať miestne právne predpisy o reklame, ako napríklad Zákon o digitálnych službáchv Európe.

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

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

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `banners` | Skladá sa z bannerových objektov. Pozrite si [Odkaz na bannerovú reklamu (statickú)](/retail-media-interface/integration/sk/references/banner-ad-static-reference.md) aby ste sa dozvedeli viac. | `"banners": [],` | | `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/product-ad-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.