> 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/sv/references/product-ad-reference-1.md). # Referens för produktannonser Nedan beskrivs de egenskaper som är möjliga i en standardförfrågan, och svaret om du får en annons. ## Begärda objekt | Sträng | Beskrivning | Obligatorisk/valfri | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | | `catalogId` | Din produktkatalogidentifierare för din webbplats. | Obligatorisk | | `customerId` | Den unika identifieraren för kunden som visas annonser. | Valfri | | `filterMode` | Valfritt sätt att definiera strukturen på din förfrågan. Se Annonsgenereringsfiltrering för mer information. | Valfri, föredras | | `maxNumberOfAds` | Det maximala antalet annonser du vill ska returneras, upp till 10. | Obligatorisk | | `options` |

Valfritt sätt att definiera strukturen på din förfrågan. Se Annonsgenereringsfiltrering för mer information.

Detta är också objektet där du kan begära annonsörsinformation för att följa lokal annonslagstiftning som Europas Förordning om digitala tjänster.

| Valfri, föredras | | `placement` | Den unika placeringen du begär annonser för. | Obligatorisk | | `productFilters` | Alla produktfilter som är relevanta för din förfrågan. Såsom en kategori, plats eller storlek. | Obligatorisk | | `sessionId` | Den unika identifieraren för kundens session. Används för attribuering i standardintegrationer. Läs mer i Integrationsarbetsflödesalternativ. | Obligatorisk i standardintegrationer | | `memoryToken` |

Används för paginering. Använd en token från en tidigare annonsförfrågan för att säkerställa att Epsilon Retail Media endast visar nya annonser för dina kunder.

Om den anges, Epsilon Retail Media kommer tidigare visade annonser att exkluderas i annonssvaret. Läs mer i Paginering för att lära dig mer.

| Valfri | | `dtmCookieId` | Cookies som skapas och lagras av webbplatsen, som används för att spåra användarbeteende på samma domän. | Valfri | | `audience` | Anger specifika målgruppssegment som shopparen tillhör. Endast relevant vid användning av [Målgruppsinriktning alternativ 3](/retail-media-interface/integration/sv/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Valfri | ## Returnerade objekt | Sträng | Beskrivning | Exempelvärde | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.customPayload` |

Denna anpassade nyttolast som ska trådas från katalogfilen till annonsgenerering.

Fältet bör innehålla ett giltigt JSON-objekt serialiserat till en byte-array och Base64-kodat. JSON-objektet bör följa ett schema.

| Anpassat per integration | | `ads.sellerId` | Säljarens unika ID. Fylls endast i om ett sellerId är inställt på ett team. sellerIds används vanligtvis vid onboarding av marknadsplatssäljare. | `73nns-32sxr-32ss` Anpassat per integration | | `ads.id` |

Annonsens unika id.
Detta är unikt för varje förfrågan som görs till Epsilon Retail Media och kan inte cachas.

| `display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4` | | `ads.gtin` | Produktkoden för annonsen. Detta kommer att vara produktkoden som synkroniserats i din produktkatalog. | `25813383` | | `ads.discount` | Föråldrad, kan ignoreras. | `{
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
}` | | `ads.position` | Annonsens position i Epsilon Retail Media -svaret. Du bör respektera denna position i händelse av att kampanjer med Fast placering används. | 1 | | `ads.memoryToken` |

Används för paginering och kedjning av annonsförfrågningar.

Om den anges i din nästa annonsförfrågan för samma kontext, Epsilon Retail Media kommer tidigare visade annonser att exkluderas i annonssvaret. Läs mer i Paginering för att lära dig mer.

| | | `ads.metadata` |

Objekt som innehåller den annonsörsinformation som krävs för att hjälpa annonsörer att följa lokal annonslagstiftning såsom Förordning om digitala tjänsteri Europa.

advertiser hämtas från Företagsnamn i leverantörsteamet.

onBehalfOf hämtas från Annonsfinansiär i leverantörsteamet.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `banners` | Består av bannerobjekt. Visa [Referens för bannerannons (statisk)](/retail-media-interface/integration/sv/references/banner-ad-static-reference.md) för att lära dig mer. | `"banners": [],` | | `metadata.warnings` | Objekt som innehåller varningsinformation om annonsförfrågan. Varnar för närvarande endast om det maximala antalet segment överskrids. | `"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/sv/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.