> 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/sk/feature-integrations/marketplace-sellerid.md).
# Marketplace sellerId
## Čo je marketplace?
Marketplace predstavuje jedinečnú príležitosť pre predajcov rozšíriť svoju prítomnosť na internete a zároveň s ľahkosťou osloviť nových alebo príležitostných kupujúcich. Marketplace umožňuje menším firmám osloviť širokú škálu zákazníkov, pričom tovar zákazníkovi zvyčajne odosiela priamo predajca z marketplace.
Marketplace umožňuje predajcom predávať svoje produkty na stránke predajcu, čím sa zvyšuje viditeľnosť ich produktov pre širšie publikum. Predajcovia zároveň získavajú dodatočnú ponuku produktov na predaj širšiemu okruhu zákazníkov.
Okrem monetizácie vašej stránky pomocou funkcií marketplace môžu predajcovia využiť aj tento prémiový online priestor na pultoch a ponúknuť predajcom na marketplace príležitosť uchádzať sa o najvyššie pozície prostredníctvom Epsilon Retail Media prostredníctvom dokumentácie uvedenej nižšie.
## Nastavenie inzerentov marketplace
Po dokončení vylepšení integrácie (podrobne popísaných nižšie) budete môcť nastaviť Seller ID pre každý tím. Toto je možné vykonať iba pri vytváraní tímu z tímu predajcu; nie je to možné vykonať pri úprave tímu ani zo strany dodávateľa.
Pri vytváraní nového tímu sa nachádza sekcia „Optional fields“, kde je možné vybrať Seller ID. Seller IDs, ktoré je možné vybrať, pochádzajú priamo z vášho katalógu produktov. Nemôžete zadať hodnotu, ktorá sa nenachádza v katalógu produktov.
## Požiadavky na integráciu
### Prehľad na vysokej úrovni
Okrem štandardnej integrácie s Epsilon Retail Mediabude musieť byť vaša integrácia vylepšená o nižšie uvedené zmeny:
* Implementujte sellerId pre každý produkt v súbore katalógu produktov alebo API
* Spracujte odpoveď na reklamu a v príslušných prípadoch zobrazte ponuku správneho predajcu
* Nahláste sellerId pre každý unikátny produkt pri hlásení objednávok pre Epsilon Retail Media
{% hint style="warning" %}
V súčasnosti Epsilon Retail Mediafunkcia plne nepokrýva prípad použitia, kedy predajca produktu nemá žiadne seller ID a zároveň existujú varianty produktov so seller ID. Identifikovaným náhradným riešením je synchronizácia seller ID predajcu na akomkoľvek produkte, ktorý nepochádza z marketplace, a toto seller ID musí byť pridané každému dodávateľovi, ktorý nie je predajcom na marketplace. Ak sa chcete dozvedieť viac, kontaktujte svojho technického account manažéra.
{% endhint %}
### Vylepšenia katalógu produktov.
Vo vašom katalógu produktov synchronizovanom so službou Citrus budete musieť zadať sellerId pre každý unikátny kód produktu pre Epsilon Retail Media.
#### Synchronizácia katalógu cez súbor
Do súboru katalógu budete musieť pridať ďalší stĺpec/sekciu `seller_id`Každá kombinácia `seller_id` a `product_code` musí byť unikátny riadok. Pre produkty, ktoré nepochádzajú z marketplace, môže byť `seller_id` prázdny.
{% hint style="warning" %}
Produkty, ktoré majú značkového predajcu (kde produkt nemá sellerId) aj predajcov na marketplace (kde ten istý produkt má varianty so sellerId), sú v súčasnosti nekompatibilné. Ak máte produkty, ktoré spadajú do tejto kategórie, odporúčame vám v tejto chvíli pre tieto konkrétne produkty zapojiť iba predajcov z marketplace.
Ak je vaša e-commerce stránka nastavená s týmto konkrétnym prípadom použitia produktov, žiadosť o riešenie tohto problému adresujte svojmu Epsilon Retail Media kontaktu, keďže zvažujeme zabezpečenie kompatibility pre tento prípad použitia.
{% endhint %}
Príklady nájdete na [Synchronizácia katalógu a produktu cez súbor](/retail-media-interface/integration/sk/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Synchronizácia katalógu cez API
Pri synchronizácii produktov cez API budete musieť synchronizovať `sellerId` pre každú unikátnu `sellerId` & `gtin` kombináciu.
```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šenia odpovede na reklamu
Keď Epsilon Retail Media zobrazuje reklamy, zobrazí sa `sellerId` ak k nemu `gtin` má priradené. Toto platí pre všetky typy reklám, ale je to relevantné iba pre zobrazovanie reklám z produktových reklám. Príklad odpovede na produktovú reklamu je uvedený nižšie:
```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="
}
```
Aby sa zabezpečilo zobrazenie ponuky správneho predajcu, mali by ste si prečítať `sellerId` poskytnuté Epsilon Retail Media a zobraziť zákazníkovi ponuku správneho predajcu.
### Vylepšenia hlásenia objednávok
Pri hlásení objednávok pre Epsilon Retail Mediabudete musieť špecifikovať aj `sellerId` pre každú unikátnu `gtin` keď hlásite objednávky pre Epsilon Retail Media.
{% hint style="warning" %}
Tento krok je povinný a nemožno ho vynechať, inak sa reklamy nepriradia k objednávkam.
{% endhint %}
#### Synchronizácia objednávok cez súbor
Do súboru objednávok budete musieť pridať ďalší stĺpec/sekciu `seller_id`Každá kombinácia `seller_id` a `product_code` kombinácia musí byť unikátny riadok. Pre zakúpené produkty, ktoré nepochádzajú z marketplace, môže byť `seller_id` prázdny.
Príklady nájdete na [Synchronizácia údajov o objednávkach cez súbor](/retail-media-interface/integration/sk/data-api/order-data-1/syncing-order-data-via-file.md)
#### Synchronizácia objednávok cez API
Pri synchronizácii objednávok cez API budete musieť pri hlásení objednávok v príslušných prípadoch synchronizovať `sellerId` V prípade, že zakúpený produkt nemá `sellerId`je možné ho vynechať.
Nižšie je uvedený príklad objednávky, kde jeden produkt pochádza od predajcu z marketplace a druhý nie je produktom z 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"
}
]
}
]
}
```
## Migrácia existujúcich tímov
Ak vylepšujete svoju integráciu na podporu predajcov z marketplace, vy alebo vaši inzerenti musíte podniknúť niekoľko krokov. Je dôležité vedieť, ako produkty fungujú v systéme Epsilon Retail Media systéme.
Produkt bez ID predajcu a produkt s ID predajcu sú dve unikátne entity v Epsilon Retail Media A preto je potrebné kampane migrovať tak, aby sa vybral správny nový variant produktu pre všetky existujúce kampane, ktoré je potrebné aktualizovať.
1. Informujte svojho Epsilon Retail Media technického account manažéra o svojom zámere povoliť funkciu seller ID pre marketplace
2. Váš technický account manažér by mal byť schopný zabezpečiť, aby bola naša interná atribúcia nakonfigurovaná na zvládnutie migrácie tímov
3. Vylepšite katalóg produktov o produkty so seller ID
4. Vylepšite hlásenie objednávok tak, aby sa hlásilo seller ID
5. Ak migrujete existujúce tímy, upravte existujúce tímy a špecifikujte seller ID
6. Po úprave tímu je potrebné upraviť kampane každého tímu, aby sa produkty vybrali znova. Je to preto, že v kampani potrebujeme vybrať nový produkt so seller ID, zatiaľ čo kampane vytvorené pred tým, ako mal tím seller ID, nebudú mať vybraný správny variant 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/sk/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.