Export entrepôt vers AWS S3

Scale Plan

Zenovay peut envoyer vos agrégats analytics quotidiens vers votre propre bucket AWS S3 selon un calendrier. Vous apportez votre propre bucket et vos identifiants IAM ; Zenovay signe les requêtes PUT avec AWS SigV4. Les données vous appartiennent, dans votre compte, avec votre politique de rétention — Zenovay se contente d'y écrire.

Ce qui est exporté

La V1 exporte les agrégats analytics_daily : une ligne par site web par date avec les mêmes chiffres que vous voyez sur votre tableau de bord.

Colonne	Description
`website_id`	UUID du site web auquel appartient la ligne
`date`	La date que la ligne agrège (UTC)
`total_visitors`	Total des visiteurs ce jour-là
`unique_visitors`	Visiteurs uniques ce jour-là
`pageviews`	Pages vues ce jour-là
`bounce_rate`	Taux de rebond (0–1)
`avg_session_duration`	Durée moyenne de session en secondes

L'expansion future (BigQuery, Snowflake et des jeux de données plus riches comme les événements personnalisés) figure sur la feuille de route. Cet article couvre uniquement S3.

Ce dont vous aurez besoin

Un compte AWS
Un bucket S3 (n'importe quelle région)
Un utilisateur IAM (ou rôle) avec s3:PutObject sur le préfixe que vous allez configurer — aucune autre autorisation n'est nécessaire
Identifiant de clé d'accès + clé d'accès secrète pour cet utilisateur IAM
Une équipe Zenovay sur le plan Scale ou supérieur

Étape 1 — Créer la politique IAM

Dans la console AWS IAM, créez une politique avec ce jeu d'autorisations minimal. Remplacez your-bucket et zenovay/ par le bucket et le préfixe que vous utiliserez.

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

Zenovay ne liste, ne lit ni ne supprime jamais d'objets dans votre bucket. La politique n'accorde que PutObject sur un seul préfixe.

Étape 2 — Créer un utilisateur IAM

Associez la politique de l'étape 1 à un nouvel utilisateur IAM. Générez une clé d'accès pour l'utilisateur et copiez l'identifiant de clé d'accès + la clé d'accès secrète — vous les collerez dans Zenovay à l'étape 4.

Étape 3 — (Optionnel) Politique de cycle de vie sur votre bucket

Chaque exécution planifiée écrit dans :

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

La clé d'objet est idempotente — réexécuter pour la même date écrase la même clé. Vous pouvez configurer une politique de cycle de vie S3 pour :

Faire passer les objets anciens vers S3 Glacier ou Glacier Deep Archive pour un stockage à long terme moins coûteux
Faire expirer les objets après N jours/années si vous n'avez pas besoin d'une rétention à long terme

Cela est entièrement sous votre contrôle ; Zenovay ne gère pas le cycle de vie de votre bucket.

Étape 4 — Connecter la destination dans Zenovay

Accédez aux Paramètres de votre site → section Données → onglet Entrepôt
Cliquez sur Ajouter une destination S3
Remplissez le formulaire :

Champ	Valeur
Nom du bucket	`your-bucket`
Région AWS	La région où se trouve votre bucket (ex. `eu-central-1`)
Identifiant de clé d'accès	De l'étape 2
Clé d'accès secrète	De l'étape 2
Préfixe de clé d'objet	`zenovay/` (ou tout préfixe ; doit correspondre à votre politique IAM)
Calendrier	Quotidien ou horaire

Zenovay chiffre votre clé d'accès secrète au repos avec AES-GCM et ne la renvoie jamais dans les réponses API.

Étape 5 — Tester la destination

Après l'enregistrement, cliquez sur Exécuter maintenant sur la ligne de destination. Zenovay va :

Lire les lignes analytics_daily du jour le plus récent depuis vos données
Mettre en forme en CSV
Effectuer un PUT vers s3://your-bucket/<prefix><team_id>/<yesterday>/analytics_daily.csv

Le résultat apparaît en quelques secondes. En cas d'échec, le message d'erreur vous indique ce qu'AWS a rejeté — généralement une faute de frappe dans le nom du bucket, une incompatibilité de région, ou une autorisation IAM manquante.

Cadence du calendrier

Quotidien : s'exécute une fois toutes les 24 heures par destination
Horaire : s'exécute chaque heure à la minute 0

Le cron horaire de Zenovay traite jusqu'à 200 destinations par tick ; si votre équipe a de nombreuses destinations, les exécutions peuvent se décaler de quelques minutes.

Pause, reprise, suppression

Pause arrête les exécutions planifiées sans perdre la configuration. L'option manuelle « Exécuter maintenant » fonctionne toujours.
Reprise réactive les exécutions planifiées avec la même horloge next_run_at.
Suppression retire la configuration de destination ET son historique d'exécution. Les fichiers existants dans votre bucket S3 ne sont pas touchés — ils restent sous votre contrôle.

Confidentialité et suppression de compte

Agrégats uniquement ; aucune IP individuelle de visiteur ni aucune donnée personnelle ne quittent Zenovay
Identifiants stockés chiffrés au repos avec AES-GCM
La suppression de votre compte Zenovay purge les identifiants chiffrés et la configuration de destination dans le cadre de la cascade standard du droit à l'effacement

Questions fréquentes

Puis-je utiliser un stockage compatible S3 non-AWS comme MinIO, R2 ou Wasabi ? Oui. Développez Avancé (endpoints S3-compatibles) dans le formulaire de destination et collez l'URL d'endpoint S3 de votre fournisseur (par exemple https://abc123.r2.cloudflarestorage.com). Pour Cloudflare R2 et autres cibles non-AWS, choisissez la région Auto (Cloudflare R2 / S3-compatible). L'endpoint doit être accessible publiquement — pour tester contre une instance MinIO locale, exposez-la via un tunnel (cloudflared ou ngrok) et utilisez l'URL publique.

Qu'en est-il de BigQuery et Snowflake ? Disponibles dans une version ultérieure. La même planification, la même restriction par plan et le même stockage des identifiants s'appliqueront ; seul le connecteur diffère.

Puis-je exporter vers mon propre bucket dans un compte AWS différent ? Oui — c'est le modèle pris en charge. Votre utilisateur IAM, votre bucket, votre compte. Zenovay signe simplement le PUT.

Comment télécharger les données une fois dans S3 ? Outils AWS standard — aws s3 cp, la console AWS, ou n'importe quel client S3. À partir de là, elles vous appartiennent : interrogez avec Athena, chargez dans Glue/Redshift/BigQuery, ou alimentez vos propres pipelines.

Quelle région dois-je choisir pour le bucket ? Là où se trouvent vos outils en aval. Zenovay ne facture aucun frais d'entrée/sortie de données — ceux-ci sont entre vous et AWS. Les clients européens choisissent généralement eu-central-1 pour des raisons de résidence des données.