Datenanforderungen - Topsort Documentation

T-Brain lernt aus Ihren Produktinformationen und der Käuferaktivität. Sie können Daten aus Ihren bestehenden Systemen hochladen oder, wenn Sie Topsort-Kunde sind, bereits aus Topsort synchronisierte Datensätze verwenden. Stellen Sie zum Start Ihren Katalog und mindestens einen Monat Ereignisverlauf bereit, einschließlich aller Käufe sowie bezahlter Produktklicks und Impressionen.

Datensatztypen

Ein Datensatz ist eine benannte Datensammlung, mit der ein Modell trainiert wird. T-Brain unterstützt drei Datensatztypen:

Datensatztyp	Inhalt
Categories	Kategorienamen und ihre Stelle in der Kataloghierarchie.
Products	Produktinformationen, einschließlich Kennungen, Beschreibungen, Marken und Kategoriezuordnungen.
Events	Käuferaktivität, einschließlich Impressionen, Klicks und Käufen.

Sie können Datensätze benennen, um Zweck oder Quelle zu unterscheiden, zum Beispiel products-main-store oder events-september.

Daten hochladen

Gehen Sie zu Data.
Klicken Sie auf Add dataset.
Wählen Sie Categories, Products oder Events.
Geben Sie dem Datensatz einen Namen.
Laden Sie Ihre Parquet-Dateien hoch und folgen Sie den Anweisungen.

T-Brain zeigt die erforderliche Struktur für jeden Datensatztyp und prüft, ob Ihre Dateien ihr entsprechen. Die Tabellen unten erklären die Spalten in den Upload-Anforderungen. Felder mit Required müssen gefüllt sein. Andere Felder liefern Produktinformationen, Beziehungen oder den Kontext, den Ihr Anwendungsfall braucht.

Spalte	Typ	Anforderung	Beschreibung
`category_id`	String	Required	Eindeutige Kategoriekennung. Produkte verweisen über `category_ids` auf diesen Wert.
`name`	String	Required	Anzeigename der Kategorie.
`path`	String	Optional	Durch Punkte getrennte Kategoriehierarchie, die allgemeinste Kategorie zuerst.

Products

Produkt-Uploads sind Momentaufnahmen. Jeder Upload sollte den vollständigen Produktsatz enthalten.

Spalte	Typ	Anforderung	Beschreibung
`product_id`	String	Required	Eindeutige Produktkennung. Muss exakt der entsprechenden `product_id` in den Ereignisdatensätzen entsprechen.
`name`	String	Optional	Produktanzeigename, der dem Modell hilft, das Produkt zu verstehen.
`description`	String	Optional	Produktbeschreibung. HTML wird akzeptiert und bei der Verarbeitung entfernt.
`image_url`	String	Optional	Produktbild-URL, verwendet beim Erzeugen von Bild-Embeddings.
`brand_id`	String	Optional	Markenkennung.
`brand_name`	String	Optional	Anzeigename der Marke.
`category_ids`	List of strings	Optional	Kategoriekennungen, die Datensätzen im Kategoriedatensatz entsprechen.
`price`	Decimal	Optional	Preis in den Währungseinheiten Ihres Marketplaces. 0 ist ein gültiger Preis; null bedeutet unbekannt.
`active`	Boolean	Optional	Ob das Produkt für die Auswahl durch das Modell verfügbar ist.
`parent_product_id`	String	Optional	Kennung des übergeordneten Produkts einer Variante.

Obwohl nur product_id strukturell erforderlich ist, geben Sie beschreibende Informationen an, wo sie vorliegen, damit das Modell nützliche Informationen über Ihre Produkte hat.

Events

Stellen Sie mindestens einen Monat Ereignisverlauf bereit. Schließen Sie alle Käufe ein, nicht nur Käufe, die Werbung zugeordnet sind, sowie bezahlte Produktklicks und Impressionen. Ereignisse müssen eine einheitliche Käuferkennung enthalten, damit Interaktionen und Käufe verbunden werden können. Im Datensatz steht diese Kennung in user_id und muss über Sitzungen und Tage hinweg stabil bleiben. Ereignis-Uploads sind additiv. Sie können Aktivität aus weiteren Zeiträumen hinzufügen.

Spalte	Typ	Anforderung	Beschreibung
`event_id`	String	Required	Eindeutige Kennung der Ereigniszeile. Jede Kaufposition hat eine eigene Kennung.
`event_type`	String	Required	Art der Aktivität. Siehe unterstützte Werte unten.
`ts`	Datetime	Required	Wann die Aktivität stattfand, nicht wann die Datei hochgeladen wurde.
`user_id`	String	Needed to connect shopper activity	Einheitliche Käuferkennung über Sitzungen und Tage hinweg.
`product_id`	String	Where applicable	Am Ereignis beteiligtes Produkt. Kann bei Seiten- und Request-Ereignissen null sein.
`request_id`	String	Where applicable	Request- oder Auktionskennung, die dem Ereignis zugeordnet ist.
`source`	String	Where applicable	`sponsored` oder `organic`.
`placement`	String	Optional	Wo auf der Seite die Interaktion stattfand.
`search_term`	String	Optional	Suchanfrage des Käufers, dekodiert und bereinigt.
`page_type`	String	Optional	`home`, `category`, `search`, `pdp` oder `other`. `pdp` bedeutet Produktdetailseite.
`device`	String	Optional	`mobile` oder `desktop`.
`category`	String	Where applicable	Kategoriekennung, die der Request oder der Seite zugeordnet ist.
`order_id`	String	For purchase rows	Gruppiert die Produktpositionen derselben Bestellung.
`quantity`	Integer	For purchase rows	Anzahl der auf dieser Position gekauften Einheiten.
`unit_price`	Decimal	For purchase rows	Gezahlter Preis pro Einheit, in den Währungseinheiten Ihres Marketplaces.
`product_ids`	List of strings	For request rows	Produkte, die in der Request angezeigt oder berücksichtigt wurden.

Unterstützte Ereignistypen

Wert	Bedeutung
`impression`	Ein Käufer hat eine Produktplatzierung gesehen.
`click`	Ein Käufer hat ein Produkt angeklickt.
`add_to_cart`	Ein Käufer hat ein Produkt in den Warenkorb gelegt.
`page_view`	Ein Käufer hat eine Seite angesehen.
`purchase`	Ein Käufer hat ein Produkt gekauft.

Kennungen einheitlich halten

Verwenden Sie exakte, einheitliche Kennungen über Datensätze hinweg:

Die product_id eines Ereignisses muss der product_id des Produktdatensatzes entsprechen.
Werte in category_ids eines Produkts müssen der category_id der Kategoriedatensätze entsprechen.
Verwenden Sie dieselbe user_id für denselben Käufer bei Interaktionen und Käufen.
Geben Sie jeder Kaufposition eine eindeutige event_id und verwenden Sie order_id, um Positionen derselben Bestellung zu gruppieren.

Einen hochgeladenen Datensatz aktualisieren

Klicken Sie in Data neben dem Datensatz, den Sie aktualisieren wollen, auf Add Files. Liefern Sie für Produkte und Kategorien eine vollständige Momentaufnahme. Fügen Sie für Ereignisse die neuen Ereignisdatensätze hinzu. Wenn der Datensatz aktualisiert ist, trainieren Sie jedes Modell neu, das aus den aktualisierten Informationen lernen soll. Dateien hinzuzufügen aktualisiert ein bereits trainiertes Modell nicht automatisch.

Synchronisierte Topsort-Datensätze verwenden

Wenn Sie Topsort-Kunde sind, sind bereits drei Datensätze verfügbar:

Topsort-categories
Topsort-products
Topsort-events

Diese Datensätze werden in Echtzeit aktualisiert. Sie können sie beim Erstellen einer Aufgabe auswählen, statt dieselben Informationen selbst hochzuladen. Echtzeit-Aktualisierungen der Datensätze trainieren bereitgestellte Modelle nicht automatisch neu.

Mit Ihren Datensätzen trainieren

Gehen Sie zu Tasks, wählen Sie, was das Modell tun soll, und wählen Sie die passenden Datensätze. Eine Produktranking-Aufgabe verwendet zum Beispiel Produkte und Ereignisse. Starten Sie das Training, verfolgen Sie den Fortschritt in Training und prüfen Sie die Modellqualität in Evals, bevor Sie bereitstellen.

Datenschutz und Zugriff

Ihre hochgeladenen Daten und fine-getunten Modelle sind pro Einzelhändler isoliert. Aufbewahrungs- und Löschrichtlinien können nach Ihren Anforderungen konfiguriert werden. Sprechen Sie mit einem Topsort-Vertriebsmitarbeiter, um den Zugriff zu vereinbaren. Die API-Dokumentation ist auf Anfrage verfügbar, einschließlich Authentifizierung, Anfrage- und Antwortformaten, Latenz und Ratenlimits.

​Datensatztypen

​Daten hochladen

​Categories

​Products

​Events

​Unterstützte Ereignistypen

​Kennungen einheitlich halten

​Einen hochgeladenen Datensatz aktualisieren

​Synchronisierte Topsort-Datensätze verwenden

​Mit Ihren Datensätzen trainieren

​Datenschutz und Zugriff