Daten-Aktualität — wann läuft der Worker?

Eine Frage die regelmäßig kommt: "Läuft der Worker eigentlich dauerhaft? Wie aktuell sind meine Daten?" Hier die Antwort, was im Hintergrund läuft, wie oft, und wie du den Sync-Stand selbst überprüfst.

Was Sellerwerk im Hintergrund macht

Sellerwerk hat keinen einzigen Worker, sondern mehrere Jobs die unterschiedlich oft laufen. Hier die wichtigsten:

• Kampagnen-Sync — alle 15 Minuten. Holt aktuelle Spend, Sales, Klicks, Impressionen pro Kampagne aus Amazon. Das ist die Zahl, die du im Dashboard oben siehst.
• Search-Term-Reports — einmal täglich (nachts ~02:00 UTC). Amazon liefert Search-Term-Daten nicht live, sondern als Tagesreport. Daher kannst du den gestrigen Search Term Report frühestens am Folgetag morgens sehen.
• Profitability-Aggregation — alle 4 Stunden. Verbindet Spend mit Sales-Daten und berechnet Margen. Etwas teurer in der Berechnung, deshalb seltener.
• Strategy-Buckets-Klassifikation — einmal täglich. Nimmt 14-Tage-Daten und sortiert Keywords in Defend / Attack / Cannibalize / Discover / Optimize.
• Empfehlungs-Engine — einmal täglich. Generiert die Bid-Vorschläge und Bleeding-Spend-Warnungen die im Dashboard auftauchen.

Was passiert bei Worker-Restart

Wenn ein Worker-Server neugestartet wird (z.B. bei Deployment oder Hardware-Wartung), greifen drei Sicherheitsmechanismen:

1. Aktuell laufende Jobs werden weitergeführt. Wir nutzen BullMQ mit Redis-Persistenz — ein Job der gerade startet bleibt in der Queue und wird nach dem Restart fertiggestellt.
2. Verpasste Cron-Slots werden nachgeholt. Wenn der Restart 20 Minuten dauert und in der Zwischenzeit ein 15-min-Sync-Slot ausfällt, holt der nächste Slot die fehlende Periode mit auf. Du verlierst keine Daten.
3. Bei längerem Ausfall: explizite User-Warnung. Wenn der Worker länger als 60 Minuten down ist, taucht ein Banner im Dashboard auf: "Daten-Sync verzögert seit HH:MM". Du weißt also, ob Zahlen aktuell sind oder nicht.

Wie du den Sync-Stand verifizierst

Drei schnelle Checks:

1. Sync-Timestamp im Dashboard

Im Dashboard ganz oben steht der Stand der letzten Daten-Aktualisierung — z.B. "Daten aktuell von 14:30 UTC". Wenn das Datum nicht von heute ist, gibt es ein Sync-Problem.

2. Detail-View einer Kampagne

Klick eine Kampagne an. Unten siehst du "Letzter Sync: vor 12 Min". Bei 15-min-Cron sollte das nie über 30 Minuten alt sein. Wenn doch: Sync läuft nicht.

3. Force-Resync (Notfall)

In Einstellungen → Amazon-Konten gibt es einen Button "Sofort synchronisieren". Damit triggerst du einen manuellen Sync-Job — sinnvoll wenn du gerade in Amazon Seller Central etwas geändert hast und die Änderung sofort in Sellerwerk sehen willst, ohne 15 Minuten zu warten.

Force-Resync ist auf 1× pro 5 Minuten rate-limited, damit nicht alle 30 Sekunden ein neuer Sync ausgelöst wird. Wenn der Button ausgegraut ist: warte ein paar Minuten.

Wenn Daten alt aussehen

Wenn du im Dashboard merkst dass Zahlen 1+ Tage alt sind:

• Banner gelesen? Wir zeigen aktive Sync-Probleme oben an. Wenn der Banner sagt "Sync verzögert seit gestern", ist es ein bekanntes Problem und wir arbeiten dran.
• Force-Resync probiert? Manchmal ist nur dein Konto in einem stuck-state, der durch Manual-Trigger gelöst wird.
• Token-Status geprüft? In Einstellungen → Amazon- Kontensollte der Status grün sein. Bei "Token revoked" oder "OAuth expired": neu autorisieren.
• Wenn nichts hilft: Mail an support@sellerwerk.de mit deiner Org-ID (oben rechts im User-Menü) und dem Sync-Timestamp den du siehst.

Hosting + Verfügbarkeit

Sellerwerk läuft auf zwei Worker-Servern bei netcup (Nürnberg). Die Cron-Jobs sind redundant: wenn ein Server ausfällt, übernimmt der zweite. Geplante Wartungs-Restarts machen wir nachts zwischen 02:00 und 04:00 UTC und sind in der Regel unter 5 Minuten.

Bei einem User-meldungs-Beispiel vom 27.04 ("Daten 3 Tage alt") ist genau dieser Worker-Outage-Fall eingetreten — beide Worker hatten gleichzeitig ein Problem. Solche Fälle sind selten und wir benachrichtigen via Banner sobald wir es merken.

Verwandt: Sync hängt — Recovery-Schritte, Automatisierung verstehen (Regeln warten ebenfalls auf valide Daten), Datenschutz & Sicherheit (Hosting in Deutschland). Bei Fragen: support@sellerwerk.de.