> 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/banner-ad-static-reference.md).
# Referens för bannerannonser (statiska)
Nedan beskrivs de egenskaper som är möjliga i en standardbegäran som beskrivs i [Begära bannerannonser](/retail-media-interface/integration/sv/generating-ads/banner-ads-static/requesting-banner-ads.md) för din begäran, och svaret om du tar emot en annons.
{% hint style="info" %}
Bannerannonser begärs på samma `/generate` slutpunkt som produktannonser. En enskild begäran kan användas för att hämta båda annonstyperna.
{% endhint %}
## Begärda objekt
| String | Beskrivning | Obligatorisk/valfri |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `bannerSlots` | En matris med bannerplatser som du vill ta emot bannerannonser för. Genom att ange maxNumberOfAds för bannerplatserna kan du hämta mer än en banner för platsen. Ett sådant användningsfall är för karusellplaceringar. | Obligatorisk |
| `bannerSlotIds` | En matris med bannerplatser som du vill ta emot bannerannonser för | Obligatorisk, ersätts av bannerSlots |
| `catalogId` | Identifieraren för din produktkatalog för din webbplats. | Obligatorisk |
| `contentStandardId` | Innehållsstandardens identifierare 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 begäran. Se [Filtrering av annonsgenerering](/retail-media-interface/integration/sv/data-api/api-overview/ad-generation-filtering-1.md) för mer information. | Valfri, föredras |
| `maxNumberOfAds` | Det maximala antalet produktannonser du vill ska returneras, upp till 15. | Obligatorisk, gör det möjligt att servera produktannonser i samma begäran. Om inga produktannonser önskas, ställ in på `0` |
| `options` | Valfritt sätt att definiera strukturen på din begäran. Se Filtrering av annonsgenerering 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örordningen om digitala tjänster (DSA) .
| Valfri, föredras |
| `placement` | Den unika placeringen du begär annonser för. | Obligatorisk |
| `productFilters` | Alla produktfilter som är relevanta för din begäran. Såsom en kategori, plats eller storlek. | Obligatorisk |
| `sessionId` | Den unika identifieraren för kundens session. Används för attribution i standardintegrationer. Granska alternativ för integrationsarbetsflöde för mer information. | Obligatorisk i standardintegrationer |
| `dtmCookieId` | Kakor 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
| String | Beskrivning | Exempelvärde |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `banners.altText` | Alternativ text för huvudbilden i det sällsynta fallet att den inte visas. | `Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.` |
| `banners.contentStandardId` | Innehållsstandardens identifierare för din webbplats. | \`4ffb80ba-b9a9-4567-8069-79b2eca93473 |
| `banners.expiry` | Utgångsdatum för annonsen. Detta är den senaste tidpunkten då ett klick kan rapporteras till Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` |
| `banners.id` | Annonsens unika id.
Detta är unikt för varje begäran som görs till Epsilon Retail Media och kan inte cachas.
| `banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=` |
| `banners.imageUrl` | Bannerbildens länk. | `[]\() |
| `banners.gtins` | En matris med upp till 20 produktkoder valda från kampanjens annonserade produkter. | `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` |
| `banners.linkUrl` | URL:en som vidarebefordras från bannern när kunden klickar på bannern. | ` |
| `banners.slotId` | ID för den specifika platsen för bannern du har begärt. | `Category_Top` |
| `banners.tags` | Detta fält returnerar eventuella tredjepartstaggar som angivits av annonsören i deras kampanj. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` |
| `banners.text` | Används i skräddarsydda integrationer som ett ytterligare textfält. | |
| `banners.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 |
| `banners.sellerId` | Säljarens unika id. Kommer endast att fyllas i om ett sellerId är inställt på ett team. sellerIds används vanligtvis vid onboarding av marknadsplatssäljare. | `73nns-32sxr-32ss` Anpassad per integration |
| `banners.metadata` | Objekt som innehåller den annonsörsinfo som krävs för att hjälpa annonsörer att följa lokal annonslagstiftning som Förordningen om digitala tjänster (DSA) i Europa.
advertiser hämtas från Företagsnamnet i leverantörsteamet.
onBehalfOf hämtas från Annonsfinansiären i leverantörsteamet.
| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` |
| `metadata.warnings` | Objekt som innehåller varningsinformation om annonsbegäran. 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/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.