Wie der Datenimport funktioniert
Überblick
Sobald Sie Ihren TikTok Shop verbinden, beginnt Dashboardly automatisch mit dem Import Ihrer Daten. Dieser Vorgang ruft Ihre Produkte, Bestellungen, Finanzauszüge, Erstattungen und mehr ab, damit Ihre Dashboards, Profit-and-Loss-Berichte und alle anderen Analyseseiten mit korrekten Zahlen befüllt werden.
Sie müssen nichts manuell tun -- die Importe laufen im Hintergrund. Sie können Dashboardly weiter nutzen, während der Import läuft; die Seiten werden nach und nach befüllt, sobald jeder Datentyp verfügbar wird.
Was importiert wird
Dashboardly importiert die folgenden Datentypen aus TikTok Shop:
| Datentyp | Beschreibung |
|---|---|
| Produkte | Ihr vollständiger Produktkatalog einschließlich SKUs, Preisen und Bildern |
| Produktbestand | Lagerbestände über alle Lager hinweg (FBS und FBT) |
| Bestellungen | Vollständige Bestellhistorie mit Kundendaten und Bestellstatus |
| Bestellpositionen | Einzelne Artikel innerhalb jeder Bestellung |
| Finanzauszüge | Zahlungsauszüge mit Umsatzaufschlüsselungen |
| Auszugstransaktionen | Finanzdetails auf Bestellebene (Gebühren, Steuern, Rabatte) |
| Erstattungen & Rücksendungen | Alle erstatteten und zurückgesendeten Bestellungen mit Beträgen und Gründen |
| Lagerdaten | FBT-Lagerinformationen und eingehende Lieferungen |
Importphasen
Der Import durchläuft eine mehrstufige Pipeline. Sie sehen den Fortschritt jeder Phase in Echtzeit:
- Produktkatalog -- ruft all Ihre Produkte und SKUs ab
- Produktdetails & Bilder -- lädt erweiterte Produktinformationen herunter
- Produktbestand -- synchronisiert aktuelle Lagerbestände pro Lager
- Bestellungen -- lädt Ihre vollständige Bestellhistorie herunter
- Finanzauszüge -- ruft Zahlungsabrechnungsdaten ab
- Auszugstransaktionen -- importiert Finanzaufschlüsselungen auf Bestellebene
- Erstattungen & Rücksendungen -- importiert alle Rücksende- und Erstattungsaufzeichnungen
- Lager & FBT -- synchronisiert Lager- und Fulfillment-Daten (falls zutreffend)
- Analysen & Kennzahlen -- berechnet Geschäftskennzahlen aus allen importierten Daten
Synthetische Produkte für Auktionsbestellungen
Wenn Sie über TikToks Countdown Bidding (Auktionen) verkaufen, erstellt Dashboardly automatisch Produktdatensätze für diese temporären Angebote. Produkte werden nach Namen gruppiert -- wenn Sie denselben Artikel über mehrere Countdown-Bidding-Sitzungen verkaufen, erscheint er in Ihren Analysen als ein Produkt. Sie müssen nichts unternehmen.
Wie lange dauert der erste Import?
Die Importzeit hängt von Ihrer Shop-Größe ab:
| Shop-Größe | Geschätzte Zeit |
|---|---|
| Klein (unter 100 Bestellungen) | 5 -- 15 Minuten |
| Mittel (100 -- 10K Bestellungen) | 30 Minuten -- 2 Stunden |
| Groß (10K -- 250K Bestellungen) | 2 -- 8 Stunden |
| Sehr groß (250K+ Bestellungen) | 8+ Stunden |
Während des Imports sehen Sie ein Fortschritts-Dialogfeld mit:
- Einem Gesamtfortschrittsbalken
- Status für jede Importphase (ausstehend, in Bearbeitung, abgeschlossen)
- Geschätzter verbleibender Zeit
- Verarbeiteten vs. gesamten Elementen
Sie können das Dialogfeld schließen und Dashboardly weiter nutzen -- der Import läuft im Hintergrund.
Importzuverlässigkeit
Dashboardly ist darauf ausgelegt, Importe jeder Größe zuverlässig zu bewältigen:
- Langlaufende Importe. Bei großen Shops können Importe mehrere Stunden dauern. Dashboardly hält Ihre API-Sitzung für die gesamte Dauer aktiv, sodass Importe ohne Autorisierungsfehler abgeschlossen werden. Falls ein Token tatsächlich abläuft, verbinden Sie den Shop unter Einstellungen → Shops erneut, und der Import wird fortgesetzt.
- Automatische Wiederholungen für Marketingdaten. Falls beim Import Ihrer TikTok-Ads-Daten ein vorübergehender Netzwerkfehler auftritt, wird der Import automatisch wiederholt. Sie müssen nichts unternehmen.
Automatische Datensynchronisierung (nach dem ersten Import)
Nach dem ersten Import hält Dashboardly Ihre Daten automatisch aktuell:
- Geplante Synchronisierung läuft zweimal täglich, um 02:00 und 14:00 UTC
- Jede geplante Synchronisierung blickt auf die letzten 3 Tage an Daten zurück, um alle Aktualisierungen zu erfassen, die TikTok seit dem vorherigen Lauf ausgegeben hat
- Webhooks von TikTok liefern Echtzeit-Aktualisierungen für neue Bestellungen, Produktänderungen und Rücksendungen
Sie müssen nichts unternehmen -- Ihre Daten bleiben automatisch aktuell.
Wichtige Hinweise
Verzögerung bei Finanzauszügen
TikTok-Finanzauszüge benötigen mindestens 48 Stunden, um nach der Aufgabe einer Bestellung verfügbar zu werden. Wenn Sie Bestellungen ohne Finanzdaten sehen, ist das normal -- Auszüge erscheinen bei der nächsten Synchronisierung, nachdem TikTok sie erstellt hat.
Datenvollständigkeit
Gebühren- und Steueraufschlüsselungen für Ihre Bestellungen werden automatisch wiederhergestellt, wenn TikTok-Daten verspätet eintreffen oder anfangs unvollständig waren. Das bedeutet, dass Ihre Profit-&-Loss-Berechnungen früher vollständig werden, ohne dass Sie eine manuelle Synchronisierung auslösen müssen.
Datengenauigkeit
Dashboardly importiert Daten genau so, wie sie von TikToks API bereitgestellt werden. Falls Ihnen Abweichungen auffallen, lesen Sie Meine Zahlen stimmen nicht mit TikTok überein und Ihre Datenqualität verstehen.
Einen manuellen Import auslösen
Wenn Sie Ihre Daten sofort aktualisieren müssen:
- Gehen Sie zu Einstellungen → Importverlauf
- Klicken Sie auf Import ausführen
- Der Import verarbeitet alle Datentypen und zeigt den Fortschritt an
Dies nutzt dieselbe Pipeline wie die automatische Synchronisierung. Es löscht keine vorhandenen Daten -- es aktualisiert und ergänzt sie.
Tipps
- Trennen Sie Ihren Shop nicht und verbinden Sie ihn nicht erneut, um Datenprobleme zu „beheben". Eine manuelle Synchronisierung ist der richtige Ansatz.
- Prüfen Sie Einstellungen → Importverlauf, falls Ihre Zahlen veraltet erscheinen. Sie können den Status der letzten Synchronisierung sehen und bei Bedarf eine manuelle Synchronisierung auslösen.
- Große Shops zeigen möglicherweise Teildaten im Dashboard an, während der Import noch läuft. Warten Sie, bis der Import abgeschlossen ist, bevor Sie Ihre Zahlen bewerten.
Häufige Probleme
Import bleibt bei einer Phase hängen
Gelegentlich kann ein Import aufgrund vorübergehender TikTok-API-Ratenbegrenzungen ins Stocken geraten. Dashboardly wiederholt automatisch mit zunehmenden Verzögerungen. Falls ein Import über ~2 Stunden lang keinen Fortschritt zeigt, kontaktieren Sie den Support.
Import abgeschlossen, aber Daten sehen unvollständig aus
Prüfen Sie, ob das TikTok Seller Center Daten für denselben Datumsbereich anzeigt. Einige Kennzahlen (wie Finanzauszüge) sind erst verfügbar, nachdem TikTok sie finalisiert hat, was mindestens 48 Stunden, bei manchen Bestellungen aber länger dauern kann.
Fehler „Import fehlgeschlagen"
Das bedeutet meist, dass TikToks API einen Fehler zurückgegeben hat. Häufige Ursachen:
- Ihr Autorisierungstoken ist abgelaufen (verbinden Sie den Shop unter Einstellungen → Shops erneut)
- TikToks Server waren vorübergehend nicht verfügbar (der Import wird automatisch wiederholt)
- Ihr Shop wurde auf TikToks Seite gesperrt oder eingeschränkt
Falls das Problem nach dem erneuten Verbinden weiterhin besteht, kontaktieren Sie den Support.