Zenovay vous permet d'extraire vos données pour une analyse externe, un reporting ou une intégration avec d'autres outils métier. Il y a deux façons de procéder : l'outil d'export de données (télécharger ou planifier des fichiers CSV/JSON) et l'API REST (interroger les chiffres de manière programmatique). Cet article couvre les deux méthodes et comment lire vos chiffres de revenus à partir de chacune.
Info
L'export de Zenovay produit des données analytiques – des agrégats quotidiens ou des lignes au niveau des visiteurs brutes. Il ne s'agit pas d'un registre comptable ligne par ligne de chaque commande. Pour les revenus, l'API renvoie les totaux des transactions et l'attribution ; pour un journal complet des transactions, exportez depuis votre prestataire de paiement (Stripe, Paddle, etc.).
Télécharger un export de données
Scale PlanL'outil d'export de données se trouve sur la page Agence (propriétaires et administrateurs du plan Scale ou supérieur).
Ouvrir l'outil d'export
Accédez à Agence → Export.
Choisir les sites web et la plage de dates
Sélectionnez un ou plusieurs de vos sites web et la période que vous souhaitez exporter.
Choisir un format
Exportez en tant que CSV ou JSON.
Lancer l'export
Zenovay crée le fichier et vous envoie un lien de téléchargement sécurisé une fois qu'il est prêt. Les plages plus grandes sont traitées en arrière-plan.
Formats d'export
| Format | Recommandé pour |
|---|---|
| CSV | Excel, Google Sheets, bases de données |
| JSON | Intégration API, développeurs, tableaux de bord personnalisés |
Contenu de l'export
Un export de données contient par défaut des métriques quotidiennes agrégées (une ligne par jour) :
| Champ | Description |
|---|---|
| date | Le jour couverts par les métriques |
| visitors | Total des visiteurs |
| unique_visitors | Visiteurs distincts |
| pageviews | Total des pages vues |
| bounce_rate | Taux de rebond |
| avg_session_duration | Durée moyenne de la session |
Les exports bruts incluent plutôt les détails au niveau des visiteurs – date, session_id, device_type, browser, os, country_code, city, referrer et le score de valeur d'engagement pour chaque visite.
Exemple de sortie CSV
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
Info
Avez-vous besoin du revenu par commande avec attribution source, medium et campagne ? Lisez-le plutôt à partir de l'API REST – c'est là que se trouvent les chiffres de revenus au niveau des transactions.
Exports planifiés
Scale PlanAutomatisez les exports récurrents afin qu'un fichier actualisé arrive dans votre boîte de réception selon un calendrier.
Ouvrir l'outil d'export
Accédez à Agence → Export.
Créer un programme
Ajoutez un nouvel export planifié, en choisissant le(s) site(s) web, les métriques, le format et la cadence.
Définir les destinataires
Ajoutez les adresses e-mail qui doivent recevoir chaque export.
Options de planification
| Option | Choix |
|---|---|
| Fréquence | Hebdomadaire, Mensuel |
| Format | CSV, JSON |
| Métriques | Visiteurs, pages vues, taux de rebond et autres métriques analytiques |
| Destinataires | Adresses e-mail |
Gestion des calendriers
Sur le même onglet Agence → Export, vous pouvez voir tous les calendriers actifs et les suspendre, les modifier ou les supprimer à tout moment.
Lire les revenus via l'API
Pro PlanL'API REST (plan Pro et supérieur) vous permet d'extraire des chiffres de manière programmatique dans vos propres scripts, tableaux de bord ou outils BI. Créez une clé sous Paramètres → Compte → Sécurité & accès – les clés commencent par zv_.
Cohortes LTV de revenus
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
La réponse est un JSON contenant les chiffres de valeur à vie par cohorte plus un bloc de résumé. Remplacez {websiteId} par l'identifiant de votre site web.
Points de terminaison des statistiques
Pour les métriques agrégées, les séries chronologiques et de répartition (y compris les revenus si vous avez configuré le suivi des revenus), utilisez les points de terminaison des statistiques :
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
La liste complète des points de terminaison, les paramètres et les formes de réponse se trouvent dans la référence de l'API REST et la spécification OpenAPI lisible par machine. Les réponses de l'API sont renvoyées au format JSON.
Erreurs courantes de l'API
| Erreur | Solution |
|---|---|
| 401 Unauthorized | Vérifiez l'en-tête X-API-Key et que la clé commence par zv_ |
| 429 Rate Limited | Ralentissez votre taux de requête – voir Limites de débit |
| 400 Bad Request | Vérifiez vos paramètres de requête |
Meilleures pratiques d'export
Choisir le bon format
| Cas d'utilisation | Format recommandé |
|---|---|
| Analyse de feuille de calcul | CSV |
| Intégration système | JSON |
| Requêtes programmatiques | API REST |
Considérations relatives à la plage de dates
- Accordez un peu de temps aux données très récentes pour se stabiliser avant l'export.
- Les exports respectent la fenêtre de rétention des données de votre plan.
- Faites correspondre la plage à vos périodes de reporting métier.
Grands ensembles de données
Pour les données volumineuses ou continues :
- Utilisez l'API REST ou un export planifié plutôt que des téléchargements manuels répétés.
- Sur le plan Scale, connectez un export d'entrepôt pour diffuser les agrégats quotidiens directement dans S3 (et, le cas échéant, BigQuery ou Snowflake). Voir Export d'entrepôt vers S3.
Usages courants d'export
Rapports financiers
- Réconciliation mensuelle des revenus
- Documentation d'audit
Analyse marketing
- Analyse ROI des campagnes
- Performance des canaux
- Modélisation d'attribution
Intelligence métier
Intégrez les données exportées dans des outils tels que :
- Tableau
- Power BI
- Looker
- Tableaux de bord personnalisés
Dépannage
Export non reçu
Si votre lien de téléchargement n'arrive pas :
- Vérifiez votre dossier indésirables pour l'e-mail d'export.
- Vérifiez l'adresse destinataire sur un export planifié.
- Essayez une plage de dates plus petite.
Les données semblent incomplètes
Si des données semblent manquer :
- Vérifiez la plage de dates.
- Confirmez que la période se situe dans la fenêtre de rétention de votre plan.
- Permettez aux données récentes de terminer le traitement.
Le fichier ne s'ouvre pas correctement
- Confirmez que l'extension du fichier correspond au format choisi.
- Les fichiers CSV/JSON sont codés en UTF-8.
- Essayez une autre application.
Confidentialité & Sécurité
Données exportées
Les exports d'agrégats quotidiens contiennent des métriques analytiques, pas des identifiants personnels. Les exports bruts incluent les détails de session et d'appareil ; traitez ces fichiers comme sensibles.
Contrôle d'accès
- Les outils d'export et d'export planifié nécessitent un rôle propriétaire ou administrateur sur le plan Scale ou supérieur.
- Limitez les destinataires sur les exports planifiés aux personnes qui doivent voir les données.
Rétention des données
Les fichiers d'export sont :
- Non stockés à long terme par Zenovay, mais livrés à votre e-mail ou système.
- Votre responsabilité de sécuriser une fois téléchargé.