Wo du den Status siehst
Den aktuellen Status deiner Datenverbindungen findest du unter Datenquellen in der Navigationsleiste. Jede Datenquelle zeigt dort ihren Status, so erkennst du auf einen Blick, welche Verbindungen aktiv sind und welche deine Aufmerksamkeit brauchen.
Status bei Integrationen
Integrationen wie Google Analytics oder Google Ads verbinden sich über OAuth. Der Status zeigt, ob die Autorisierung gültig ist und Zweigen Daten abrufen kann.
| Status | Was es bedeutet | Was du tun kannst |
|---|---|---|
| Verbunden | Alles in Ordnung, Zweigen kann Daten abrufen | Nichts, weiter mit der Ressourcenauswahl oder dem Dashboard |
| Getrennt | Keine aktive Verbindung vorhanden | Integration erneut verbinden |
| Erneute Anmeldung nötig | Die Berechtigung ist abgelaufen oder wurde widerrufen | Verbindung erneut autorisieren; eventuell hat sich das Google-Passwort geändert oder der Zugriff wurde in Google entzogen |
| Wird eingerichtet | Autorisierung war erfolgreich, Zweigen konvergiert im Hintergrund | Kurz warten und die Ansicht aktualisieren, dauert in der Regel nur Sekunden |
| Verbindungsauswahl nötig | Mehrere aktive Verbindungen zum selben Dienst vorhanden | Unter den aktiven Verbindungen die gewünschte explizit auswählen |
Status bei eigenen Datenquellen und Uploads
Für Datei-Uploads und eigene API-Verbindungen zeigt Zweigen den Stand des letzten Imports:
| Status | Was es bedeutet |
|---|---|
| Aktuell | Letzter Import war erfolgreich |
| Import läuft | Daten werden gerade verarbeitet, kurz warten |
| Fehler | Letzter Import ist fehlgeschlagen, Details im Import-Log prüfen |
Bei einem Importfehler prüfe zuerst das Format der hochgeladenen Datei oder die Struktur des API-Requests. Die häufigste Ursache sind geänderte Spaltennamen oder ein abgelaufener API-Key.
Was den Aktualitätsstatus im Dashboard beeinflusst
Der Aktualitätsstatus im Dashboard zeigt, wie aktuell die angezeigten Daten sind. Ein veralteter Status im Dashboard bedeutet häufig, dass die zugrundeliegende Datenquelle noch keinen neuen Import abgeschlossen hat oder die Verbindung unterbrochen war.
Entwickler: Importstatus per API abrufen
Wenn du Daten über die individuelle API-Verbindung sendest, kannst du den Importstatus programmatisch abfragen:
Endpoint: GET /api/integrations/v1/custom-data/imports/status
Parameter: dataSourceId und importRequestId
| Status | Bedeutung |
|---|---|
PENDING | Request angenommen, wartet auf Verarbeitung |
RUNNING | Import wird aktuell verarbeitet |
COMPLETED | Import erfolgreich abgeschlossen |
FAILED | Import beendet, aber mit Fehler |
Empfehlung: alle 2–5 Sekunden pollen, bei FAILED den Fehlercode im Response prüfen und erst nach Beheben des Problems neu senden.
Alle Daten. Ein System.
Kontakt
Wir beraten und helfen gerne weiter. Schreib uns eine Mail an hi@zweigen.cloud oder besuche unsere Socials.