- Google Product Data Specification.
- Tabulatorgetrennte Werte (TSV).
- Kommagetrennte Werte (CSV).
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. |
Dateibeispiele
Beispiel TSV mit vendor.0.name
Beispiel CSV mit vendor.0.name
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: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: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 Eigenschaftactive 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. 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 wirdHello world zu hello-world.
Das Format basiert auf der npm slugify Bibliothek.
