Mit Zenovay können Sie Ihre Daten für externe Analysen, Berichte oder die Integration mit anderen Business-Tools exportieren. Es gibt zwei Möglichkeiten: das Datenexport-Tool (zum Herunterladen oder Planen von CSV/JSON-Dateien) und die REST-API (zum programmgesteuerten Abfragen von Zahlen). Dieser Artikel behandelt beide Methoden und wie Sie Ihre Umsatzzahlen aus jedem Format auslesen.
Information
Der Zenovay-Export liefert Analysedaten – tägliche Aggregate oder rohe Besucherdatensätze auf Reihenebene. Es handelt sich nicht um eine Zeile-für-Zeile-Buchhaltung jeder Bestellung. Für Umsätze gibt die API Transaktionssummen und Attribution zurück; für ein vollständiges Transaktionsprotokoll exportieren Sie von Ihrem Zahlungsanbieter (Stripe, Paddle, etc.).
Datenexport herunterladen
Scale PlanDas Datenexport-Tool befindet sich auf der Seite Agentur (Besitzer und Administratoren im Plan Scale oder höher).
Export-Tool öffnen
Gehen Sie zu Agentur → Export.
Websites und Zeitraum auswählen
Wählen Sie eine oder mehrere Ihrer Websites und den Zeitraum aus, den Sie exportieren möchten.
Format auswählen
Exportieren Sie als CSV oder JSON.
Export ausführen
Zenovay erstellt die Datei und sendet Ihnen einen sicheren Download-Link, wenn die Datei bereit ist. Größere Bereiche werden im Hintergrund verarbeitet.
Export-Formate
| Format | Geeignet für |
|---|---|
| CSV | Excel, Google Sheets, Datenbanken |
| JSON | API-Integration, Entwickler, benutzerdefinierte Dashboards |
Inhalt des Exports
Ein Datenexport enthält standardmäßig aggregierte tägliche Metriken (eine Zeile pro Tag):
| Feld | Beschreibung |
|---|---|
| date | Der Tag, den die Metriken abdecken |
| visitors | Gesamtzahl der Besucher |
| unique_visitors | Unterschiedliche Besucher |
| pageviews | Seitenaufrufe insgesamt |
| bounce_rate | Absprungquote |
| avg_session_duration | Durchschnittliche Sitzungslänge |
Rohexporte enthalten stattdessen Details auf Besuchererlebnis-Ebene – date, session_id, device_type, browser, os, country_code, city, referrer und die Engagement-Wertscore für jeden Besuch.
CSV-Beispielausgabe
date,visitors,pageviews,unique_visitors,bounce_rate,avg_session_duration
2026-06-13,1248,3104,982,41.2,138
2026-06-12,1190,2987,941,43.7,142
2026-06-11,1305,3380,1024,39.8,151
Information
Benötigen Sie Umsatz pro Bestellung mit Quellen-, Medium- und Kampagnen-Attribution? Lesen Sie die Informationen stattdessen von der REST-API – dort befinden sich die transaktionsebenen-Umsatzzahlen.
Geplante Exporte
Scale PlanAutomatisieren Sie regelmäßige Exporte, damit eine neue Datei nach einem Zeitplan in Ihrem Posteingang ankommt.
Export-Tool öffnen
Gehen Sie zu Agentur → Export.
Zeitplan erstellen
Fügen Sie einen neuen geplanten Export hinzu und wählen Sie Website(s), Metriken, Format und Häufigkeit.
Empfänger festlegen
Fügen Sie die E-Mail-Adressen hinzu, die jeden Export erhalten sollten.
Zeitplan-Optionen
| Option | Auswahlmöglichkeiten |
|---|---|
| Häufigkeit | Wöchentlich, Monatlich |
| Format | CSV, JSON |
| Metriken | Besucher, Seitenaufrufe, Absprungquote und weitere Analysemetriken |
| Empfänger | E-Mail-Adressen |
Zeitpläne verwalten
Auf derselben Registerkarte Agentur → Export können Sie alle aktiven Zeitpläne sehen und diese jederzeit pausieren, bearbeiten oder löschen.
Umsätze über die API auslesen
Pro PlanDie REST-API (Plan Pro und höher) ermöglicht es Ihnen, Zahlen programmgesteuert in Ihre eigenen Skripte, Dashboards oder BI-Tools zu integrieren. Erstellen Sie einen Schlüssel unter Einstellungen → Konto → Sicherheit & Zugriff – Schlüssel beginnen mit zv_.
Umsatz-LTV-Kohorten
curl -G "https://api.zenovay.com/api/external/v1/revenue/{websiteId}/ltv" \
-H "X-API-Key: zv_YOUR_API_KEY" \
-d range=90d \
-d granularity=monthly
Die Antwort ist JSON mit Lifetime-Value-Zahlen pro Kohorte plus ein Zusammenfassungsblock. Ersetzen Sie {websiteId} durch die ID Ihrer Website.
Stats-Endpunkte
Verwenden Sie für Aggregate, Zeitreihen- und Aufschlüsselungsmetriken (einschließlich Umsatz, falls Sie Umsatz-Tracking konfiguriert haben) die Stats-Endpunkte:
curl -G "https://api.zenovay.com/api/external/v1/stats/aggregate" \
-H "X-API-Key: zv_YOUR_API_KEY" \
-d site_id=YOUR_WEBSITE_ID \
-d period=30d
Die vollständige Endpunkt-Liste, Parameter und Antwortformate finden Sie in der REST-API-Referenz und der maschinenlesbaren OpenAPI-Spezifikation. API-Antworten werden als JSON zurückgegeben.
Häufige API-Fehler
| Fehler | Lösung |
|---|---|
| 401 Unauthorized | Überprüfen Sie den Header X-API-Key und dass der Schlüssel mit zv_ beginnt |
| 429 Rate Limited | Verringern Sie die Anfragerate – siehe Ratenlimits |
| 400 Bad Request | Überprüfen Sie Ihre Abfrageparameter |
Best Practices beim Export
Wählen Sie das richtige Format
| Anwendungsfall | Empfohlenes Format |
|---|---|
| Tabellenkalkulationsanalyse | CSV |
| Systemintegration | JSON |
| Programmgesteuerte Abfragen | REST-API |
Überlegungen zum Zeitraum
- Gewähren Sie etwas Zeit, damit sehr aktuelle Daten vor dem Export verarbeitet werden.
- Exporte berücksichtigen das Datenspeicherfenster Ihres Plans.
- Passen Sie den Zeitraum an Ihre geschäftlichen Berichtszeiträume an.
Große Datensätze
Für große oder kontinuierliche Datenbedürfnisse:
- Verwenden Sie stattdessen die REST-API oder einen geplanten Export für wiederholte manuelle Downloads.
- Im Plan Scale verbinden Sie einen Warehouse-Export, um tägliche Aggregate direkt in S3 zu streamen (und gegebenenfalls BigQuery oder Snowflake). Siehe Warehouse-Export zu S3.
Häufige Export-Anwendungen
Finanzberichterstattung
- Monatliche Umsatzabstimmung
- Prüfungsdokumentation
Marketing-Analyse
- Kampagnen-ROI-Analyse
- Kanalleistung
- Attributionsmodellierung
Business Intelligence
Integrieren Sie exportierte Daten in Tools wie:
- Tableau
- Power BI
- Looker
- Benutzerdefinierte Dashboards
Fehlerbehebung
Export wird nicht zugestellt
Wenn Ihr Download-Link nicht ankommt:
- Überprüfen Sie Ihren Spam-Ordner auf die Export-E-Mail.
- Überprüfen Sie die Empfängeradresse bei einem geplanten Export.
- Versuchen Sie einen kleineren Zeitraum.
Daten scheinen unvollständig
Wenn Daten zu fehlen scheinen:
- Überprüfen Sie den Zeitraum.
- Bestätigen Sie, dass der Zeitraum innerhalb des Speicherfensters Ihres Plans liegt.
- Gewähren Sie aktuellen Daten Zeit für die Verarbeitung.
Datei wird nicht korrekt geöffnet
- Bestätigen Sie, dass die Dateierweiterung dem ausgewählten Format entspricht.
- CSV/JSON-Dateien sind UTF-8-codiert.
- Versuchen Sie eine andere Anwendung.
Datenschutz & Sicherheit
Exportierte Daten
Aggregate-Exporte täglich enthalten Analysemetriken, nicht persönliche Identifikatoren. Rohexporte enthalten Sitzungs- und Gerätedetails; behandeln Sie diese Dateien als vertraulich.
Zugriffskontrolle
- Datenexport und geplante Export-Tools erfordern eine Rolle als Besitzer oder Administrator im Plan Scale oder höher.
- Begrenzen Sie die Empfänger auf geplanten Exporten auf Personen, die die Daten sehen dürfen.
Datenspeicherung
Exportdateien:
- Werden von Zenovay nicht langfristig gespeichert, sondern an Ihre E-Mail oder Ihr System geliefert.
- Sind nach dem Herunterladen Ihre Verantwortung zum Sichern.