> 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/feature-integrations/marketplace-sellerid.md).
# sellerId de la marketplace
## Qu'est-ce qu'une marketplace ?
Les marketplaces sont une occasion unique pour les distributeurs de développer leur présence en ligne tout en engageant facilement de nouveaux acheteurs ou des acheteurs occasionnels. Les marketplaces permettent aux plus petites entreprises d'atteindre une grande variété de clients, les produits étant généralement expédiés directement par le vendeur de la marketplace au client.
Les marketplaces permettent aux vendeurs de vendre leurs produits sur le site d'un distributeur, augmentant ainsi la visibilité de leurs produits auprès d'un public plus large. Quant aux distributeurs, ils bénéficient d'offres de produits supplémentaires à vendre à un éventail plus large de clients.
En plus de monétiser votre site grâce aux fonctionnalités de marketplace, les distributeurs peuvent également tirer parti de cet espace linéaire en ligne premium et offrir la possibilité aux vendeurs de la marketplace d'enchérir pour obtenir les meilleures positions via Epsilon Retail Media à travers la documentation répertoriée ci-dessous.
## Configuration des annonceurs marketplace
Une fois les améliorations de votre intégration terminées (détaillées ci-dessous), vous pourrez définir un Seller ID par équipe. Cela ne peut être fait que lors de la création d'une équipe à partir de l'équipe distributeur ; cela ne peut pas être fait lors de la modification d'une équipe ou par un fournisseur.
Il existe une section « Champs facultatifs » lors de la création d'une nouvelle équipe où le Seller ID peut être sélectionné. Les Seller IDs pouvant être sélectionnés proviennent directement de votre catalogue de produits. Vous ne pouvez pas saisir une valeur qui n'est pas présente dans le catalogue de produits.
## Exigences d'intégration
### Présentation générale
En plus d'une intégration standard avec Epsilon Retail Media, votre intégration devra être améliorée avec les modifications ci-dessous :
* Implémenter un sellerId par produit dans le fichier de catalogue de produits ou l'API
* Analyser la réponse publicitaire et afficher l'offre du bon vendeur le cas échéant
* Signaler un sellerId par produit unique lors de la transmission des commandes à Epsilon Retail Media
{% hint style="warning" %}
Actuellement, Epsilon Retail Mediala fonctionnalité de ne prend pas totalement en charge le cas d'usage où le vendeur d'un produit n'a pas de seller ID, alors qu'il existe également des variantes de produits avec seller ID. Une solution palliative identifiée consiste à synchroniser un seller ID de distributeur sur tous les produits hors marketplace, et chaque fournisseur qui n'est pas un vendeur marketplace doit se voir ajouter ce seller ID. Veuillez contacter votre responsable technique de compte pour en savoir plus.
{% endhint %}
### Améliorations du catalogue de produits.
Dans votre catalogue de produits synchronisé avec Citrus, vous devrez fournir un sellerId par code produit unique à Epsilon Retail Media.
#### Synchronisation du catalogue via un fichier
Vous devrez ajouter une colonne/section supplémentaire à votre fichier de catalogue de `seller_id`. Chaque `seller_id` et `product_code` combinaison doit être une ligne unique. Pour les produits hors marketplace, le `seller_id` peut être vide.
{% hint style="warning" %}
Les produits qui ont à la fois un vendeur de marque (où le produit n'a pas de sellerId) et des vendeurs marketplace (où le même produit a des variantes sellerId) sont actuellement incompatibles. Si vous avez des produits entrant dans cette catégorie, nous vous recommandons de ne faire monter à bord que les vendeurs marketplace pour ces produits spécifiques pour le moment.
Si votre site d'e-commerce est configuré avec ce cas d'usage particulier de produits, nous vous demandons de remonter ce problème à votre Epsilon Retail Media contact car nous envisageons de rendre ce cas d'usage compatible.
{% endhint %}
Pour des exemples, veuillez consulter [Synchronisation du catalogue et des produits par fichier](/retail-media-interface/integration/fr/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Synchronisation du catalogue via API
Lors de la synchronisation de produits via API, vous devrez synchroniser un `sellerId` par unique `sellerId` & `gtin` combinaison.
```http
POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"catalogProducts": [
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965543",
"sellerId": "327272-sade2-3ja",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"inventory": 50,
"price": "19.99",
"tags": [
"imageurl:https://your.image.host.com/image.jpg",
"name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
],
"filters": [
"category:Health&Beauty",
"category:Grocery",
"Brand:Covergirl",
"Special_Flag:0"
],
"profit": "1.50"
},
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965543",
"sellerId": "09sa-d32s--faasw",
"inventory": 50,
"price": "19.99",
"tags": [
"imageurl:https://your.image.host.com/image.jpg",
"name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
],
"filters": [
"category:Health&Beauty",
"category:Grocery",
"Brand:Covergirl",
"Special_Flag:0"
],
"profit": "1.50"
},
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965738",
"inventory": 26,
"price": "8.50",
"tags": [
"imageurl:https://your.image.host.com/image.jpg",
"name:Kelloggs Froot Loops Breakfast Cereal 500g"
],
"filters": [
"Brand:Kelloggs",
"category:Pantry",
"category:BreakfastFoods",
"category:Cereals",
"Special_Flag:0"
],
"profit": "0.50"
}
]
}
```
### Améliorations de la réponse publicitaire
Lorsque Epsilon Retail Media diffuse des annonces, un `sellerId` sera diffusé si le `gtin` en a un qui lui est associé. Cela s'applique à tous les types d'annonces, mais n'est pertinent que pour l'affichage d'annonces à partir de publicités produits. Un exemple de réponse de publicité produit est présenté ci-dessous :
```json
{
"ads": [
{
"id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
"gtin": "7733636",
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2021-05-12T04:17:50.400902957Z",
"position": 1
},
{
"id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
"gtin": "7733628",
"sellerId": "2834-ascre-2wcr4",
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2021-05-12T04:17:50.400908257Z",
"position": 2
}
],
"banners": [],
"products": [],
"memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
```
Pour vous assurer que l'offre du bon vendeur est affichée, vous devez lire le `sellerId` fourni par Epsilon Retail Media et afficher l'offre du bon vendeur au client.
### Améliorations du suivi des commandes
Lors de la transmission des commandes à Epsilon Retail Media, vous devrez également spécifier le `sellerId` par unique `gtin` lorsque vous signalez des commandes à Epsilon Retail Media.
{% hint style="warning" %}
Cette étape est requise et ne peut être omise, sinon les annonces ne seront pas attribuées aux commandes.
{% endhint %}
#### Synchronisation des commandes via un fichier
Vous devrez ajouter une colonne/section supplémentaire à votre fichier de commandes de `seller_id`. Chaque `seller_id` et `product_code` combinaison doit être une ligne unique. Pour les produits hors marketplace achetés, le `seller_id` peut être vide.
Pour des exemples, veuillez consulter [Synchronisation des données de commande par fichier](/retail-media-interface/integration/fr/data-api/order-data-1/syncing-order-data-via-file.md)
#### Synchronisation des commandes via API
Lors de la synchronisation des commandes via API, vous devrez synchroniser le `sellerId` le cas échéant lors de la transmission des commandes. Dans le cas où le produit acheté n'a pas de `sellerId`, il peut être omis.
Voici un exemple de commande où un produit provient d'un vendeur marketplace et un autre n'est pas un produit marketplace :
```http
POST $BASE_URL/v1/orders HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"orders": [
{
"customerId": "npc-s243-ir",
"sessionId": "5cat7-9964-4f",
"orderDate": "2021-12-02T15:00:00Z",
"id": "abcti84ew-c158-4d78-a0af-b48bbwfrcss4",
"orderItems": [
{
"gtin": "9891998566P",
"quantity": 3,
"regularUnitPrice": "1.00",
"totalOrderItemPriceAfterDiscounts": "3.00",
"sellerId": "10sa-3s33-j8e3"
}
]
},
{
"gtin": "351998532P",
"quantity": 1,
"regularUnitPrice": "2.50",
"totalOrderItemPriceAfterDiscounts": "2.50"
}
]
}
]
}
```
## Migration des équipes existantes
Si vous améliorez votre intégration pour prendre en charge les vendeurs marketplace, vous ou vos annonceurs devez suivre plusieurs étapes. Il est important de savoir comment les produits fonctionnent au sein du Epsilon Retail Media système.
Un produit sans seller ID et un produit avec un seller ID sont deux entités uniques dans le Epsilon Retail Media système. À ce titre, les campagnes doivent être migrées pour sélectionner la nouvelle variante de produit correcte pour toutes les campagnes existantes qui doivent être mises à jour.
1. Informez votre Epsilon Retail Media responsable technique de compte de votre intention d'activer la fonctionnalité seller ID de marketplace
2. Votre responsable technique de compte devrait être en mesure de s'assurer que notre attribution interne est configurée pour gérer la migration des équipes
3. Améliorer le catalogue de produits avec les produits à seller ID
4. Améliorer le suivi des commandes pour transmettre le seller ID
5. En cas de migration d'équipes existantes, modifier les équipes existantes pour spécifier le seller ID
6. Une fois qu'une équipe est modifiée, les campagnes de chaque équipe doivent être modifiées pour sélectionner à nouveau les produits. Cela est dû au fait que nous avons besoin du nouveau produit avec un seller ID sélectionné dans la campagne, tandis que les campagnes créées avant que l'équipe n'ait un seller ID n'auront pas la bonne variante du produit sélectionnée.
---
# 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/feature-integrations/marketplace-sellerid.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.