Wo Sie den Verbindungsstatus sehen#
Den Status jeder Verbindung und der letzten Aktualisierung finden Sie im Bereich Verbindungen (linkes Menü, Stecker-Symbol) — im Block Datenaktualisierung ist eine Tabelle mit der Historie der letzten Ausführungen und ihrem Status:
- Erfolgreich — Datenabruf erfolgte ohne Fehler
- Läuft — Margly lädt gerade
- Synchronisationsfehler — Abruf fehlgeschlagen
- Teilweise — einige Daten konnten geladen werden, etwas ist fehlgeschlagen
Darunter ist ein Log der letzten Synchronisationen mit Zeiten und Details.
Häufigste Fehlerursachen#
Ungültiger API-Schlüssel oder OAuth-Token#
Das Token wurde deaktiviert, gelöscht oder ist abgelaufen. Margly kann sich nicht bei der Plattform anmelden.
Was tun:
- Öffnen Sie die Administration der Plattform (Shoptet, Google Ads, Meta, Sklik, Heureka).
- Bei Plattformen mit API-Schlüssel (Shoptet, Sklik, Heureka) generieren Sie einen neuen Schlüssel und fügen ihn in Margly in Verbindungen → [Plattform] ein.
- Bei OAuth-Plattformen (Google, Meta, Upgates / Shopify Add-on) klicken Sie auf Neu verbinden (oder installieren Sie das Add-on bei Upgates / Shopify neu) und durchlaufen Sie OAuth erneut.
Unzureichende Berechtigungen#
Das Token ist gültig, aber Margly hat keine Berechtigung zur konkreten Quelle. Typisch bei Google Ads Manager (MCC) oder Meta Business Manager, wo der Benutzer nicht als berechtigter Verwalter des Werbekontos hinzugefügt ist.
Was tun:
- Prüfen Sie in der Plattform, dass Ihr Konto mindestens Leseberechtigung für das jeweilige Werbekonto / die Property / die Eigenschaft hat.
- Wenn eine Agentur es verwaltet, bitten Sie sie, die Berechtigung hinzuzufügen.
- Trennen Sie in Margly und verbinden Sie neu. Google OAuth ruft bei einer neuen Anmeldung erneut den Zustimmungsbildschirm auf; wenn Sie im Browser mehrere Google-Konten angemeldet haben, erscheint auch die Kontoauswahl.
Falsche CSV-Feed-URL#
Die URL des Shoptet CSV-Feeds (Bestellungen / Produkte / Kunden), die Sie in Margly eingefügt haben, ist nicht verfügbar. Betrifft ausschließlich die Shoptet-Verbindung über CSV-Feeds — bei der Verbindung über API-Schlüssel noch bei Upgates / Shopify (über Add-on) geben Sie keine URL in Margly ein.
Was tun:
- Die private Shoptet-Feed-URL muss ein geheimes Token enthalten, das Shoptet beim Generieren des Feeds erstellt — ohne es lehnt Shoptet das Herunterladen des Feeds ab.
- In der Shoptet-Administration darf im jeweiligen Exportbereich die Einschränkung „Povolit pouze z konkrétní IP adresy" (bei Produkten) noch „Permanentní odkaz" (bei Bestellungen und Kunden) nicht aktiviert sein.
Überschrittenes Anfragelimit (Rate Limit)#
Die externe Plattform blockiert Sie vorübergehend wegen zu vieler Anfragen. Margly versucht es im Rahmen des laufenden Aufrufs erneut mit Verzögerungen in Sekunden — konkret:
- Sklik und Heureka: Verzögerungen 1, 3, 10 Sekunden (bis zu 3 Versuche)
- Meta: Verzögerungen 5, 15, 60 Sekunden (bis zu 3 Versuche)
- Shoptet: exponentielle Verzögerungen mit Obergrenze 60 Sekunden (bis zu 3 Versuche)
Was tun:
- Meist nichts — Margly löst es im Rahmen des aktuellen Laufs selbst. Wenn das Limit bestehen bleibt, wird der Rest beim nächsten geplanten Abruf nach Tarif heruntergeladen.
- Wenn sich der Fehler täglich wiederholt, schreiben Sie an support@margly.io.
Plattformausfall (Fehler auf der Anbieterseite)#
Die externe Plattform (Shoptet, Google, Meta, …) hat einen Ausfall oder einen vorübergehenden Fehler. Das ist kein Margly-Fehler.
Was tun:
- Warten Sie. Margly versucht es automatisch beim nächsten geplanten Abruf nach Ihrem Tarif erneut (Starter 1×/Tag, Professional 2×/Tag, Business / Enterprise / Testphase 4×/Tag).
- Zur Sicherheit prüfen Sie die Status-Seite der jeweiligen Plattform (z. B. status.cloud.google.com für Google-Dienste).
Timeout / langanhaltende Anfrage#
Ein großer E-Shop oder schwächere APIs der Plattformen führen dazu, dass der Abruf im Zeitfenster nicht abgeschlossen werden kann. Margly erstellt zu dem Fehler eine In-App-Benachrichtigung — max. 1× pro Tag je E-Shop, unabhängig davon, wie viele Slots und wie viele Datentypen (Bestellungen / Produkte / Kunden) an dem Tag fehlgeschlagen sind. E-Mail senden wir in diesem Fall nicht.
Was tun:
- Wenn einmalig, ignorieren — Margly fängt es beim nächsten geplanten Abruf.
- Wenn wiederholt, schreiben Sie an support@margly.io — wir können für Ihren E-Shop kleinere Download-Batches einrichten.
Was tun, wenn Margly nicht alle Daten sieht#
Ältere Bestellungen fehlen#
Margly lädt bei der ersten Verbindung eine unterschiedlich lange Historie je nach Plattform herunter:
| Plattform | Historie, die Margly herunterlädt |
|---|---|
| Shoptet | So viel, wie die Plattform über die API liefert (Margly begrenzt nicht) |
| Upgates | So viel, wie die Plattform über die API liefert |
| Shopify | So viel, wie die Plattform über die Admin API liefert |
| Google Ads | 365 Tage (1 Jahr) |
| Google Analytics 4 | 365 Tage |
| Search Console | 480 Tage (ca. 16 Monate) |
| Meta Ads | 730 Tage (2 Jahre) |
| Sklik | 365 Tage |
| Heureka | bis zu 730 Tage (das reale Fenster begrenzt die Heureka-API) |
Was tun:
- Wenn Sie eine längere Historie benötigen, melden Sie sich bei support@margly.io — wir gehen die Möglichkeiten individuell durch.
Einkaufspreise der Produkte fehlen#
Margly liest Einkaufspreise ausschließlich aus dem verbundenen E-Shop (Shoptet, Upgates, Shopify). Wenn Sie sie dort nicht ausgefüllt haben, fällt die Bruttomarge künstlich hoch aus — typischerweise 100 % (revenue minus null), oder im Dashboard wird statt eines Prozentwerts ein Bindestrich „—" angezeigt.
Was tun:
- Ergänzen Sie Einkaufspreise in der Administration Ihres E-Shops. Margly lädt sie beim nächsten Datenabruf herunter. Manuelle Eingabe von Einkaufspreisen in Margly ist nicht verfügbar.
Konversionen bei Werbekampagnen fehlen#
Für Per-Kampagne-Ergebnisse (Umsatz aus der Kampagne, ROAS, POAS, PNO) muss Konversions-Tracking direkt in der Werbeplattform implementiert sein:
- Google Ads — Konversionspixel oder Google Tag Manager mit Konversionsaktion „Purchase".
- Meta Ads — Meta Pixel mit Ereignis Purchase auf dem E-Shop (ggf. Conversions API).
- Sklik — Sklik-Konversionscode mit Übergabe des Bestellwerts (ohne ihn werden Konversionen zwar gezählt, aber Sklik weist den Umsatz nicht aus).
- Heureka — Konversionsmessung in der Heureka-Administration (die Heureka-API gibt ohne sie null Bestellungen und Umsätze zurück, auch wenn Margly korrekt verbunden ist).
Google Analytics 4 fügt im Dashboard eine Sicht auf aggregierte Trafficquellen hinzu (wie viele Bestellungen aus google / cpc, organic, direct usw. kamen). Für die Per-Kampagne-Attribution dient aber das Konversions-Tracking der jeweiligen Werbeplattform, nicht GA4.
Wie man den Datenabruf manuell startet#
Der manuelle Abruf wird direkt aus der Karte der konkreten Verbindung im Bereich Verbindungen gestartet (nicht aus dem Block „Datenaktualisierung", der nur die Historie anzeigt):
- Shoptet, Upgates, Shopify — im Bereich der E-Shop-Verbindung hat jeder Datentyp (Bestellungen / Produkte / Kunden) eine eigene Schaltfläche. Das Label ändert sich je nach Status („Starten" / „Synchronisation läuft" / „Erneut versuchen" / „Fertig").
- Sklik — in der Sklik-Karte die Schaltfläche Daten aktualisieren.
- Heureka — in der Heureka-Karte die Schaltfläche Synchronisieren.
- Google und Meta — Margly aktualisiert nur automatisch, eine separate Schaltfläche in der UI gibt es nicht.
Wann den Support kontaktieren#
Schreiben Sie an support@margly.io, wenn:
- Sich der Fehler 3+ Tage in Folge wiederholt.
- Der Datenabruf länger als 30 Minuten ohne Ergebnis läuft.
- Sie Daten sehen, die offensichtlich nicht stimmen (z. B. Umsätze auf null, obwohl Sie Bestellungen im E-Shop haben).
- In Margly eine vollständige Plattform fehlt, die Sie verbinden müssen.
Geben Sie in der E-Mail an: E-Shop-Name, Plattform, Zeitbereich des Problems, Screenshot des Fehlers.
Wie geht's weiter#
- Datenaktualisierung — wann Daten automatisch geladen werden
- Erster Datenabruf — was gleich nach der Verbindung passiert