Was nach der Verbindung passiert#
Sobald Sie einen E-Shop verbinden (Shoptet, Upgates, Shopify — Add-ons für Shopify und Shoptet bereiten wir vor) oder ein Werbesystem oder einen externen Dienst (Google Ads, Meta, Sklik, Heureka, Google Analytics 4, Search Console), beginnt Margly mit dem Herunterladen historischer Daten. Es geht nicht sofort — es hängt von der Größe Ihres E-Shops ab.
Was und in welcher Reihenfolge geladen wird#
Produkte (1–3 Minuten)
Margly lädt zuerst den Produktkatalog herunter — Namen, SKU, Preise, Einkaufspreise (sofern der E-Shop sie liefert), Kategorien, Bestände. Ohne Produkte können keine Margen berechnet werden.
Kunden (1–5 Minuten)
Kundendatenbank mit E-Mails, Namen, Stadt, Registrierungsdatum. Dient zur Berechnung von LTV und Wiederholungsbestellungen.
Bestellungen (5–30 Minuten)
Die meisten Daten. Margly lädt die gesamte Historie herunter, die der E-Shop über API/Feed bereitstellt. Nimmt Bestellungen, Positionen, Versand, Rabatte, Storno-Stati. Für laufende Aktualisierungen prüft Margly bei jedem Abruf Änderungen der letzten 60 Tage (typischerweise erfasst Storno, Refund, Statusänderungen).
Berechnung der Margen
Nach dem Herunterladen berechnet Margly Margen, ABC-Analyse der Produkte, Kunden-Kohorten neu. Das dauert weitere 1–2 Minuten.
Werbesysteme und externe Dienste laufen parallel#
Sobald Sie Werbesysteme oder in der Anwendung verfügbare externe Dienste verbinden, lädt Margly die Daten dieser Plattformen parallel zum E-Shop. Meist innerhalb von 5 Minuten erledigt, weil es deutlich weniger Werbedaten gibt.
Wie erkenne ich, dass der Abruf abgeschlossen ist#
- Im Bereich Verbindungen im Block Datenaktualisierung sehen Sie den Status jeder Plattform. Grüner Punkt = fertig, gelber = läuft, roter = Fehler.
- Nach Abschluss erhalten Sie eine E-Mail „Die erste Übersicht ist bereit" mit Link zum Dashboard.
- Im Dashboard erscheinen reale Zahlen (bis dahin sehen Sie Platzhalter).
Was tun, wenn der Abruf fehlschlägt#
Häufigste Ursachen und was dagegen zu tun ist:
- Ungültiger API-Schlüssel / Token — gehen Sie zurück in den Bereich Verbindungen und erneuern Sie den Schlüssel. Das Vorgehen unterscheidet sich je nach Plattform:
- Shoptet (API-Schlüssel) — generieren Sie in der Shoptet-Administration einen neuen API-Schlüssel und fügen Sie ihn in Margly ein
- Shoptet (CSV-Feeds) — erneuern Sie in der Shoptet-Administration die privaten URLs der Feeds (Bestellungen, Produkte, Kunden) und fügen Sie die neuen URLs in Margly ein
- Shoptet (autorisiertes Add-on — in Vorbereitung) / Upgates (Add-on) / Shopify (Add-on — in Vorbereitung) — das Token übergibt Ihnen das Add-on automatisch, sodass bei Fehlschlag das Add-on im Marketplace der jeweiligen Plattform neu installiert werden muss
- Werbesysteme und externe Dienste über OAuth (Google Ads / Meta / GA4 / Search Console) — klicken Sie auf Neu verbinden und durchlaufen Sie OAuth erneut mit dem richtigen Konto
- Sklik / Heureka (API-Schlüssel) — generieren Sie in der jeweiligen Plattform ein neues API-Token und fügen Sie es in Margly ein
- Timeout / Fehler auf der Plattformseite — großer E-Shop oder schwächere API. Margly versucht es beim nächsten geplanten Abruf erneut. Die Frequenz unterscheidet sich nach Tarif — Starter 1×/Tag (morgens), Professional 2×/Tag (morgens + abends), Business / Enterprise / Testphase 4×/Tag (morgens, mittags, abends, nachts). Details in Datenaktualisierung. Über den Fehlschlag erfahren Sie über eine In-App-Benachrichtigung (max. 1× pro Tag je E-Shop, aggregiert alle Slots und Datentypen — E-Mail senden wir in diesem Fall nicht).
- Überschrittenes Limit (429) — die Plattform hat Sie vorübergehend blockiert (Google Ads hat tägliche Limits). Margly wartet auf den nächsten geplanten Abruf.
- Permissions-Fehler — in Google Ads / Meta haben Sie keinen Zugriff auf ein Konto, an das Margly OAuth gesendet hat. Ziehen Sie OAuth erneut mit dem richtigen Konto ein.
Was nach der ersten Übersicht zu tun ist#
- Gehen Sie die Dashboard-Übersicht durch — was jede Karte bedeutet.
- Wenn Einkaufspreise bei Produkten fehlen (Margly liest sie ausschließlich aus der verbundenen Plattform — Shoptet, Upgates, Shopify), ergänzen Sie sie in der Administration Ihres E-Shops. Margly aktualisiert sie beim nächsten Datenabruf.
- Nach 7 Tagen probieren Sie den KI-Berater — er braucht mindestens eine Woche Daten, um Sie kennenzulernen.