> 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/de/feature-integrations/marketplace-sellerid.md).
# Marketplace sellerId
## Was ist ein Marktplatz?
Marktplätze sind eine einzigartige Gelegenheit für Händler, ihre Online-Präsenz auszubauen sowie neue oder gelegentliche Käufer mit Leichtigkeit anzusprechen. Marktplätze ermöglichen es kleineren Unternehmen, eine Vielzahl von Kunden zu erreichen, wobei die Ware in der Regel direkt vom Marktplatz-Verkäufer an den Kunden versendet wird.
Marktplätze ermöglichen es Verkäufern, ihre Produkte auf der Website eines Händlers zu verkaufen, wodurch ihre Produkt-Sichtbarkeit für ein breiteres Publikum erhöht wird. Händler wiederum gewinnen zusätzliche Produktangebote, die sie an eine breitere Kundenpalette verkaufen können.
Zusätzlich zur Monetarisierung Ihrer Website mit Marktplatz-Funktionen können Händler auch von diesem erstklassigen Online-Stellplatz profitieren und Marktplatz-Anbietern die Möglichkeit bieten, für Spitzenpositionen zu bieten über Epsilon Retail Media durch die unten aufgeführte Dokumentation.
## Einrichten von Marktplatz-Werbetreibenden
Sobald Ihre Integrationserweiterungen abgeschlossen sind (unten detailliert beschrieben), können Sie eine Seller ID pro Team festlegen. Dies kann nur beim Erstellen eines Teams aus dem Händler-Team heraus erfolgen; dies kann nicht beim Bearbeiten eines Teams oder durch einen Lieferanten erfolgen.
Beim Erstellen eines neuen Teams gibt es einen Abschnitt "Optionale Felder", in dem die Seller ID ausgewählt werden kann. Die auswählbaren Seller IDs stammen direkt aus Ihrem Produktkatalog. Sie können keinen Wert eingeben, der nicht im Produktkatalog vorhanden ist.
## Integrationsanforderungen
### High-Level-Übersicht
Zusätzlich zu einer Standardintegration mit Epsilon Retail Media, muss Ihre Integration um die folgenden Änderungen erweitert werden:
* Implementieren Sie eine sellerId pro Produkt in der Produktkatalogdatei oder API
* Werbeantwort parsen und das Angebot des richtigen Verkäufers rendern, wenn relevant
* Melden Sie eine sellerId pro eindeutigem Produkt, wenn Sie Bestellungen melden an Epsilon Retail Media
{% hint style="warning" %}
Derzeit deckt die Funktion von Epsilon Retail Mediaden Anwendungsfall nicht vollständig ab, bei dem ein Verkäufer eines Produkts keine Verkäufer-ID hat und es gleichzeitig Verkäufer-ID-Varianten von Produkten gibt. Eine identifizierte Übergangslösung hierfür besteht darin, eine Händler-Seller-ID für jedes Nicht-Marktplatz-Produkt zu synchronisieren, und jeder Lieferant, der kein Marktplatz-Verkäufer ist, muss diese Seller-ID hinzugefügt bekommen. Bitte kontaktieren Sie Ihren Technical Account Manager, um mehr zu erfahren.
{% endhint %}
### Produktkatalog-Erweiterungen.
In Ihrem mit Citrus synchronisierten Produktkatalog müssen Sie eine sellerId pro eindeutigem Produktcode angeben für Epsilon Retail Media.
#### Katalog über Datei synchronisieren
Sie müssen Ihrer Katalogdatei eine zusätzliche Spalte/einen zusätzlichen Abschnitt hinzufügen von `seller_id`. Jede Kombination aus `seller_id` und `product_code` muss eine eindeutige Zeile sein. Für Nicht-Marktplatz-Produkte kann die `seller_id` leer sein.
{% hint style="warning" %}
Produkte, die sowohl einen Markenverkäufer (bei dem das Produkt keine sellerId hat) als auch Marktplatz-Verkäufer haben (bei denen dasselbe Produkt sellerId-Varianten hat), sind derzeit inkompatibel. Wenn Sie Produkte haben, die in diese Kategorie fallen, empfehlen wir Ihnen, derzeit nur Marktplatz-Verkäufer für diese spezifischen Produkte einzubinden.
Wenn Ihre E-Commerce-Website für diesen speziellen Anwendungsfall von Produkten eingerichtet ist, bitten wir Sie, dieses Problem bei Ihrem Epsilon Retail Media -Ansprechpartner anzusprechen, da wir in Erwägung ziehen, diesen Anwendungsfall kompatibel zu machen.
{% endhint %}
Für Beispiele besuchen Sie bitte [Synchronisieren von Katalog und Produkt über Datei](/retail-media-interface/integration/de/data-api/catalog-products-2/syncing-catalog-products-via-file.md)
#### Katalog über API synchronisieren
Beim Synchronisieren von Produkten über die API müssen Sie eine `sellerId` pro eindeutiger Kombination aus `sellerId` & `gtin` synchronisieren.
```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"
}
]
}
```
### Werbeantwort-Erweiterungen
Wenn Epsilon Retail Media Anzeigen ausliefert, wird eine `sellerId` ausgeliefert, wenn die `gtin` eine zugeordnete hat. Dies gilt für alle Anzeigentypen, ist jedoch nur für das Anzeigen-Rendering von Produktanzeigen relevant. Eine Beispiel-Produktanzeigenantwort finden Sie unten:
```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="
}
```
Um sicherzustellen, dass das Angebot des richtigen Verkäufers angezeigt wird, sollten Sie die `sellerId` lesen, die von Epsilon Retail Media bereitgestellt wird, und dem Kunden das Angebot des richtigen Verkäufers anzeigen.
### Bestellbericht-Erweiterungen
Beim Melden von Bestellungen an Epsilon Retail Mediamüssen Sie auch die `sellerId` pro eindeutiger Kombination aus `gtin` angeben, wenn Sie Bestellungen melden an Epsilon Retail Media.
{% hint style="warning" %}
Dieser Schritt ist erforderlich und darf nicht ausgelassen werden, da Anzeigen sonst nicht den Bestellungen zugeordnet werden.
{% endhint %}
#### Bestellungen über Datei synchronisieren
Sie müssen Ihrer Bestelldatei eine zusätzliche Spalte/einen zusätzlichen Abschnitt hinzufügen von `seller_id`. Jede Kombination aus `seller_id` und `product_code` -Kombination muss eine eindeutige Zeile sein. Für gekaufte Nicht-Marktplatz-Produkte kann die `seller_id` leer sein.
Für Beispiele besuchen Sie bitte [Synchronisieren von Bestelldaten über Datei](/retail-media-interface/integration/de/data-api/order-data-1/syncing-order-data-via-file.md)
#### Bestellungen über API synchronisieren
Beim Synchronisieren von Bestellungen über die API müssen Sie beim Melden von Bestellungen gegebenenfalls die `sellerId` synchronisieren. Falls das gekaufte Produkt keine `sellerId`hat, kann sie weggelassen werden.
Unten finden Sie ein Beispiel für eine Bestellung, bei der ein Produkt von einem Marktplatz-Verkäufer stammt und ein anderes kein Marktplatz-Produkt ist:
```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"
}
]
}
]
}
```
## Migrieren bestehender Teams
Wenn Sie Ihre Integration erweitern, um Marktplatz-Verkäufer zu unterstützen, müssen Sie oder Ihre Werbetreibenden eine Reihe von Schritten unternehmen. Es ist wichtig zu wissen, wie Produkte innerhalb des System von Epsilon Retail Media funktionieren.
Ein Produkt ohne Verkäufer-ID und ein Produkt mit einer Verkäufer-ID sind zwei eindeutige Entitäten im System von Epsilon Retail Media . Daher müssen Kampagnen migriert werden, um die richtige neue Produktvariante für alle bestehenden Kampagnen auszuwählen, die aktualisiert werden müssen.
1. Informieren Sie Ihren Technical Account Manager von Epsilon Retail Media über Ihre Absicht, die Marktplatz-Verkäufer-ID-Funktion zu aktivieren
2. Ihr Technical Account Manager sollte stellen sicher können, dass unsere interne Attribuierung so konfiguriert ist, dass sie die Migration von Teams verarbeiten kann
3. Produktkatalog um Verkäufer-ID-Produkte erweitern
4. Bestellberichterstattung zur Meldung der Verkäufer-ID erweitern
5. Wenn Sie bestehende Teams migrieren, bearbeiten Sie bestehende Teams, um die Verkäufer-ID anzugeben
6. Sobald ein Team bearbeitet wurde, müssen die Kampagnen jedes Teams bearbeitet werden, um die Produkte erneut auszuwählen. Dies liegt daran, dass wir das neue Produkt mit einer ausgewählten Verkäufer-ID in der Kampagne benötigen, während bei Kampagnen, die erstellt wurden, bevor das Team eine Verkäufer-ID hatte, nicht die richtige Variante des Produkts ausgewählt ist.
---
# 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/de/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.