> 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/hu/feature-integrations/marketplace-sellerid.md).
# Marketplace sellerId
## Mi az a marketplace (piac) Handles?
A marketplace-ek egyedülálló lehetőséget kínálnak a kiskereskedőknek online jelenlétük bővítésére, valamint az új vagy alkalmi vásárlók könnyű megszólítására. A marketplace-ek lehetővé teszik a kisebb vállalkozások számára, hogy a vásárlók széles körét érjék el, a termékeket pedig jellemzően maga a marketplace-eladó szállítja közvetlenül a vevőnek.
A marketplace-ek lehetővé teszik az eladók számára, hogy termékeiket a kiskereskedő webhelyén értékesítsék, növelve termékeik láthatóságát a szélesebb közönség számára. Míg a kiskereskedők további termékkínálatra tesznek szert, amelyet a vásárlók szélesebb körének értékesíthetnek.
Amellett, hogy monetizálja webhelyét a marketplace funkciókkal; a kiskereskedők ki is használhatják ezt a prémium online felületet, és lehetőséget biztosíthatnak a marketplace eladóknak, hogy licitáljanak a legjobb pozíciókra a következőkön keresztül: Epsilon Retail Media az alább felsorolt dokumentáción keresztül.
## Marketplace hirdetők beállítása
Amint az integrációs fejlesztések befejeződtek (részletezve alább), beállíthat egy Seller ID-t csapatonként. Ez csak akkor tehető meg, amikor csapatot hoz létre a kiskereskedelmi csapatból, nem tehető meg a csapat szerkesztésekor vagy egy beszállító által.
Új csapat létrehozásakor van egy "Optional fields" rész, ahol kiválasztható a Seller ID. A kiválasztható Seller ID-k közvetlenül a termékkatalógusból származnak. Nem adhat meg olyan értéket, amely nem szerepel a termékkatalógusban.
## Integrációs követelmények
### Magas szintű áttekintés
A standard integráción kívül a következőkkel: Epsilon Retail Media, az integrációt át kell alakítani az alábbi módosításokkal:
* Minden termékhez valósítson meg egy sellerId értéket a termékkatalógus-fájlban vagy az API-ban
* Dolgozza fel a hirdetési választ, és jelenítse meg a megfelelő eladó ajánlatát, amikor az releváns
* Jelentsen egy sellerId-t minden egyedi termék után, amikor rendeléseket jelent a következőnek: Epsilon Retail Media
{% hint style="warning" %}
Jelenleg a(z) Epsilon Retail Mediafunkciója nem fedi le teljesen azt a használati esetet, amikor egy termék eladójának nincs seller ID-ja, és a termékeknek vannak seller ID variációi is. Erre egy ismert áthidaló megoldás a kiskereskedői seller ID szinkronizálása minden nem marketplace terméken, és minden olyan beszállítónál, aki nem marketplace eladó, hozzá kell adni ezt a seller ID-t. További információkért lépjen kapcsolatba a műszaki ügyfélfelelősével.
{% endhint %}
### Termékkatalógus-fejlesztések.
A Citrus rendszerrel szinkronizált termékkatalógusában minden egyedi termékkódhoz meg kell adnia egy sellerId-t a következőknek: Epsilon Retail Media.
#### Katalógus szinkronizálása fájlon keresztül
Egy további oszlopot/szekciót kell hozzáadnia a következők katalógusfájljához: `seller_id`. Minden `seller_id` és `product_code` kombinációnak egyedi sornak kell lennie. Nem marketplace termékek esetén a `seller_id` lehet üres.
{% hint style="warning" %}
Azok a termékek, amelyek rendelkeznek márkaeladóval (ahol a terméknek nincs sellerId-ja) és marketplace-eladókkal is (ahol ugyanannak a terméknek sellerId variációi vannak), jelenleg nem kompatibilisek. Ha vannak ebben a kategóriába tartozó termékei, javasoljuk, hogy jelenleg csak a marketplace-eladókat regisztrálja ezekhez a specifikus termékekhez.
Ha az e-kereskedelmi webhelye a termékek ezen sajátos használati esetével van beállítva, arra kérjük, hogy jelezze ezt a problémát a következőkkel: Epsilon Retail Media kapcsolattartójának, mivel fontolgatjuk ezen használati eset kompatibilissé tételét.
{% endhint %}
Példákért kérjük, látogasson el ide: [Katalógus és termék szinkronizálása fájlon keresztül](/retail-media-interface/integration/hu/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Katalógus szinkronizálása API-n keresztül
Amikor termékeket szinkronizál API-n keresztül, szinkronizálnia kell egy `sellerId` értéket minden egyedi `sellerId` & `gtin` kombinációhoz.
```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"
}
]
}
```
### Hirdetési válaszok fejlesztései
Amikor a(z) Epsilon Retail Media hirdetéseket szolgál ki, egy `sellerId` kerül kiszolgálásra, ha a(z) `gtin` rendelkezik egy hozzá társítottal. Ez minden hirdetéstípusra vonatkozik, de csak a termékhirdetésekből történő hirdetésmegjelenítésnél releváns. Egy példa a termékhirdetési válaszra alább található:
```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="
}
```
A megfelelő eladó ajánlatának megjelenítése érdekében be kell olvasnia a következők által biztosított `sellerId` értéket: Epsilon Retail Media és meg kell jelenítenie a megfelelő eladó ajánlatát a vásárlónak.
### Rendelésjelentési fejlesztések
Amikor rendeléseket jelent a következőknek: Epsilon Retail Media, meg kell adnia a következőt is: `sellerId` értéket minden egyedi `gtin` amikor rendeléseket jelent a következőknek: Epsilon Retail Media.
{% hint style="warning" %}
Ez a lépés kötelező, és nem hagyható ki, különben a hirdetések nem rendelődnek hozzá a rendelésekhez.
{% endhint %}
#### Rendelések szinkronizálása fájlon keresztül
Egy további oszlopot/szekciót kell hozzáadnia a következők rendelési fájljához: `seller_id`. Minden `seller_id` és `product_code` kombinációnak egyedi sornak kell lennie. A megvásárolt nem marketplace termékek esetén a `seller_id` lehet üres.
Példákért kérjük, látogasson el ide: [Rendelési adatok szinkronizálása fájlon keresztül](/retail-media-interface/integration/hu/data-api/order-data-1/syncing-order-data-via-file.md)
#### Rendelések szinkronizálása API-n keresztül
Amikor rendeléseket szinkronizál API-n keresztül, szinkronizálnia kell a következőt: `sellerId` adott esetben a rendelések jelentésekor. Abban az esetben, ha a megvásárolt termék nem rendelkezik a következővel: `sellerId`, elhagyható.
Alább egy példa látható egy olyan rendelésre, ahol az egyik termék egy marketplace-eladótól származik, a másik pedig nem marketplace termék:
```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"
}
]
}
]
}
```
## Meglévő csapatok migrálása
Ha frissíti az integrációját a marketplace-eladók támogatásához, több lépést is meg kell tennie Önnek vagy a hirdetőinek. Fontos tudni, hogyan működnek a termékek a következőkön belül: Epsilon Retail Media rendszer.
Egy seller ID nélküli termék és egy seller ID-val rendelkező termék két egyedi entitás a következőkben: Epsilon Retail Media rendszer. Mint ilyen, a kampányokat migrálni kell a megfelelő új termékvariáció kiválasztásához minden frissítendő meglévő kampány esetében.
1. Tájékoztassa a(z) Epsilon Retail Media műszaki ügyfélfelelősét arról a szándékáról, hogy engedélyezni kívánja a marketplace seller ID funkciót
2. A műszaki ügyfélfelelősének biztosítania kell, hogy a belső attribúciónk úgy legyen konfigurálva, hogy kezelni tudja a csapatok migrálását
3. Egészítse ki a termékkatalógust seller ID termékekkel
4. Fejlessze a rendelésjelentést a seller ID jelentéséhez
5. Meglévő csapatok migrálása esetén szerkessze a meglévő csapatokat a seller ID megadásához
6. Miután egy csapatot megszerkesztettek, az egyes csapatok kampányait újra meg kell szerkeszteni a termékek ismételt kiválasztásához. Ez azért van, mert a kampányban az új, seller ID-val ellátott terméket kell kiválasztani, míg a csapat seller ID-val való kiegészítése előtt létrehozott kampányokban nem a termék megfelelő variációja lesz kiválasztva.
---
# 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/hu/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.