> 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/it/feature-integrations/marketplace-sellerid.md).
# Marketplace sellerId
## Che cos'è un marketplace?
I marketplace rappresentano un'opportunità unica per i retailer per espandere la propria presenza online e coinvolgere con facilità clienti nuovi o occasionali. I marketplace consentono alle aziende più piccole di raggiungere una vasta gamma di clienti, con prodotti solitamente spediti direttamente dal venditore del marketplace al cliente.
I marketplace consentono ai venditori di vendere i propri prodotti sul sito di un retailer, aumentando la visibilità dei prodotti presso un pubblico più ampio. Allo stesso tempo, i retailer ottengono un'offerta di prodotti aggiuntiva da vendere a una gamma più ampia di clienti.
Oltre a monetizzare il tuo sito con le funzionalità marketplace, i retailer possono anche capitalizzare su questo spazio espositivo online premium e offrire agli vendor del marketplace l'opportunità di fare offerte per le posizioni principali tramite Epsilon Retail Media attraverso la documentazione elencata di seguito.
## Configurazione degli inserzionisti marketplace
Una volta completati i miglioramenti dell'integrazione (dettagliati di seguito), potrai impostare un Seller ID per team. Questo può essere fatto solo quando si crea un team dal team retailer; non può essere fatto quando si modifica un team o da parte di un fornitore.
Durante la creazione di un nuovo team è presente una sezione "Optional fields" in cui è possibile selezionare il Seller ID. I Seller ID selezionabili provengono direttamente dal tuo catalogo prodotti. Non è possibile inserire un valore che non sia presente nel catalogo prodotti.
## Requisiti di integrazione
### Panoramica di alto livello
Oltre a un'integrazione standard con Epsilon Retail Media, la tua integrazione dovrà essere migliorata con le modifiche indicate di seguito:
* Implementare un sellerId per prodotto nel file del catalogo prodotti o nell'API
* Analizzare la risposta pubblicitaria e mostrare l'offerta del venditore corretto quando pertinente
* Segnalare un sellerId per ciascun prodotto univoco quando si segnalano ordini a Epsilon Retail Media
{% hint style="warning" %}
Attualmente, la funzionalità di Epsilon Retail Medianon soddisfa appieno il caso d'uso in cui un venditore di un prodotto non ha un seller ID e sono presenti anche varianti di prodotti con seller ID. Una soluzione alternativa individuata consiste nel sincronizzare un seller ID retailer su qualsiasi prodotto non-marketplace, e ciascun fornitore che non è un venditore marketplace deve avere questo seller ID aggiunto. Contatta il tuo technical account manager per saperne di più.
{% endhint %}
### Miglioramenti del catalogo prodotti.
Nel tuo catalogo prodotti sincronizzato con Citrus, dovrai fornire un sellerId per ogni codice prodotto univoco a Epsilon Retail Media.
#### Sincronizzazione del catalogo tramite file
Dovrai aggiungere una colonna/sezione aggiuntiva al tuo file catalogo di `seller_id`. Ogni combinazione di `seller_id` e `product_code` deve essere una riga univoca. Per i prodotti non marketplace, il `seller_id` può essere vuoto.
{% hint style="warning" %}
I prodotti che hanno sia un venditore del brand (dove il prodotto non ha sellerId) sia venditori marketplace (dove lo stesso prodotto presenta varianti con sellerId) sono attualmente incompatibili. Se disponi di prodotti che rientrano in questa categoria, ti consigliamo di integrare al momento solo i venditori marketplace per questi prodotti specifici.
Se il tuo sito e-commerce è configurato con questo particolare caso d'uso di prodotti, ti chiediamo di segnalare il problema al tuo contatto Epsilon Retail Media poiché stiamo valutando di rendere compatibile questo caso d'uso.
{% endhint %}
Per gli esempi, visita [Sincronizzazione di catalogo e prodotto tramite file](/retail-media-interface/integration/it/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Sincronizzazione del catalogo tramite API
Quando sincronizzi i prodotti tramite API, dovrai sincronizzare un `sellerId` per ciascuna combinazione univoca di `sellerId` & `gtin` .
```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"
}
]
}
```
### Miglioramenti alla risposta pubblicitaria
Quando Epsilon Retail Media eroga annunci, verrà erogato un `sellerId` se il `gtin` ne ha uno associato. Questo si applica a tutti i tipi di annunci, ma è rilevante solo per il rendering pubblicitario dagli annunci prodotto. Di seguito è riportato un esempio di risposta di un annuncio prodotto:
```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="
}
```
Per assicurarti che venga mostrata l'offerta del venditore corretto, dovresti leggere il `sellerId` fornito da Epsilon Retail Media e mostrare l'offerta del venditore corretto al cliente.
### Miglioramenti alla reportistica degli ordini
Quando comunichi gli ordini a Epsilon Retail Media, dovrai anche specificare il `sellerId` per ciascuna combinazione univoca di `gtin` quando comunichi gli ordini a Epsilon Retail Media.
{% hint style="warning" %}
Questo passaggio è obbligatorio e non può essere tralasciato, altrimenti gli annunci non verranno attribuiti agli ordini.
{% endhint %}
#### Sincronizzazione degli ordini tramite file
Dovrai aggiungere una colonna/sezione aggiuntiva al tuo file ordini di `seller_id`. Ogni combinazione di `seller_id` e `product_code` deve essere una riga univoca. Per i prodotti non marketplace acquistati, il `seller_id` può essere vuoto.
Per gli esempi, visita [Sincronizzazione dei dati degli ordini tramite file](/retail-media-interface/integration/it/data-api/order-data-1/syncing-order-data-via-file.md)
#### Sincronizzazione degli ordini tramite API
Quando sincronizzi gli ordini tramite API, dovrai sincronizzare il `sellerId` ove applicabile quando comunichi gli ordini. Nel caso in cui il prodotto acquistato non abbia un `sellerId`, può essere omesso.
Di seguito è riportato un esempio di ordine in cui un prodotto proviene da un venditore marketplace e un altro non è un prodotto 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"
}
]
}
]
}
```
## Migrazione dei team esistenti
Se stai migliorando la tua integrazione per supportare i venditori marketplace, ci sono diversi passaggi che tu o i tuoi inserzionisti dovete seguire. È importante sapere come funzionano i prodotti all'interno del sistema Epsilon Retail Media .
Un prodotto senza seller ID e un prodotto con seller ID sono due entità univoche nel sistema Epsilon Retail Media . Pertanto, le campagne devono essere migrate per selezionare la nuova variante di prodotto corretta per tutte le campagne esistenti che devono essere aggiornate.
1. Informa il tuo technical account manager di Epsilon Retail Media della tua intenzione di abilitare la funzionalità seller ID marketplace
2. Il tuo technical account manager dovrebbe essere in grado di garantire che la nostra attribuzione interna sia configurata per gestire la migrazione dei team
3. Migliora il catalogo prodotti con i prodotti dotati di seller ID
4. Migliora la reportistica degli ordini per riportare il seller ID
5. Se stai migrando team esistenti, modifica i team esistenti per specificare il seller ID
6. Una volta modificato un team, le campagne di ciascun team devono essere modificate per selezionare nuovamente i prodotti. Questo perché è necessario che il nuovo prodotto con seller ID sia selezionato nella campagna, mentre le campagne create prima che il team avesse un seller ID non avranno selezionata la variante corretta del prodotto.
---
# 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/it/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.