> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Datenanforderungen

export const LastUpdatedDe = ({date}) => {
  const label = "Zuletzt aktualisiert:";
  return <>
      <style>{`
        .last-updated-component {
          display: inline-flex;
          align-items: center;
          gap: 8px;
          padding: 10px 16px;
          border-radius: 8px;
          margin-top: 12px;
          margin-bottom: 16px;
          font-size: 14px;
          background-color: rgba(0, 0, 0, 0.05);
          border: 1px solid rgba(0, 0, 0, 0.12);
          color: rgba(0, 0, 0, 0.75);
          line-height: 1;
        }

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

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

1. Gehen Sie zu **Data**.
2. Klicken Sie auf **Add dataset**.
3. Wählen Sie **Categories**, **Products** oder **Events**.
4. Geben Sie dem Datensatz einen Namen.
5. 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.

## Categories

Kategorie-Uploads sind Momentaufnahmen. Jeder Upload sollte den vollständigen Kategoriensatz enthalten.

| 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. |

Wenn ein Path angegeben ist, muss sein letztes Segment `category_id` entsprechen. Eine Kategorie mit der ID `air-fryers` könnte zum Beispiel den Path `home.kitchen.air-fryers` haben.

Path-Segmente dürfen Buchstaben, Zahlen, Unterstriche und Bindestriche enthalten. Der Path kann null sein, bei einer Wurzelkategorie oder einem Katalog ohne Hierarchie.

## 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](https://www.topsort.com/book-a-demo), um den Zugriff zu vereinbaren. Die API-Dokumentation ist auf Anfrage verfügbar, einschließlich Authentifizierung, Anfrage- und Antwortformaten, Latenz und Ratenlimits.

***

<LastUpdatedDe date="2026-10-08" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.