Produkt-Feed - Topsort Documentation

Ein Produkt-Feed ermöglicht es Ihnen, Ihren Katalog mit Topsort zu teilen, Daten zu synchronisieren und Kampagnen aktuell zu halten. Während des Integrationsprozesses können Sie uns die URL Ihres Produkt-Feeds bereitstellen, und wir stellen sicher, dass Ihr Katalog aktuell bleibt. Unsere Plattform unterstützt mehrere Formate:

Google Product Data Specification.
Tabulatorgetrennte Werte (TSV).
Kommagetrennte Werte (CSV).

Topsort ruft Daten aus einem Produkt-Feed ab

Wenn Ihr Produktkatalog bereits auf einer Drittanbieter-Plattform wie Algolia oder VTEX ist, können wir direkt mit diesen für Updates und Synchronisierung integrieren und sicherstellen, dass die Produktinformationen korrekt sind. Detaillierte Anweisungen zum Einrichten dieser Verbindungen und spezifische Anforderungen für jede Plattform finden Sie im Abschnitt “Drittanbieter-Integrationen - Partner” unserer Dokumentation.

Google Product Data Specification

Teilen Sie Ihren Katalog mit Topsort unter Verwendung bestehender Google-Produkt-Feeds. Wir unterstützen die Google Product Data Specification.

TSV und CSV

Wir unterstützen das Teilen Ihres Katalogs über TSV- und CSV-Feeds. Die Anweisungen in diesem Abschnitt gelten für beide Formate.

Welches Format sollten Sie verwenden?Wir empfehlen die Verwendung von TSV gegenüber CSV. CSV ist fehleranfälliger, da Kommas oft in den Katalogdaten vorhanden sind.Wenn Ihr Produktname oder Kategoriename Kommas enthält, müssen Sie TSV verwenden.

Unterstützte Spalten

Name	Erforderlich	Standard	Beschreibung
`id`	ja	-	Eindeutige Kennung für jedes Produkt.
`active`	nein	true	Ob das Produkt Teil von Kampagnen oder Auktionen sein kann. Inaktive Produkte werden aus bestehenden Kampagnen entfernt.
`title`	ja	-	Name des Produkts
`category.0.name`	ja	-	Kategoriename der primären Kategorie für dieses Produkt.
`category.0.id`	nein	Slug des Kategorienamens	ID der primären Kategorie für dieses Produkt.
`vendor.0.name`	ja, wenn nicht `seller_name`	-	Anbieter des Produkts. Dies ist die Entität, die ihr eigenes Budget hat, um dieses Produkt zu bewerben und mit anderen Anbietern konkurriert.
`vendor.0.id`	ja, wenn nicht `seller_name`	Slug des Anbieternamens	ID des Anbieters dieses Produkts.
`seller_name`	ja, wenn nicht `vendor.0.name`		Anbietername des Produkts, gleicher Wert wie `vendor.0.name`.
`google_product_category`	ja	Kategorien im Google Taxonomy Format bereitgestellt.
`price`	nein	-	Produktpreis.
`image_link`	nein	-	URL zu einem Bild des Produkts.
`availability`	nein	-	Lagerstatus. Muss einer von `in stock`, `out of stock` oder `preorder` sein.
`description`	nein	-	Detaillierte Beschreibung des Produkts.

Kategorien können auf verschiedene Arten bereitgestellt werden. Aber nur eine ist erforderlich. Sie können ein Produkt mit mehreren Kategorien und Anbietern verknüpfen. Siehe den Abschnitt unten.

Dateibeispiele

Beispiel TSV mit vendor.0.name

id	name	description	vendor.0.id	vendor.0.name	vendor.0.image_link	category.0.id	category.0.name	category.1.id	category.1.name	image_link	price	availability
1293	Green Mask	Green Mask for removing imperfections, use during night or day	1710000087	Derma Laboratories		10000087	Skin Care	61	Beauty & Health	https://i.postimg.cc/0QxMWmbd/shampoo.png	23935.29	out of stock
1302	Cleanser Gel	N/A	17829100	Shiny Laboratories		10000087	Skin care			https://i.postimg.cc/0QxMWmbd/shampoo.png	16050.42	in stock

Beispiel CSV mit vendor.0.name

id,name,description,vendor.0.id,vendor.0.name,vendor.0.image_link,category.0.id,category.0.name,category.1.id,category.1.name,image_link,price,availability
1293,Green Mask,"Green Mask for removing imperfections, use during night or day",1710000087,Derma Laboratories,,10000087,Skin Care,61,Beauty & Health,https://i.postimg.cc/0QxMWmbd/shampoo.png,23935.29,out of stock
1302,Cleanser Gel,N/A,17829100,Shiny Laboratories,,10000087,Skin care,,,https://i.postimg.cc/0QxMWmbd/shampoo.png,16050.42,in stock

Mehrere Kategorien und Anbieter

Produkte können mit mehreren Kategorien und/oder Anbietern verknüpft werden. Wie Sie vielleicht bemerkt haben, enthalten die Kategorie- und Anbieterspalten Indizes. Sie können zusätzliche Kategorie- und/oder Anbieterspalten hinzufügen, solange Sie den Index entsprechend erhöhen. Zum Beispiel würde ein Produkt mit drei Kategorien und zwei Anbietern mindestens diese Spalten haben:

category.0.id
category.1.id
category.2.id
vendor.0.id
vendor.1.id

Google Taxonomy Format

Alternativ können Sie Googles Taxonomy Format als Kategorienamen verwenden. Dies ermöglicht es Ihnen, komplexere hierarchische Beziehungen zu beschreiben. Zum Beispiel diese Hierarchie:

Apparel & Accessories > Clothing > Dresses

Ergibt drei Kategorien:

[
  {
    "id": "apparel-and-accessories",
    "name": "Apparel & Accessories",
    "path": "apparel_and_accessories"
  },
  {
    "id": "clothing",
    "name": "Clothing",
    "path": "apparel_and_accessories.clothing",
    "parentId": "apparel-and-accessories"
  },
  {
    "id": "dresses",
    "name": "Dresses",
    "path": "apparel_and_accessories.clothing.dresses",
    "parentId": "clothing"
  }
]

Das Feld path wird für neue Integrationen bevorzugt. Das Feld parentId wird weiterhin vollständig unterstützt — es gibt keine Pläne, es zu entfernen.

Hosting Ihres Produkt-Feeds

Ihr Produkt-Feed muss für Topsort kontinuierlich zugänglich sein, damit wir unsere Daten aktuell halten können. Wir können derzeit auf öffentliche Produkt-Feeds oder Feeds zugreifen, die mit Basic HTTP Authorization geschützt sind. Verwenden Sie zusätzlich die ETag Response Headers, um uns zu helfen festzustellen, ob ein Produkt-Feed seit dem letzten Abruf aktualisiert wurde.

Produkte löschen

Produkte können “soft deleted” werden, indem die Eigenschaft active auf false gesetzt wird. Dies kann sowohl über die API als auch über den Produkt-Feed erfolgen. Inaktive Produkte werden nicht in neue Kampagnen oder Auktionen aufgenommen und aus allen aktiven Kampagnen entfernt, an denen sie teilnehmen. Um Produkte dauerhaft aus dem System von Topsort zu löschen, verwenden Sie die API.

Generierte Slugs

Wenn Kategorien oder Anbieter keine ID haben, generieren wir eine automatisch.

Bevorzugen Sie explizite IDsEs wird empfohlen, die IDs explizit in Ihrem Produkt-Feed anzugeben. Diese IDs werden als Referenzen bei der Verwaltung von Kampagnen und Auktionen verwendet.Wenn Sie generierte IDs verwenden, müssen Sie denselben Algorithmus auf der Marktplatzseite verwenden, um solche Referenzen zu erstellen.

Diese IDs verwenden einen Slug, der vom Namen abgeleitet wird. Ein Slug ist eine in Kebab-Case formatierte Zeichenfolge, die für die Aufnahme in URLs geeignet ist. Zum Beispiel wird Hello world zu hello-world. Das Format basiert auf der npm slugify Bibliothek.

Entwicklertools

Marktplätze, die ihren Katalog über einen Produkt-Feed senden, können Dev Tools > Katalog im Administrations-Dashboard des Marktplatzes öffnen, um den Zustand der Datenaufnahme zu überwachen, ohne ein Support-Ticket zu erstellen. Der Tab Katalog zeigt die wichtigsten Synchronisierungsmetriken auf einen Blick:

Zeitpunkt der letzten Synchronisierung: wann die letzte Katalogsynchronisierung ausgeführt wurde
Durchschnittliche Synchronisierungsdauer: wie lange Synchronisierungen normalerweise dauern
Erfolgsrate: über die letzten 14 Durchläufe
Aktuelle Synchronisierungsdurchläufe: jede Datenaufnahme mit der Anzahl verarbeiteter oder übersprungener Datensätze

Mit dieser Ansicht können Engineering-Teams bestätigen, dass Feeds planmäßig laufen, und Fehler oder Durchläufe mit vielen übersprungenen Datensätzen schnell erkennen.

​Google Product Data Specification

​TSV und CSV

​Unterstützte Spalten

​Dateibeispiele

​Beispiel TSV mit vendor.0.name

​Beispiel CSV mit vendor.0.name

​Mehrere Kategorien und Anbieter

​Google Taxonomy Format

​Hosting Ihres Produkt-Feeds

​Produkte löschen

​Generierte Slugs

​Entwicklertools

Google Product Data Specification

TSV und CSV

Unterstützte Spalten

Dateibeispiele

Beispiel TSV mit vendor.0.name

Beispiel CSV mit vendor.0.name

Mehrere Kategorien und Anbieter

Google Taxonomy Format

Hosting Ihres Produkt-Feeds

Produkte löschen

Generierte Slugs

Entwicklertools