> 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/fr/references/banner-ad-static-reference.md).
# Référence des annonces bannières (statiques)
Ci-dessous figurent les propriétés possibles dans une requête standard telle que décrite dans [Demander des annonces de bannière](/retail-media-interface/integration/fr/generating-ads/banner-ads-static/requesting-banner-ads.md) pour votre requête, et la réponse si vous recevez une annonce.
{% hint style="info" %}
Les annonces bannières sont demandées sur le même `/generate` point de terminaison que les annonces produits. Une seule requête peut être utilisée pour récupérer les deux types d'annonces.
{% endhint %}
## Éléments demandés
| Chaîne de caractères | Description | Obligatoire/facultatif |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `bannerSlots` | Un tableau d'emplacements de bannière pour lesquels vous souhaitez recevoir des annonces bannières. En spécifiant un maxNumberOfAds pour les emplacements de bannière, vous pouvez récupérer plus d'une bannière pour l'emplacement. Un tel cas d'utilisation serait pour des emplacements de type carrousel. | Obligatoire |
| `bannerSlotIds` | Un tableau d'emplacements de bannière pour lesquels vous souhaitez recevoir des annonces bannières | Obligatoire, remplacé par bannerSlots |
| `catalogId` | Votre identifiant de catalogue de produits pour votre site web. | Obligatoire |
| `contentStandardId` | L'identifiant de norme de contenu pour votre site web. | Obligatoire |
| `customerId` | L'identifiant unique du client auquel les annonces sont diffusées. | Facultatif |
| `filterMode` | Moyen facultatif de définir la structure de votre requête. Voir [Filtrage de la génération d'annonces](/retail-media-interface/integration/fr/data-api/api-overview/ad-generation-filtering-1.md) pour plus d'informations. | Facultatif, préféré |
| `maxNumberOfAds` | Le nombre maximum d'annonces produits que vous souhaitez recevoir, jusqu'à 15. | Obligatoire, permet de diffuser des annonces produits dans la même requête. Si aucune annonce produit n'est souhaitée, définir sur `0` |
| `options` | Moyen facultatif de définir la structure de votre requête. Voir Filtrage de la génération d'annonces pour plus d'informations.
C'est également l'objet dans lequel vous pouvez demander des informations sur l'annonceur afin de vous conformer à la législation locale sur la publicité comme celle de l'Europe Loi sur les services numériques (Digital Services Act) .
| Facultatif, préféré |
| `placement` | L'emplacement unique pour lequel vous demandez des annonces. | Obligatoire |
| `productFilters` | Tous les filtres de produits pertinents pour votre requête. Tels qu'une catégorie, un emplacement ou une taille. | Obligatoire |
| `sessionId` | L'identifiant unique de la session du client. Utilisé pour l'attribution dans les intégrations standard. Consultez les options de flux de travail d'intégration pour plus d'informations. | Obligatoire dans les intégrations standard |
| `dtmCookieId` | Cookies créés et stockés par le site web, utilisés pour suivre le comportement de l'utilisateur sur le même domaine. | Facultatif |
| `audience` | Spécifie des segments d'audience spécifiques auxquels l'acheteur appartient. Pertinent uniquement en cas d'utilisation de [Option de ciblage d'audience 3](/retail-media-interface/integration/fr/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Facultatif |
## Éléments retournés
| Chaîne de caractères | Description | Exemple de valeur |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `banners.altText` | Texte alternatif pour l'image principale dans le cas rare où elle ne s'afficherait pas. | `Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.` |
| `banners.contentStandardId` | L'identifiant de norme de contenu pour votre site web. | \`4ffb80ba-b9a9-4567-8069-79b2eca93473 |
| `banners.expiry` | L'expiration de l'annonce. Il s'agit du dernier moment où un clic peut être signalé à Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` |
| `banners.id` | L'ID unique de l'annonce.
Ceci est unique pour chaque requête faite à Epsilon Retail Media et ne peut pas être mis en cache.
| `banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=` |
| `banners.imageUrl` | Le lien de l'image de la bannière. | `[]\() |
| `banners.gtins` | Un tableau allant jusqu'à 20 codes de produits sélectionnés parmi les produits sponsorisés de la campagne. | `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` |
| `banners.linkUrl` | L'URL redirigée depuis la bannière lorsque le client clique sur la bannière. | ` |
| `banners.slotId` | L'ID de l'emplacement spécifique pour la bannière que vous avez demandée. | `Category_Top` |
| `banners.tags` | Ce champ renvoie toutes les balises tierces saisies par l'annonceur dans sa campagne. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` |
| `banners.text` | Utilisé dans les intégrations sur mesure comme champ de texte supplémentaire. | |
| `banners.position` | La position de l'annonce dans la Epsilon Retail Media réponse. Vous devez respecter cette position dans le cas où des campagnes avec emplacement fixe sont utilisées. | 1 |
| `banners.sellerId` | L'ID unique du vendeur. Ne se remplira que si un sellerId est défini sur une équipe. Les sellerIds sont généralement utilisés lors de l'intégration des vendeurs de la marketplace. | `73nns-32sxr-32ss` Personnalisé selon l'intégration |
| `banners.metadata` | Objet contenant les informations sur l'annonceur requises pour aider les annonceurs à se conformer à la législation locale sur la publicité telle que le Loi sur les services numériques (Digital Services Act) en Europe.
advertiser est extrait du nom de l'entreprise dans l'équipe fournisseur.
onBehalfOf est extrait du financeur de l'annonce dans l'équipe fournisseur.
| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` |
| `metadata.warnings` | Objet contenant des informations d'avertissement sur la requête d'annonce. Avertit actuellement uniquement si le nombre maximum de segments est dépassé. | `"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/fr/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.