> 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/cs/feature-integrations/marketplace-sellerid.md).
# marketplace sellerId
## Co je to tržiště?
Tržiště představují jedinečnou příležitost pro maloobchodníky, jak rozšířit svou přítomnost na internetu a snadno oslovit nové nebo příležitostné kupující. Tržiště umožňují menším podnikům oslovit širokou škálu zákazníků, přičemž zboží obvykle zákazníkovi zasílá přímo prodávající z tržiště.
Tržiště umožňují prodávajícím prodávat své produkty na webu maloobchodníka, čímž se zvyšuje viditelnost jejich produktů pro širší publikum. Maloobchodníci naopak získávají další nabídku produktů, kterou mohou prodávat širšímu okruhu zákazníků.
Kromě monetizace vašich stránek pomocí funkcí tržiště mohou maloobchodníci také využít tento prémiový online prostor a nabídnout prodejcům z tržiště možnost dražit o přední pozice prostřednictvím Epsilon Retail Media prostřednictvím dokumentace uvedené níže.
## Nastavení inzerentů z tržiště
Jakmile jsou vylepšení vaší integrace dokončena (podrobně popsaná níže), budete moci nastavit ID prodávajícího (Seller ID) pro každý tým. To lze provést pouze při vytváření týmu z týmu maloobchodníka, nelze to provést při úpravě týmu ani ze strany dodavatele.
Při vytváření nového týmu je k dispozici sekce "Volitelná pole", kde lze vybrat Seller ID. Volitelná Seller ID pocházejí přímo z vašeho katalogu produktů. Nelze zadat hodnotu, která v katalogu produktů není obsažena.
## Požadavky na integraci
### Přehled na vysoké úrovni
Kromě standardní integrace s Epsilon Retail Mediabude nutné vaši integraci rozšířit o níže uvedené změny:
* Implementujte sellerId pro každý produkt v souboru katalogu produktů nebo v API
* Zpracujte odpověď na reklamu a v případě potřeby zobrazte nabídku správného prodávajícího
* Při hlášení objednávek do hlaste sellerId pro každý unikátní produkt Epsilon Retail Media
{% hint style="warning" %}
V současné době Epsilon Retail Mediafunkce plně neuspokojuje případ použití, kdy prodávající produktu nemá žádné ID prodávajícího a zároveň existují varianty produktů s ID prodávajícího. Zjištěným náhradním řešením je synchronizovat ID prodávajícího maloobchodníka u jakéhokoli produktu, který nepochází z tržiště, a toto ID prodávajícího musí mít přidáno každý dodavatel, který není prodávajícím na tržišti. Chcete-li se dozvědět více, kontaktujte svého technického account manažera.
{% endhint %}
### Vylepšení katalogu produktů.
V katalogu produktů synchronizovaném se společností Citrus budete muset pro poskytnout sellerId pro každý unikátní kód produktu Epsilon Retail Media.
#### Synchronizace katalogu pomocí souboru
Do souboru katalogu budete muset přidat další sloupec/sekci `seller_id`. Každá kombinace `seller_id` a `product_code` musí tvořit unikátní řádek. Pro produkty mimo tržiště může být `seller_id` prázdný.
{% hint style="warning" %}
Produkty, které mají jak značkového prodávajícího (kde produkt nemá sellerId), tak prodávající z tržiště (kde má stejný produkt varianty sellerId), jsou v současné době nekompatibilní. Pokud máte produkty, které spadají do této kategorie, doporučujeme v tuto chvíli pro tyto konkrétní produkty zapojit pouze prodávající z tržiště.
Pokud je váš e-shop nastaven s tímto konkrétním případem použití produktů, žádáme vás, abyste tento problém projednali se svým kontaktem v Epsilon Retail Media , protože zvažujeme přizpůsobení systému pro tento případ použití.
{% endhint %}
Příklady naleznete na adrese [Synchronizace katalogu a produktu pomocí souboru](/retail-media-interface/integration/cs/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Synchronizace katalogu přes API
Při synchronizaci produktů přes API budete muset synchronizovat `sellerId` pro každou unikátní kombinaci `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"
}
]
}
```
### Vylepšení odpovědi na reklamu
Když Epsilon Retail Media zobrazuje reklamy, bude doručeno `sellerId` , pokud k němu má `gtin` přiřazené ID. To platí pro všechny typy reklam, ale je to relevantní pouze pro vykreslování produktových reklam. Příklad odpovědi na produktovou reklamu je uveden níže:
```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="
}
```
Chcete-li zajistit zobrazení nabídky správného prodávajícího, měli byste si přečíst `sellerId` poskytnuté společností Epsilon Retail Media a zobrazit zákazníkovi nabídku správného prodávajícího.
### Vylepšení hlášení objednávek
Při hlášení objednávek do Epsilon Retail Mediabudete muset také zadat `sellerId` pro každou unikátní kombinaci `gtin` při hlášení objednávek do Epsilon Retail Media.
{% hint style="warning" %}
Tento krok je povinný a nelze jej vynechat, jinak nebudou reklamy přiřazovány k objednávkám.
{% endhint %}
#### Synchronizace objednávek pomocí souboru
Do souboru objednávek budete muset přidat další sloupec/sekci `seller_id`. Každá kombinace `seller_id` a `product_code` kombinace musí být unikátní řádek. U zakoupených produktů mimo tržiště může být `seller_id` prázdný.
Příklady naleznete na adrese [Synchronizace údajů o objednávkách pomocí souboru](/retail-media-interface/integration/cs/data-api/order-data-1/syncing-order-data-via-file.md)
#### Synchronizace objednávek přes API
Při synchronizaci objednávek přes API budete muset při hlášení objednávek synchronizovat `sellerId` tam, kde je to relevantní. V případě, že zakoupený produkt nemá `sellerId`, lze jej vynechat.
Níže je uveden příklad objednávky, kde jeden produkt pochází od prodávajícího z tržiště a druhý není produktem z tržiště:
```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"
}
]
}
]
}
```
## Migrace stávajících týmů
Pokud rozšiřujete integraci o podporu prodávajících z tržiště, musíte vy nebo vaši inzerenti provést několik kroků. Je důležité vědět, jak produkty fungují v systému Epsilon Retail Media .
Produkt bez ID prodávajícího a produkt s ID prodávajícího jsou v systému Epsilon Retail Media dvě unikátní entity. Jako takové je třeba kampaně migrovat, aby byla vybrána správná nová varianta produktu pro všechny stávající kampaně, které je třeba aktualizovat.
1. Informujte svého technického account manažera v Epsilon Retail Media o svém záměru povolit funkci ID prodávajícího na tržišti
2. Váš technický account manažer by měl být schopen zajistit, aby naší interní atribuci nic nebránilo v registraci migrujících týmů
3. Rozšiřte katalog produktů o produkty s ID prodávajícího
4. Vylepšete hlášení objednávek tak, aby vykazovalo ID prodávajícího
5. Pokud migrujete stávající týmy, upravte stávající týmy a zadejte ID prodávajícího
6. Po úpravě týmu je třeba upravit kampaně daného týmu a znovu vybrat produkty. Je to proto, že v kampani potřebujeme vybrat nový produkt s ID prodávajícího, zatímco kampaně vytvořené předtím, než měl tým ID prodávajícího, nebudou mít vybranou správnou variantu produktu.
---
# 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/cs/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.