|
| `inventory` | Erforderlich | Zahl
32-Bit vorzeichenloser Integer empfohlen
| Der Lagerbestand des Produkts. Wenn der Wert 0 ist, werden keine Produktanzeigen für das Produkt geschaltet. | 1 |
| `description` | Erforderlich | Text
Max. 5000 Zeichen
| Die Beschreibung des Produkts. | Mit gestickten Trefoils und konturierten 3-Streifen in Kontrastweiß sind die Sport Sweat Shorts ein frisches Angebot von Adidas Originals. |
| `KEY (as a value)` | Erforderlich für Kategorie- und Broad-Display-Platzierungen | Text
Max. 1000 Zeichen pro Spalte
| Wenn dieser Spaltentyp verwendet wird, müssen Händler einen Wert für \ angeben.
Sie können mehrere Spalten mit dieser Syntax in einer TSV-Datei haben.
| Der Spaltenname kann „brand“ lauten und der Wert der Zelle in der Spalte kann „green-fairy“ sein. Dies führt zu einem Filter von "brand:green-fairy" für das Produkt. |
| `subClassName` | Veraltet.
Erforderlich für Produkt-Cross/Upsell-Platzierungen
| Text
Max. 750 Zeichen
| Der Name der Unterklasse/Kategorie, in der sich das betreffende Produkt befindet.
Unterklassen ermöglichen ein besseres Produkt-Targeting, z. B. kann ein Butterprodukt auf Brot targeten, aber nicht auf Pflaster.
| Käse |
| `xSellSubClassName` | Veraltet.
Erforderlich für Produkt-Cross/Upsell-Platzierungen
| Text
Max. 750 Zeichen
| Die Namen der Unterklassen/Kategorien, innerhalb derer das relevante Produkt auf Produkte targeten kann. | Brote, Aufstriche, Craker |
| `price` | Optional | Zahl
2 Dezimalstellen empfohlen
| Der Preis eines Produkts. | 30.00 |
| `brand` | Erforderlich | Text
Max. 70 Zeichen
| Die Marke des Produkts. | Tommy Hilfiger |
| `type` | Erforderlich | Text
Max. 750 Zeichen
| Der Produkttyp. | Bekleidung |
| `retailer_taxonomy` | Erforderlich für erweiterte Attribution. Darf keine Leerzeichen enthalten zwischen `>` Zeichen | Text
Max. 750 Zeichen
| Ihre individuelle Händler-Taxonomie des Produkts. | Herren>Herrenbekleidung>Pullover |
| `google_taxonomy` | Erforderlich für erweiterte Attribution, wenn `retailer_taxonomy` nicht bereitgestellt werden kann | Text
Max. 750 Zeichen
| Die Standard-Google-Taxonomie des Produkts. Weitere Informationen finden Sie hier: | Bekleidung & Accessoires > Bekleidung > Oberteile |
| `global_identifier` | Erforderlich | Text
Max. 50 Zeichen
| Der globale Bezeichner für das Produkt. | 08719108994761 |
| `global_identifier_type` | Erforderlich | Text | Der Typ des globalen Bezeichners. | GTIN |
| `custom_payload` | Nicht erforderlich, außer wenn empfohlen. | Base64-kodiertes Byte-Array | Dieses Feld enthält eine benutzerdefinierte Payload, die bis zur Anzeigengenerierung durchgereicht werden sollte. Das Feld sollte ein gültiges JSON-Objekt enthalten, das in ein Byte-Array serialisiert und Base64-kodiert ist. Das JSON-Objekt sollte einem Schema entsprechen. | Siehe Abschnitt über benutzerdefinierte Payloads. |
| `hfss` | Optional | Boolean | Wird verwendet, um anzugeben, ob ein Produkt HFSS ist oder nicht. Dies wird weiter genutzt in Epsilon Retail Medias Benutzeroberfläche. Lesen Sie unsere [HFSS-Dokumentation](/retail-media-interface/integration/de/feature-integrations/placement-level-product-type-blocking-hfss-support.md) für weitere Informationen. | true |
| `seller_id` | Optional | Text
Max. 50 Zeichen
| Die eindeutige Id des Verkäufers. Nur erforderlich, wenn Marketplace-Verkäufer geonboardet werden. Kann für Nicht-Marketplace-Produkte leer gelassen werden.
Es gibt zusätzliche Anforderungen für die Integration von seller\_ids, bitte beziehen Sie sich auf Marktplatz sellerId für weitere Informationen.
| aes-de4-ss |
Eine Beispieldatei, die als Tabelle dargestellt ist, ist unten zu sehen:
| `product_code` | `name` | `image_url` | `inventory` | `description` | `filter:Category` | `filter:Size` | `filter:Country` | `groups` | `price` | `brand` | `type` | `retailer_taxonomy` | `google_taxonomy` | `global_identifier` | seller\_id | subClassName | xSellSubClassName |
| -------------- | ------------------------------------- | ------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------- | --------------------- | ------------------------------------ | ------- | ----------- | ------- | ---------------------------------- | --------------------------------------------------------------------------------- | ------------------- | ----------------- | ------------ | ----------------- |
| 80591101 | Green Fairy Absinth Geschenkset 500ml | | `20` | Dieses Green Fairy Absinth & Löffel Geschenkset ist das perfekte Geschenk für jeden Absinth- oder Cocktailliebhaber. Platzieren Sie einen Würfel Zucker auf dem Löffel und gießen Sie den Absinth darüber, um diese Spirituose auf authentische Weise zu trinken! | Geschenke, Alkoholisch, Geschenksets | 500ml | Tschechische Republik | Geschenke, Alkoholisch, Geschenksets | `5.00` | Green Fairy | Alkohol | Geschenke>Alkoholisch>Geschenksets | Lebensmittel, Getränke & Tabak>Getränke>Alkoholische Getränke>Spirituosen>Absinth | 8594001443079 | 7328s-dmie3-9jdae | Geschenksets | Spirituosen |
{% hint style="info" %}
TSV-Dateien können nicht im Anführungszeichen-Format vorliegen.
{% endhint %}
## Aktualisieren von Produktbildern
Epsilon zwischenspeichert Bild-URLs, um eine konsistente Leistung zu gewährleisten und Anfragen an Ihren Bildserver zu reduzieren. Wenn Sie ein Bild aktualisieren, ohne seine URL zu ändern, müssen Sie explizit eine Aktualisierung auslösen in Epsilon. Um dies zu tun:
* Entfernen Sie die bestehende image\_url vom Produkt.
* Senden Sie dieselbe image\_url erneut, sobald das Update abgeschlossen ist.
Alternativ können Sie, falls Ihr Bildserver dies unterstützt, eine Aktualisierung erzwingen, indem Sie einen Query-String (zum Beispiel eine Version oder einen Zeitstempel) an die bestehende URL anhängen. Dies führt dazu, dass Epsilon das Bild neu lädt..
{% hint style="info" %}
Bilder werden nur in der Benutzeroberfläche verwendet
Produktbilder werden nicht in Anzeigenantworten bereitgestellt. Alle Bildaktualisierungen wirken sich nur darauf aus, wie das Produkt in der Epsilon UI erscheint, während die Cache-Aktualisierung erfolgt.
{% endhint %}
## XML-Dateien - geplante Einstellung
{% hint style="danger" %}
️ Veraltet für Neukunden
Das Folgende wird für Bestandskunden bereitgestellt, die noch das XML-Format nutzen. Für das Onboarding neuer Kataloge unterstützen wir die oben dokumentierten TSV- und CSV-Formate, die eine größere Dateiflexibilität sowie die Möglichkeit bieten, die Datei mehrmals täglich zu synchronisieren.
{% endhint %}
Epsilon Retail Media hat eine Liste von Tags definiert, die verwendet werden, um ein XML-Dokument für Produkte zu beschreiben. Die folgende Tabelle zeigt die Tags und ihre Beschreibungen. Das Tag „item“ wird verwendet, um ein Produkt in einem XML-Dokument zu beschreiben. Alle anderen Tags für die anderen Felder müssen innerhalb dieses Tags geschrieben werden.
| XML-Tags | Erforderlich/optional | Beschreibung |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `item` | Erforderlich | Dieses Tag wird verwendet, um ein Produkt zu beschreiben. Alle anderen XML-Tags für ein Produkt müssen sich innerhalb dieses Tags befinden. Ein XML-Dokument für Produkte muss eine Liste von item-Tags enthalten. Dieses Feld ist identisch mit den Feldern gtin und product\_code bei der API- und TSV-Dateisynchronisierung. |
| `id` | Erforderlich | Ein Code zur Identifizierung des Produkts in Ihrem System. Entspricht `product_code` in TSV-Dateien. Dieses Feld ist identisch mit den Feldern gtin und item bei der API- und XML-Dateisynchronisierung. |
| `title` | Erforderlich | Der Name des Produkts. |
| `image_link` | Erforderlich
Max. 50 Zeichen
| Ein Hyperlink zum Bild eines Produkts. Muss eine gültige URL sein. |
| `brand` | Erforderlich
Max. 70 Zeichen
| Die Marke des Produkts. |
| `availability` | Erforderlich
32-Bit vorzeichenloser Integer empfohlen
| Dieses Tag dient zur Beschreibung des Bestands eines Produkts. Der Wert muss eine Zahl sein. |
| `description` | Erforderlich
Max. 5000 Zeichen
| Dieses Tag dient zur Beschreibung einer Beschreibung eines Produkts. |
| `price` | Optional
2 Dezimalstellen empfohlen
| Dieses Tag dient zur Beschreibung des Preises eines Produkts. Wenn der Wert innerhalb des Tags angegeben ist, muss er eine Zahl sein. |
| `type` | Optional
Max. 750 Zeichen
| Der Produkttyp. |
| `retailer_taxonomy` | Erforderlich für erweiterte Zuordnung. Auch für Kategorie-Integrationen erforderlich.
Max. 750 Zeichen
| Ihre individuelle Händler-Taxonomie des Produkts. z.B. Herren>Herrenbekleidung>Pullover |
| `google_taxonomy` | Erforderlich für erweiterte Attribution, wenn retailer\_taxonomy nicht bereitgestellt werden kann
Max. 750 Zeichen
| Die Standard-Google-Taxonomie des Produkts. Weitere Informationen finden Sie hier: |
| `global_identifier` | Erforderlich
Max. 50 Zeichen
| Der globale Bezeichner für das Produkt. z.B. `08719108994761` |
| `global_identifier_type` | Erforderlich | Der Typ des globalen Bezeichners. z.B. `GTIN` |
| `custom_payload` | Nicht erforderlich, außer wenn empfohlen. | Dieses Feld enthält eine benutzerdefinierte Payload, die bis zur Anzeigengenerierung durchgereicht werden sollte. Das Feld sollte ein gültiges JSON-Objekt enthalten, das in ein Byte-Array serialisiert und Base64-kodiert ist. Das JSON-Objekt sollte einem Schema entsprechen. |
| `hfss` | Optional | Wird verwendet, um anzugeben, ob ein Produkt HFSS ist oder nicht. Dies wird weiter genutzt in Epsilon Retail Medias Benutzeroberfläche. Lesen Sie unsere [HFSS-Dokumentation](/retail-media-interface/integration/de/feature-integrations/placement-level-product-type-blocking-hfss-support.md) für weitere Informationen. |
| `seller_id` | Optional
Max. 50 Zeichen
| Die eindeutige Id des Verkäufers. Nur erforderlich, wenn Marketplace-Verkäufer geonboardet werden. Kann für Nicht-Marketplace-Produkte leer gelassen werden.
Es gibt zusätzliche Anforderungen für die Integration von seller\_ids, bitte beziehen Sie sich auf Marktplatz sellerId für weitere Informationen.
|
Ein Beispiel für ein gültiges XML-Dokument mit den Tags ist unten skizziert:
```xml
-
80591011
Melissa & Doug Dinosaur Stamp Set, 4yrs+
Imagine a rugged landscape littered with volcanoes, and full of dinosaurs roaming around
https://www.retailer.com/productImages/image1.jpg
£9.99
Melissa & Doug
Food Cupboard
10
true
-
87086011
Waitrose Splits Strawberry Ice Lollies
Strawberry splits; Suitable for vegetarians. Strawberry splits vanilla flavoured ice cream with a fruity strawberry ice coating. Our fundamental belief is that few things in life are more important than the food you buy. Good quality is essential.
https://www.retailer.com/productImages/image2.jpg
£1.25
Waitrose
Frozen Ice Cream Ice Cream Lollies
20
Waitrose
false
432un3-sd32s-ssaar
```
## Benutzerdefinierte Payloads
### Was sind benutzerdefinierte Payloads?
Benutzerdefinierte Payloads sind Felder, die unverändert von der Katalogaufnahme bis zur Anzeigenauslieferung durchgereicht werden. Es werden keine Transformationen auf das Feld angewendet. Es wird jedoch eine auf JSON Schema () basierende Validierung für das Feld durchgeführt. Die Payload-Spezifikation wird über den folgenden Link bereitgestellt (JSON Schema-Notation):
In der Produktanzeigenantwort wird die exakte benutzerdefinierte Payload an den Integrator in einem Feld namens `customPayload`zurückgegeben. Ein Beispiel für eine gültige Payload ist unten angegeben:
```json
{
"id": "102013703",
"upc": "4400000463",
"name": "Bee Farms Honey - 14.4 Oz",
"nutrientName": [
"Kosher"
],
"description": "Honey",
"brand": "Bee Farms",
"imageUrl": "https://www.retailer.com/products/1/image.png",
"productUrl": "https://www.retailer.com/products/1/page.html",
"aisleId": "1_22_2_3",
"departmentName": "Breakfast ",
"aisleName": "Breakfast spreads",
"shelfName": "Honeu",
"salesRank": 481,
"details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.",
"averageWeight": 0,
"displayType": 0,
"stores": [
{
"storeId": "2543",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
},
{
"storeId": "2544",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
}
]
}
```
{% hint style="warning" %}
Nur Datei
Bitte beachten Sie, dass benutzerdefinierte Payloads nur bei der Synchronisierung von Produkten über eine Datei unterstützt werden.
{% endhint %}
### Benutzerdefinierte Nutzlasten bei der Anzeigenerstellung
Bei der Rückgabe von Produktanzeigen wird die benutzerdefinierte Nutzlast als Teil der erstellten Anzeige durchgereicht. Die zurückgegebenen Anzeigen-Nutzlasten enthalten ein zusätzliches Feld `customPayload` das ein JSON-Objekt enthält, das derselben Spezifikation entspricht wie die im Feed bereitgestellten Informationen.
Eine Beispielantwort könnte sein:
```json
{
"ads": [
{
"id": "display_SEY2W7-VZzspoirbw4ANs-r-w6YyODk5MDQ5UA==",
"gtin": "4400000463",
"customPayload": {
"id": "102013703",
"upc": "4400000463",
"name": "Bee Farms Honey - 14.4 Oz",
"nutrientName": [
"Kosher"
],
"description": "Honey",
"brand": "Bee Farms",
"imageUrl": "https://www.retailer.com/products/1/image.png",
"productUrl": "https://www.retailer.com/products/1/page.html",
"aisleId": "1_22_2_3",
"departmentName": "Breakfast ",
"aisleName": "Breakfast spreads",
"shelfName": "Honeu",
"salesRank": 481,
"details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.",
"averageWeight": 0,
"displayType": 0,
"stores": [
{
"storeId": "2543",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
},
{
"storeId": "2544",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
}
]
} ,
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2019-12-10T01:46:07.516943179Z"
}
],
"banners": [],
"products": []
}
```
{% hint style="warning" %}
Da benutzerdefinierte Nutzlasten eine zusätzliche Arbeitslast für unseren Anzeigenerstellungsdienst darstellen, beachten Sie bitte, dass Integrationen mit benutzerdefinierten Nutzlasten nicht dem Epsilon Retail Media SLA unterliegen, sofern nicht anders angegeben.
{% endhint %}
---
# 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/data-api/catalog-products-2/syncing-catalog-products-via-file.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.