> 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/product-ad-reference-1.md). # Référence des annonces produits Ci-dessous figurent les propriétés possibles dans une requête standard, ainsi que la réponse si vous recevez une annonce. ## Articles demandés | Chaîne de caractères | Description | Obligatoire/facultatif | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | `catalogId` | Votre identifiant de catalogue produit 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. Consultez le filtrage de génération d'annonces pour plus d'informations. | Facultatif, préféré | | `maxNumberOfAds` | Le nombre maximal d'annonces que vous souhaitez recevoir en retour, jusqu'à 10. | Obligatoire | | `options` |

Moyen facultatif de définir la structure de votre requête. Consultez le filtrage de génération d'annonces pour plus d'informations.

Il s'agit également de 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. Comme 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 | | `memoryToken` |

Utilisé pour la pagination. Utilisez un jeton fourni dans une requête d'annonce précédente pour vous assurer Epsilon Retail Media ne diffuse que de nouvelles annonces à vos clients.

Si fourni, Epsilon Retail Media exclura les annonces précédemment diffusées dans la réponse publicitaire. Consultez Pagination pour en savoir plus.

| Facultatif | | `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 si vous utilisez [Option de ciblage d'audience 3](/retail-media-interface/integration/fr/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Facultatif | ## Articles retournés | Chaîne de caractères | Description | Exemple de valeur | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.customPayload` |

Cette charge utile personnalisée qui doit être transmise du fichier catalogue à la génération d'annonces.

Le champ doit contenir un objet JSON valide sérialisé dans un tableau d'octets et codé en Base64. L'objet JSON doit respecter un schéma.

| Personnalisé selon l'intégration | | `ads.sellerId` | L'identifiant 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 de vendeurs de marketplace. | `73nns-32sxr-32ss` Personnalisé selon l'intégration | | `ads.id` |

L'identifiant unique de l'annonce.
Ceci est unique à chaque requête faite à Epsilon Retail Media et ne peut pas être mis en cache.

| `display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4` | | `ads.gtin` | Le code produit de l'annonce. Il s'agira du code produit synchronisé dans votre catalogue de produits. | `25813383` | | `ads.discount` | Obsolète, peut être ignoré. | `{
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
}` | | `ads.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 | | `ads.memoryToken` |

Utilisé pour la pagination et le chaînage des requêtes d'annonces.

Si fourni dans votre prochaine requête d'annonce pour le même contexte, Epsilon Retail Media exclura les annonces précédemment diffusées dans la réponse publicitaire. Consultez Pagination pour en savoir plus.

| | | `ads.metadata` |

Objet contenant les informations sur l'annonceur nécessaires 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 la société 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"
}
...` | | `banners` | Composé d'objets bannières. Voir le [Référence de l'annonce de bannière (statique)](/retail-media-interface/integration/fr/references/banner-ad-static-reference.md) pour en savoir plus. | `"banners": [],` | | `metadata.warnings` | Objet contenant des informations d'avertissement sur la requête d'annonce. Actuellement, avertit uniquement si le nombre maximal 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/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.