Warehouse-Export nach AWS S3

Scale Plan

Zenovay kann Ihre täglichen Analytics-Aggregate planmäßig in Ihren eigenen AWS S3-Bucket übertragen. Sie stellen Ihren eigenen Bucket und IAM-Zugangsdaten bereit; Zenovay signiert die PUT-Anfragen mit AWS SigV4. Die Daten gehören Ihnen, in Ihrem Konto, mit Ihrer Aufbewahrungsrichtlinie — Zenovay schreibt nur hinein.

Was exportiert wird

V1 exportiert analytics_daily-Aggregate: eine Zeile pro Website und Datum mit denselben Zahlen, die Sie in Ihrem Dashboard sehen.

Spalte	Beschreibung
`website_id`	UUID der Website, zu der die Zeile gehört
`date`	Das Datum, das die Zeile aggregiert (UTC)
`total_visitors`	Gesamtbesucher an diesem Tag
`unique_visitors`	Eindeutige Besucher an diesem Tag
`pageviews`	Seitenaufrufe an diesem Tag
`bounce_rate`	Absprungrate (0–1)
`avg_session_duration`	Durchschnittliche Sitzungsdauer in Sekunden

Zukünftige Erweiterungen (BigQuery, Snowflake und reichhaltigere Datensätze wie benutzerdefinierte Ereignisse) sind auf der Roadmap. Dieser Artikel behandelt nur S3.

Was Sie benötigen

Ein AWS-Konto
Einen S3-Bucket (beliebige Region)
Einen IAM-Benutzer (oder eine Rolle) mit s3:PutObject auf dem Präfix, das Sie konfigurieren — keine weiteren Berechtigungen sind erforderlich
Access Key ID + Secret Access Key für diesen IAM-Benutzer
Ein Zenovay-Team im Scale-Tarif oder höher

Schritt 1 — IAM-Richtlinie erstellen

Erstellen Sie in der AWS IAM-Konsole eine Richtlinie mit diesem minimalen Berechtigungssatz. Ersetzen Sie your-bucket und zenovay/ durch den Bucket und das Präfix, das Sie verwenden werden.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ZenovayWarehouseExportPut",
      "Effect": "Allow",
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3:::your-bucket/zenovay/*"
    }
  ]
}

Zenovay listet, liest oder löscht keine Objekte in Ihrem Bucket. Die Richtlinie gewährt nur PutObject auf einem einzigen Präfix.

Schritt 2 — IAM-Benutzer erstellen

Weisen Sie die Richtlinie aus Schritt 1 einem neuen IAM-Benutzer zu. Generieren Sie einen Access Key für den Benutzer und kopieren Sie Access Key ID + Secret Access Key — diese fügen Sie in Schritt 4 in Zenovay ein.

Schritt 3 — (Optional) Lifecycle-Richtlinie für Ihren Bucket

Jeder geplante Durchlauf schreibt nach:

s3://your-bucket/<prefix><team_id>/<date>/analytics_daily.csv

Der Objektschlüssel ist idempotent — ein erneuter Durchlauf für dasselbe Datum überschreibt denselben Schlüssel. Sie können eine S3-Lifecycle-Richtlinie konfigurieren, um:

Ältere Objekte zur günstigeren Langzeitaufbewahrung nach S3 Glacier oder Glacier Deep Archive zu verschieben
Objekte nach N Tagen/Jahren ablaufen zu lassen, wenn Sie keine Langzeitaufbewahrung benötigen

Dies liegt vollständig in Ihrer Kontrolle; Zenovay verwaltet den Lifecycle Ihres Buckets nicht.

Schritt 4 — Ziel in Zenovay verbinden

Gehen Sie zu den Einstellungen Ihrer Website → Abschnitt Daten → Tab Warehouse
Klicken Sie auf S3-Ziel hinzufügen
Füllen Sie das Formular aus:

Feld	Wert
Bucket-Name	`your-bucket`
AWS-Region	Die Region, in der sich Ihr Bucket befindet (z. B. `eu-central-1`)
Access Key ID	Aus Schritt 2
Secret Access Key	Aus Schritt 2
Objektschlüssel-Präfix	`zenovay/` (oder ein beliebiges Präfix; muss Ihrer IAM-Richtlinie entsprechen)
Zeitplan	Täglich oder stündlich

Zenovay verschlüsselt Ihren Secret Access Key im Ruhezustand mit AES-GCM und gibt ihn nie in API-Antworten zurück.

Schritt 5 — Ziel testen

Klicken Sie nach dem Speichern in der Ziel-Zeile auf Jetzt ausführen. Zenovay führt dann folgende Schritte aus:

Die analytics_daily-Zeilen des letzten Tages aus Ihren Daten lesen
Als CSV formatieren
PUT nach s3://your-bucket/<prefix><team_id>/<yesterday>/analytics_daily.csv

Das Ergebnis erscheint in Sekunden. Falls es fehlschlägt, teilt Ihnen die Fehlermeldung mit, was AWS abgelehnt hat — in der Regel ein Tippfehler im Bucket-Namen, eine Region-Abweichung oder eine fehlende IAM-Berechtigung.

Zeitplan-Kadenz

Täglich: läuft einmal alle 24 Stunden pro Ziel
Stündlich: läuft jede Stunde zur Minute 0

Zenovay's stündlicher Cron verarbeitet bis zu 200 Ziele pro Durchlauf; wenn Ihr Team viele Ziele hat, können die Läufe um einige Minuten versetzt sein.

Pausieren, fortsetzen, löschen

Pausieren stoppt geplante Läufe, ohne die Konfiguration zu verlieren. Manuelles „Jetzt ausführen" funktioniert weiterhin.
Fortsetzen aktiviert geplante Läufe mit derselben next_run_at-Uhr wieder.
Löschen entfernt die Zielkonfiguration UND den Ausführungsverlauf. Vorhandene Dateien in Ihrem S3-Bucket werden nicht berührt — sie verbleiben unter Ihrer Kontrolle.

Datenschutz und Kontolöschung

Nur Aggregate; keine individuellen Besucher-IPs oder personenbezogene Daten verlassen Zenovay
Zugangsdaten werden im Ruhezustand mit AES-GCM verschlüsselt gespeichert
Das Löschen Ihres Zenovay-Kontos löscht die verschlüsselten Zugangsdaten und die Zielkonfiguration als Teil der standardmäßigen Recht-auf-Vergessenwerden-Kaskade

Häufig gestellte Fragen

Kann ich einen Nicht-AWS-S3-kompatiblen Speicher wie MinIO, R2 oder Wasabi verwenden? Ja. Klappen Sie im Zielformular Erweitert (S3-kompatible Endpoints) aus und fügen Sie die S3-Endpoint-URL Ihres Anbieters ein (zum Beispiel https://abc123.r2.cloudflarestorage.com). Für Cloudflare R2 und andere Nicht-AWS-Ziele wählen Sie die Region Auto (Cloudflare R2 / S3-kompatibel). Der Endpoint muss öffentlich erreichbar sein — für Tests gegen eine lokale MinIO-Instanz stellen Sie sie über einen Tunnel bereit (cloudflared oder ngrok) und verwenden Sie die öffentliche URL.

Was ist mit BigQuery und Snowflake? Folgt in einem späteren Release. Dasselbe Scheduling, dieselbe Tarif-Abschirmung und dieselbe Zugangsdatenspeicherung werden gelten; nur der Connector unterscheidet sich.

Kann ich in einen Bucket in einem anderen AWS-Konto exportieren? Ja — das ist das unterstützte Modell. Ihr IAM-Benutzer, Ihr Bucket, Ihr Konto. Zenovay signiert nur den PUT.

Wie lade ich die Daten herunter, sobald sie in S3 sind? Mit Standard-AWS-Tools — aws s3 cp, der AWS-Konsole oder einem beliebigen S3-Client. Von dort gehören sie Ihnen: mit Athena abfragen, in Glue/Redshift/BigQuery laden oder in Ihre eigenen Pipelines einspeisen.

Welche Region sollte ich für den Bucket wählen? Dort, wo Ihre nachgelagerten Tools laufen. Zenovay berechnet keine Daten-Egress-Gebühren — diese fallen zwischen Ihnen und AWS an. EU-Kunden wählen aus Datenschutzgründen in der Regel eu-central-1.