> 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/product-ad-reference-1.md). # Referenční příručka produktové reklamy Níže jsou popsány vlastnosti možné ve standardním požadavku a v odpovědi, pokud obdržíte reklamu. ## Požadované položky | Řetězec | Popis | Povinné/volitelné | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | | `catalogId` | Váš identifikátor katalogu produktů 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. Další informace naleznete v části Filtrování generování reklam. | Volitelné, preferované | | `maxNumberOfAds` | Maximální počet reklam, které chcete vrátit, až do 10. | Povinné | | `options` |

Volitelný způsob definování struktury vašeho požadavku. Další informace naleznete v části Filtrování generování reklam.

Toto je také objekt, ve kterém můžete požadovat informace o inzerentovi za účelem splnění 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 filtry produktů 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. Další informace naleznete v části Možnosti integračního pracovního postupu. | Vyžadováno ve standardních integracích | | `memoryToken` |

Používá se pro stránkování. Použijte token poskytnutý v předchozím požadavku na reklamu, abyste zajistili, že Epsilon Retail Media zobrazuje vašim zákazníkům pouze nové reklamy.

Pokud je zadán, Epsilon Retail Media vyloučí v odpovědi na reklamu dříve zobrazené reklamy. Přečtěte si více v části Stránkování .

| Volitelné | | `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 | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.customPayload` |

Tato uživatelská datová část, která by měla být předána z souboru katalogu do generování reklamy.

Pole by mělo obsahovat platný objekt JSON serializovaný do pole bajtů a zakódovaný pomocí Base64. Objekt JSON by měl odpovídat schématu.

| Vlastní podle integrace | | `ads.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 | | `ads.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.

| `display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4` | | `ads.gtin` | Kód produktu reklamy. Toto bude kód produktu synchronizovaný ve vašem katalogu produktů. | `25813383` | | `ads.discount` | Zastaralé, lze ignorovat. | `{
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
}` | | `ads.position` | Pozice reklamy v odpovědi Epsilon Retail Media . Tuto pozici byste měli respektovat v případě využití kampaní s Fixním umístěním. | 1 | | `ads.memoryToken` |

Používá se pro stránkování a řetězení požadavků na reklamu.

Pokud je zadán v dalším požadavku na reklamu pro stejný kontext, Epsilon Retail Media vyloučí v odpovědi na reklamu dříve zobrazené reklamy. Přečtěte si více v části Stránkování .

| | | `ads.metadata` |

Objekt obsahující informace o inzerentovi vyžadované k tomu, aby pomohly inzerentům dodržovat místní legislativu o reklamě, jako je Zákon o digitálních službáchv Evropě.

advertiser se přenáší z Nápadu společnosti v týmu dodavatele.

onBehalfOf se přenáší z Financovatele reklamy v týmu dodavatele.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `banners` | Skládá se z objektů bannerů. Zobrazit [Reference bannerové reklamy (statické)](/retail-media-interface/integration/cs/references/banner-ad-static-reference.md) . | `"banners": [],` | | `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/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.