> 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/feature-integrations/marketplace-sellerid.md).
# Marknadsplatsens sellerId
## Vad är en marknadsplats?
Marknadsplatser är en unik möjlighet för återförsäljare att utöka sin närvaro online samt enkelt engagera nya eller tillfälliga köpare. Marknadsplatser gör det möjligt för mindre företag att nå ett brett spektrum av kunder, där varorna vanligtvis skickas direkt från marknadsplatssäljaren till kunden.
Marknadsplatser gör det möjligt för säljare att sälja sina produkter på en återförsäljares webbplats, vilket ökar deras produktsynlighet för en bredare publik. Samtidigt får återförsäljare ytterligare produkterbjudanden att sälja till ett bredare utbud av kunder.
Förutom att monetarisera din webbplats med marknadsplatsfunktioner kan återförsäljare också utnyttja detta utrymme på den digitala hyllan och erbjuda marknadsplatssäljare möjligheten att buda på topplaceringar via Epsilon Retail Media genom dokumentationen som listas nedan.
## Konfigurera marknadsplatsannonsörer
När dina integrationsförbättringar är slutförda (beskrivs nedan) kommer du att kunna ange ett Seller ID per team. Detta kan endast göras när ett team skapas från återförsäljarteamet; det kan inte göras när ett team redigeras eller av en leverantör.
Det finns ett avsnitt för "Valfria fält" när ett nytt team skapas där Seller ID kan väljas. De Seller IDs som kan väljas hämtas direkt från din produktkatalog. Du kan inte ange ett värde som inte finns i produktkatalogen.
## Krav för integration
### Övergripande översikt
Utöver en standardintegration med Epsilon Retail Mediabehöver din integration förbättras med nedanstående ändringar:
* Implementera ett sellerId per produkt i produktkatalogfilen eller API:et
* Analysera annonssvaret och återge rätt säljares erbjudande när det är relevant
* Rapportera ett sellerId per unik produkt när du rapporterar beställningar till Epsilon Retail Media
{% hint style="warning" %}
För närvarande Epsilon Retail Mediastödjer funktionen inte helt användningsfallet där en säljare av en produkt inte har något seller ID, och det även finns seller ID-varianter av produkter. En identifierad lösning för detta är att synkronisera ett seller ID för återförsäljaren på alla produkter som inte tillhör en marknadsplats, och varje leverantör som inte är en marknadsplatssäljare måste få detta seller ID tillagt. Kontakta din technical account manager för att få veta mer.
{% endhint %}
### Förbättringar av produktkatalogen.
I din produktkatalog som synkroniserats med Citrus måste du tillhandahålla ett sellerId per unik produktkod till Epsilon Retail Media.
#### Synkronisera katalog via fil
Du måste lägga till en extra kolumn/avsnitt i din katalogfil för `seller_id`. Varje `seller_id` och `product_code` kombination måste vara en unik rad. För produkter som inte tillhör en marknadsplats kan `seller_id` vara tom.
{% hint style="warning" %}
Produkter som har både en varumärkessäljare (där produkten inte har något sellerId) och marknadsplatssäljare (där samma produkt har sellerId-varianter) är för närvarande inkompatibla. Om du har produkter som faller i denna kategori rekommenderar vi att du för närvarande endast ansluter marknadsplatssäljare för dessa specifika produkter.
Om din e-handelsplats är konfigurerad med detta särskilda användningsfall för produkter ber vi dig att ta upp detta problem med din Epsilon Retail Media -kontakt eftersom vi överväger att göra detta användningsfall kompatibelt.
{% endhint %}
För exempel, vänligen besök [Synkronisera katalog och produkt via fil](/retail-media-interface/integration/sv/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Synkronisera katalog via API
När du synkroniserar produkter via API måste du synkronisera ett `sellerId` per unik `sellerId` & `gtin` kombination.
```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"
}
]
}
```
### Förbättringar av annonssvar
När Epsilon Retail Media visar annonser kommer ett `sellerId` att visas om `gtin` har ett sådant kopplat till sig. Detta gäller alla annonstyper, men är endast relevant för annonsvisning från produktannonser. Ett exempel på ett produktannonssvar visas nedan:
```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="
}
```
För att säkerställa att rätt säljares erbjudande visas bör du läsa `sellerId` som tillhandahålls av Epsilon Retail Media och visa rätt säljares erbjudande för kunden.
### Förbättringar av orderrapportering
När du rapporterar beställningar till Epsilon Retail Mediamåste du också ange `sellerId` per unik `gtin` när du rapporterar beställningar till Epsilon Retail Media.
{% hint style="warning" %}
Detta steg krävs och får inte missas, annars kommer annonser inte att attribueras till beställningar.
{% endhint %}
#### Synkronisera beställningar via fil
Du måste lägga till en extra kolumn/avsnitt i din orderfil för `seller_id`. Varje `seller_id` och `product_code` kombinationen måste vara en unik rad. För köpta produkter som inte tillhör en marknadsplats kan `seller_id` vara tom.
För exempel, vänligen besök [Synkronisera orderdata via fil](/retail-media-interface/integration/sv/data-api/order-data-1/syncing-order-data-via-file.md)
#### Synkronisera beställningar via API
När du synkroniserar beställningar via API måste du synkronisera `sellerId` där det är tillämpligt när du rapporterar beställningar. I händelse av att den köpta produkten inte har ett `sellerId`kan det utelämnas.
Nedan visas ett exempel på en beställning där en produkt är från en marknadsplatssäljare och en annan inte är en marknadsplatsprodukt:
```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"
}
]
}
]
}
```
## Migrera befintliga team
Om du förbättrar din integration för att stödja marknadsplatssäljare finns det ett antal steg som du eller dina annonsörer behöver ta. Det är viktigt att veta hur produkter fungerar inom Epsilon Retail Media -systemet.
En produkt utan seller ID och en produkt med ett seller ID är två unika enheter i Epsilon Retail Media -systemet. Som sådana måste kampanjer migreras för att välja den korrekta nya produktvarianten för alla befintliga kampanjer som behöver uppdateras.
1. Informera din Epsilon Retail Media technical account manager om din avsikt att aktivera funktionen för marknadsplatsens seller ID
2. Din technical account manager bör kunna säkerställa att vår interna attribuering är konfigurerad för att hantera migrering av team
3. Förbättra produktkatalogen med seller ID-produkter
4. Förbättra orderrapporteringen för att rapportera seller ID
5. Om du migrerar befintliga team, redigera befintliga team för att ange seller ID
6. När ett team har redigerats måste varje teams kampanjer redigeras för att välja produkterna igen. Detta beror på att vi behöver den nya produkten med ett valt seller ID i kampanjen, medan kampanjer som skapades innan teamet hade ett seller ID inte kommer att ha rätt variant av produkten vald.
---
# 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/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.