OneTrace.pro Hilfe

Dateiimport und Datenquellen

Wenn Ihre Kunden bereits in einem anderen System erfasst sind – CRM, Warenwirtschaft, Tabelle –, müssen Sie nicht warten, bis sie auf der Website auftauchen: Laden Sie eine Datei hoch. Einen einmaligen Upload von Profilen aus einer CSV- oder Excel-Datei erledigt der Import, das regelmäßige Nachladen von Profilen und Ereignissen aus einer Datei per URL, aus S3, aus Google Sheets oder aus Ihrem Data Warehouse übernehmen Datenquellen.

Beide Werkzeuge stehen „Inhaber“, „Administrator“ und „Manager“ zur Verfügung.

Profilimport aus CSV und Excel

Öffnen Sie im Menü Daten → Profilimport oder klicken Sie oben auf der Seite Profile auf Profilimport.

Anforderungen an die Datei

  • CSV oder Excel (.xlsx, .xls – erstes Blatt) mit Spaltenüberschriften in der ersten Zeile.
  • Trennzeichen: Komma, Semikolon oder Tabulator – wird automatisch erkannt.
  • Größe: CSV bis 20 MB, Excel bis 10 MB.
  • Mindestens eine Spalte mit einer Kennung: Kunden-ID in Ihrem System, E-Mail-Adresse, Telefonnummer.
  • In Excel werden Zellen mit Datumsformat als 2026-10-28 18:42:00 geladen, Formeln mit ihrem Wert. Dateien aus Excel 95 und passwortgeschützte Dateien sind nicht geeignet: Speichern Sie sie als .xlsx oder CSV.

Beispiel:

email;phone;first_name;city;customer_id;bonus
[email protected];+49 151 2345678;Anna;Berlin;1001;350

Datei hochladen

  1. Klicken Sie auf Datei auswählen und wählen Sie die Datei.
  2. In der Tabelle erscheinen die Spalten der Datei, Beispielwerte und das Feld Ziel. Legen Sie für jede Spalte fest:
    • Kennung: User ID, E-Mail, Telefon oder Anonymous ID – darüber wird das Profil gefunden oder angelegt. Jeden Typ können Sie nur einmal wählen.
    • Merkmal – eine Eigenschaft des Profils; geben Sie daneben den Schlüssel in lateinischen Buchstaben ein, zum Beispiel city oder bonus_balance.
    • Überspringen – die Spalte wird nicht geladen.
  3. Klicken Sie auf Import starten.

OneTrace.pro schlägt das Ziel anhand der Überschriften selbst vor: email – E-Mail, phone – Telefon, customer_id und user_id – User ID. Russische und ukrainische Überschriften für Vorname, Nachname, Stadt und Land werden zu den Merkmalen first_name, last_name, city, country. Alle anderen Überschriften werden in lateinischer Umschrift zu Merkmalsschlüsseln. Prüfen Sie die Vorschläge vor dem Start.

Profilimport: Zuordnung der Dateispalten

Importfortschritt

Der Import läuft im Hintergrund: Auf der Seite sehen Sie einen Fortschrittsbalken, den Status und den Zähler „N von M verarbeitet, Fehler: K“. Sie können die Seite schließen – der Import läuft weiter. Fehlerhafte Zeilen werden mit ihrer Nummer aufgeführt. Nach Abschluss führt die Schaltfläche Profile öffnen zur Profilliste.

Rechts im Block Verlauf stehen die letzten 20 Importe: Datei, wer sie wann hochgeladen hat, Status („Hochgeladen“, „In Warteschlange“, „Wird verarbeitet“, „Abgeschlossen“, „Fehlgeschlagen“) und Ergebnis.

Importseite mit Upload-Verlauf

Wie Zeilen verarbeitet werden

  • Gibt es bereits ein Profil mit dieser Kennung, wird es aktualisiert: Neue Merkmale kommen hinzu, vorhandene werden überschrieben. Enthält eine Zeile Kennungen zweier verschiedener Profile, werden die Profile zusammengeführt – siehe Profile.
  • Leere Zellen werden übersprungen und löschen keine bereits bekannten Werte.
  • Zahlen und true/false werden als Zahlen und Wahrheitswerte gespeichert.
  • E-Mail-Adresse und Telefonnummer aus der Datei werden sowohl zu Kennungen als auch zu Profilmerkmalen.
  • Die Telefonnummer wird von Leerzeichen, Klammern und Bindestrichen bereinigt. Geben Sie sie mit Ländervorwahl an: +7 999 123-45-67. Eine Nummer wie 8 999… wird mit falscher Vorwahl gespeichert.
  • Eine Zeile ohne gültige Kennung wird mit einem Fehler übersprungen.

Der Import erzeugt für jede Zeile ein Ereignis $identify, daher können Merkmalsänderungen Journeys mit einem Trigger auf Merkmalsänderung starten. Ist das nicht gewünscht, pausieren Sie solche Journeys für die Dauer des Imports.

Datenquellen

Eine Quelle ist ein regelmäßiger Import nach Zeitplan. Sie eignet sich, wenn Ihr CRM oder Lager jede Nacht einen frischen Export bereitstellt: OneTrace.pro holt ihn selbst ab und aktualisiert Profile oder fügt Ereignisse hinzu.

Vorbereitung

Legen Sie zuerst eine Verbindung im Bereich Integrationen an (Rolle „Administrator“ oder „Inhaber“ erforderlich):

  • Datei per URL – eine Datei unter einer HTTP(S)-Adresse. Ist die Datei geschützt, geben Sie einen Autorisierungs-Header an, zum Beispiel Bearer und ein Token.
  • Datei aus S3 – Bucket bei AWS, Yandex Object Storage, MinIO und anderen kompatiblen Speichern.
  • Google Sheet – über den Schlüssel eines Google-Dienstkontos. Geben Sie diesem Konto Lesezugriff auf die Tabelle.
  • PostgreSQL, ClickHouse, BigQuery oder Snowflake – eine Tabelle oder Abfrage in Ihrem Data Warehouse, siehe Data Warehouse.

Dateiformate: CSV, JSON (Array von Objekten, bis 50 MB) und JSON Lines.

Quelle anlegen

  1. Öffnen Sie Daten → Datenquellen und klicken Sie auf Neue Quelle.
  2. Geben Sie einen Name ein und wählen Sie die Verbindung.
  3. Füllen Sie die Verbindungseinstellungen aus: Datei-URL und Format, Dateipfad im Bucket oder Tabellen-ID und Bereich (zum Beispiel Tabelle1!A:F).
  4. Klicken Sie auf Spalten laden – OneTrace.pro liest die ersten Zeilen.
  5. Wählen Sie im Feld Importieren als entweder Profile (jede Zeile aktualisiert Merkmale) oder Ereignisse (jede Zeile ist ein Ereignis).
  6. Wählen Sie den Zeitplan: von alle 15 Minuten bis einmal täglich.
  7. Legen Sie in der Tabelle Spalten das Ziel jeder Spalte fest, wie beim CSV-Import.
  8. Klicken Sie auf Speichern.

Einstellungen einer Datenquelle mit Spaltenzuordnung

Für Ereignisse bietet die Spaltentabelle zusätzlich Ereignisname, Ereigniseigenschaft und Ereigniszeit. Eine Spalte mit der Zeit ist Pflicht. Den Ereignisnamen legen Sie entweder einheitlich für alle Zeilen im Feld Ereignisname fest (zum Beispiel order_completed) oder wählen die Spalte, in der er steht.

Für Kassenbons aus Filialen gibt es die Vorlage Offline-Kassenbons mit einer Beispieldatei: Sie füllt das Kaufereignis, die Eigenschaft für Filialkäufe und die Spaltenvorschläge aus – Telefon, Kundenkarte, Filiale, Bonnummer, Betrag und Produkte. Siehe Filialen und Offline-Verkäufe.

Betrieb der Quelle

Die Karte der Quelle zeigt Status („Aktiv“, „Pausiert“, „Fehler“), Zeitplan, Zeitpunkt der letzten Ausführung und das Ergebnis: Zeilen, übernommen, übersprungen, fehlerhaft.

  • Jetzt ausführen – eine außerplanmäßige Ausführung. Damit holen Sie eine Quelle auch aus der Pause oder einem Fehler zurück.
  • Pausieren / Fortsetzen – geplante Ausführungen anhalten und wieder aufnehmen.
  • Verlauf – Liste der Ausführungen: Beginn, Auslöser („Geplant“ oder „Manuell“), Status und die ersten Zeilenfehler mit Zeilennummer.

Datenquellen: Karten mit Status und Ergebnis der Ausführungen

Wichtig zu wissen

  • Hat sich die Datei seit dem letzten Mal nicht geändert, endet die Ausführung mit dem Status „Unverändert“, und die Zeilen werden nicht gelesen.
  • Dieselbe Zeile erzeugt innerhalb eines Tages keine Duplikate.
  • Bei Ereignissen wird der Zeitpunkt des zuletzt geladenen Ereignisses gespeichert: Folgende Ausführungen überspringen Zeilen, die nicht neuer sind. Eine Verlaufsdatei können Sie daher einfach fortschreiben.
  • Eine Quelle mit Fehler wird nach Zeitplan erneut ausgeführt, der Fehlertext steht in der Karte.
  • Geladene Ereignisse zählen zum monatlichen Kontingent des Tarifs.
  • Beim Löschen einer Quelle bleiben die bereits geladenen Daten erhalten.

Data Warehouse

Wenn Profile und Bestellungen bereits in Ihrem Data Warehouse liegen – PostgreSQL, ClickHouse, BigQuery oder Snowflake –, liest die Quelle sie direkt von dort. Jede Ausführung holt nur die Zeilen, die sich seit dem letzten Mal geändert haben. Deshalb müssen Sie auch eine große Tabelle nicht in eine Datei exportieren. Die Änderungen landen in Profilen und Ereignissen, lösen Journeys aus und aktualisieren Segmente. Die umgekehrte Richtung ist der Export in Data Warehouses.

Das Lesen aus Data Warehouses ist im Tarif „Enterprise“ verfügbar, siehe Tarife.

Verbindung

Legen Sie die Verbindung auf der Seite Integrationen in der Gruppe Datenquellen an. Die Felder sind dieselben wie beim Export in dieses Data Warehouse. Legen Sie dafür aber besser einen eigenen Benutzer nur mit Leserechten an:

  • PostgreSQL – Host, Port, Datenbank und ein Benutzer mit dem Recht SELECT auf die benötigten Tabellen.
  • ClickHouse – Adresse der HTTP-Schnittstelle und ein Benutzer mit Leserechten.
  • BigQuery – Schlüssel eines Dienstkontos mit den Rollen BigQuery Data Viewer und BigQuery Job User, Projekt und Datenstandort.
  • Snowflake – Konto, Benutzer mit Schlüsselpaar, eine Rolle mit dem Recht SELECT und ein Warehouse für die Berechnungen. Einen S3-Bucket brauchen Sie zum Lesen nicht.

Das Data Warehouse muss aus dem Internet erreichbar sein: Adressen interner Netze ruft OneTrace.pro nicht auf.

Einstellungen der Quelle

Legen Sie eine Quelle wie oben beschrieben an und wählen Sie die Verbindung zum Data Warehouse. Ihre Einstellungen:

  • Was gelesen wird – Tabelle (zum Beispiel public.customers oder shop_dwh.customers) oder Eigene Abfrage – SELECT oder WITH als einzelner Befehl ohne ;. OneTrace.pro ergänzt die Abfrage um eine Bedingung, eine Sortierung und ein Zeilenlimit, deshalb kann die Abfrage keine Daten ändern.
  • Cursor-Spalte – der Änderungszeitpunkt der Zeile, zum Beispiel updated_at. Jede Ausführung liest die Zeilen, bei denen dieser Zeitpunkt später ist als beim letzten Mal. Zeilen ohne diesen Zeitpunkt werden nicht gelesen.
  • Zeilenschlüssel – eine eindeutige Spalte, zum Beispiel id oder customer_id. Damit werden Zeilen mit demselben Änderungszeitpunkt unterschieden.
  • Spalte für Löschkennzeichen – optional, zum Beispiel is_deleted. Siehe Löschen.

Quelle aus dem Data Warehouse BigQuery: Tabelle, Cursor, Zeilenschlüssel und Spalten

Alles Weitere wie bei einer Datei: Spalten laden, Spaltenzuordnung, Profile oder Ereignisse, Zeitplan.

Wie Änderungen gelesen werden

  • Die erste Ausführung liest die ganze Tabelle, die folgenden nur Zeilen, die nach der zuletzt gelesenen geändert wurden.
  • Eine Ausführung liest höchstens 1 Mio. Zeilen. Gibt es mehr, startet die nächste Ausführung sofort, ohne auf den Zeitplan zu warten. So läuft das erste Laden einer großen Tabelle in mehreren Ausführungen direkt nacheinander.
  • Bricht eine Ausführung ab, werden dieselben Zeilen erneut gelesen: Profile werden einfach noch einmal aktualisiert, und wiederholte Ereignisse werden nicht doppelt gespeichert.
  • Wenn Sie Tabelle, Abfrage, Cursor-Spalte oder Schlüssel ändern, beginnt das Lesen von vorn.
  • Die Spalte mit dem Änderungszeitpunkt muss Ihr Data Warehouse aktualisieren: Eine Zeile, deren Zeitpunkt sich nicht geändert hat, liest OneTrace.pro nicht erneut.
  • Die Abfrage läuft nur lesend und mit Zeitlimit: 10 Minuten in PostgreSQL, ClickHouse und Snowflake, 15 Minuten in BigQuery.

Löschen

Steht in einer Zeile einer Profilquelle in der Spalte für Löschkennzeichen true oder 1, löscht OneTrace.pro das Profil mit den Kennungen dieser Zeile wie bei einer Anfrage nach DSGVO: samt Verlauf, zusammengeführten Profilen und Daten in Exporten. Die Löschung wird im Audit-Log festgehalten, und im Ergebnis der Ausführung sehen Sie, wie viele Profile gelöscht wurden. In einer Ereignisquelle werden Zeilen mit Kennzeichen einfach übersprungen.

Für einen einmaligen Umzug von Mindbox und anderen Plattformen samt Verlauf gibt es ein eigenes Werkzeug – siehe Umzug von anderen Plattformen.