> 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/cs/references/banner-ad-static-reference.md).
# Referenční příručka statické bannerové reklamy
Níže jsou popsány vlastnosti možné v standardním požadavku, jak je popsáno v [Žádost o bannerové reklamy](/retail-media-interface/integration/cs/generating-ads/banner-ads-static/requesting-banner-ads.md) pro váš požadavek a odpověď, pokud obdržíte reklamu.
{% hint style="info" %}
Bannerové reklamy se požadují na stejném `/generate` koncovém bodě jako produktové reklamy. Jediný požadavek lze použít k získání obou typů reklam.
{% endhint %}
## Požadované položky
| Řetězec | Popis | Povinné/volitelné |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `bannerSlots` | Pole bannerových pozic, pro které chcete obdržet bannerové reklamy. Zadáním maxNumberOfAds pro bannerové pozice můžete pro danou pozici získat více než jeden banner. Takový případ použití by byl pro umístění typu karusel. | Povinné |
| `bannerSlotIds` | Pole bannerových pozic, pro které chcete obdržet bannerové reklamy | Povinné, nahrazeno polem bannerSlots |
| `catalogId` | Váš identifikátor katalogu produktů pro vaše webové stránky. | Povinné |
| `contentStandardId` | Standardní identifikátor obsahu pro vaše webové stránky. | Povinné |
| `customerId` | Unikátní identifikátor zákazníka, kterému se zobrazují reklamy. | Volitelné |
| `filterMode` | Volitelný způsob definování struktury vašeho požadavku. Viz [Filtrování generování reklam](/retail-media-interface/integration/cs/data-api/api-overview/ad-generation-filtering-1.md) pro více informací. | Volitelné, preferované |
| `maxNumberOfAds` | Maximální počet produktových reklam, které chcete vrátit, až do 15. | Povinné, umožňuje doručování produktových reklam ve stejném požadavku. Pokud nejsou požadovány žádné produktové reklamy, nastavte na `0` |
| `options` | Volitelný způsob definování struktury vašeho požadavku. Viz Filtrování generování reklam pro více informací.
Toto je také objekt, ve kterém můžete požadovat informace o inzerentovi za účelem dodržení místní legislativy o reklamě, jako je evropský Zákon o digitálních službách .
| Volitelné, preferované |
| `placement` | Unikátní umístění, pro které požadujete reklamy. | Povinné |
| `productFilters` | Jakékoli produktové filtry relevantní pro váš požadavek. Například kategorie, lokalita nebo velikost. | Povinné |
| `sessionId` | Unikátní identifikátor relace zákazníka. Používá se pro atribuci ve standardních integracích. Pro více informací si prohlédněte Možnosti pracovního postupu integrace. | Povinné ve standardních integracích |
| `dtmCookieId` | Soubory cookie vytvořené a uložené webovou stránkou, používané ke sledování chování uživatelů na stejné doméně. | Volitelné |
| `audience` | Určuje konkrétní segmenty publika, do kterých nakupující patří. Relevantní pouze při použití [Cílení na publikum – Možnost 3](/retail-media-interface/integration/cs/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Volitelné |
## Vrácené položky
| Řetězec | Popis | Příklad hodnoty |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `banners.altText` | Alternativní text pro hlavní obrázek pro vzácný případ, že se nezobrazí. | `Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.` |
| `banners.contentStandardId` | Standardní identifikátor obsahu pro vaše webové stránky. | \`4ffb80ba-b9a9-4567-8069-79b2eca93473 |
| `banners.expiry` | Exspirace reklamy. Toto je nejzazší okamžik, kdy lze kliknutí nahlásit do Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` |
| `banners.id` | Unikátní ID reklamy.
Toto je unikátní pro každý požadavek odeslaný na Epsilon Retail Media a nelze je ukládat do vyrovnávací paměti.
| `banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=` |
| `banners.imageUrl` | Odkaz na obrázek banneru. | `[]\() |
| `banners.gtins` | Pole až 20 kódů produktů vybraných z propagovaných produktů kampaně. | `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` |
| `banners.linkUrl` | URL adresa přesměrovaná z banneru, když zákazník na banner klikne. | ` |
| `banners.slotId` | ID konkrétní pozice pro banner, o který jste požádali. | `Category_Top` |
| `banners.tags` | Toto pole vrací jakékoli tagy třetích stran zadané inzerentem v jeho kampani. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` |
| `banners.text` | Používá se v integracích na míru jako dodatečné textové pole. | |
| `banners.position` | Pozice reklamy v Epsilon Retail Media odpovědi. Tuto pozici byste měli respektovat v případě, že jsou využity kampaně typu Fixní umístění. | 1 |
| `banners.sellerId` | Unikátní ID prodejce. Vyplní se pouze v případě, že je na týmu nastaveno sellerId. sellerIds se obvykle používají při zapojování prodejců na tržiště. | `73nns-32sxr-32ss` Vlastní podle integrace |
| `banners.metadata` | Objekt obsahující informace o inzerentovi požadované k tomu, aby inzerentům pomohl dodržovat místní legislativu o reklamě, jako je Zákon o digitálních službách v Evropě.
advertiser se přebírá z Název společnosti v týmu dodavatele.
onBehalfOf se přebírá z Financovatel reklamy v týmu dodavatele.
| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` |
| `metadata.warnings` | Objekt obsahující varovné informace o požadavku na reklamu. V současné době varuje pouze v případě, že je překročen maximální počet segmentů. | `"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/cs/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.