Zenovay le permite extraer sus datos para análisis externo, informes o integración con otras herramientas empresariales. Hay dos formas de hacerlo: la herramienta de exportación de datos (descargar o programar archivos CSV/JSON) y la API REST (consultar cifras mediante programación). Este artículo cubre ambos métodos y cómo leer sus cifras de ingresos de cada uno.
Información
La exportación de Zenovay produce datos analíticos – agregados diarios o filas de visitantes sin procesar. No es un libro mayor de contabilidad línea por línea de cada pedido. Para ingresos, la API devuelve totales de transacciones y atribución; para un registro completo de transacciones, exporte desde su proveedor de pago (Stripe, Paddle, etc.).
Descargar una exportación de datos
Scale PlanLa herramienta de exportación de datos se encuentra en la página Agencia (propietarios y administradores del plan Scale o superior).
Abrir la herramienta de exportación
Vaya a Agencia → Exportar.
Elegir sitios web y un rango de fechas
Seleccione uno o más de sus sitios web y el período que desea exportar.
Elegir un formato
Exporte como CSV o JSON.
Ejecutar la exportación
Zenovay crea el archivo y le envía un enlace de descarga seguro cuando está listo. Los rangos más grandes se procesan en segundo plano.
Formatos de exportación
| Formato | Recomendado para |
|---|---|
| CSV | Excel, Google Sheets, bases de datos |
| JSON | Integración de API, desarrolladores, paneles personalizados |
Contenido de la exportación
Una exportación de datos contiene de forma predeterminada métricas diarias agregadas (una fila por día):
| Campo | Descripción |
|---|---|
| date | El día que cubren las métricas |
| visitors | Total de visitantes |
| unique_visitors | Visitantes distintos |
| pageviews | Total de visualizaciones de páginas |
| bounce_rate | Tasa de rebote |
| avg_session_duration | Duración promedio de la sesión |
Las exportaciones sin procesar incluyen detalles a nivel de visitante en su lugar – date, session_id, device_type, browser, os, country_code, city, referrer y la puntuación de valor de participación para cada visita.
Salida CSV de ejemplo
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
Información
¿Necesita ingresos por pedido con atribución de origen, medio y campaña? Léalo desde la API REST en su lugar – ahí es donde se encuentran las cifras de ingresos a nivel de transacción.
Exportaciones programadas
Scale PlanAutomatice las exportaciones recurrentes para que un archivo nuevo llegue a su bandeja de entrada según un horario.
Abrir la herramienta de exportación
Vaya a Agencia → Exportar.
Crear un programa
Agregue una nueva exportación programada, eligiendo el/los sitio(s) web, métricas, formato y cadencia.
Establecer destinatarios
Agregue las direcciones de correo electrónico que deben recibir cada exportación.
Opciones de programación
| Opción | Opciones |
|---|---|
| Frecuencia | Semanal, Mensual |
| Formato | CSV, JSON |
| Métricas | Visitantes, visualizaciones de páginas, tasa de rebote y otras métricas analíticas |
| Destinatarios | Direcciones de correo electrónico |
Gestión de programas
En la misma pestaña Agencia → Exportar puede ver todos los programas activos y pausarlos, editarlos o eliminarlos en cualquier momento.
Leer ingresos a través de la API
Pro PlanLa API REST (plan Pro y superior) le permite extraer cifras mediante programación en sus propios scripts, paneles o herramientas BI. Cree una clave en Configuración → Cuenta → Seguridad y acceso – las claves comienzan con zv_.
Cohortes LTV de ingresos
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 respuesta es JSON que contiene cifras de valor de por vida por cohorte más un bloque de resumen. Reemplace {websiteId} con el ID de su sitio web.
Puntos finales de estadísticas
Para métricas agregadas, de series de tiempo y de desglose (incluidos los ingresos si ha configurado el seguimiento de ingresos), use los puntos finales de estadísticas:
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 lista completa de puntos finales, parámetros y formas de respuesta se encuentran en la referencia de la API REST y en la especificación OpenAPI legible por máquina. Las respuestas de la API se devuelven como JSON.
Errores comunes de la API
| Error | Solución |
|---|---|
| 401 Unauthorized | Verifique el encabezado X-API-Key y que la clave comience con zv_ |
| 429 Rate Limited | Reduzca la velocidad de sus solicitudes – ver Límites de velocidad |
| 400 Bad Request | Verifique sus parámetros de consulta |
Mejores prácticas de exportación
Elegir el formato correcto
| Caso de uso | Formato recomendado |
|---|---|
| Análisis de hojas de cálculo | CSV |
| Integración del sistema | JSON |
| Consultas programáticas | API REST |
Consideraciones sobre el rango de fechas
- Permita que los datos muy recientes se estabilicen un poco antes de exportar.
- Las exportaciones respetan la ventana de retención de datos de su plan.
- Haga coincidir el rango con sus períodos de informe comercial.
Grandes conjuntos de datos
Para necesidades de datos grandes o continuos:
- Use la API REST o una exportación programada en lugar de descargas manuales repetidas.
- En el plan Scale, conecte una exportación de almacén para transmitir agregados diarios directamente a S3 (y, donde esté disponible, BigQuery o Snowflake). Ver Exportación de almacén a S3.
Usos comunes de exportación
Informes financieros
- Conciliación mensual de ingresos
- Documentación de auditoría
Análisis de marketing
- Análisis de ROI de campañas
- Desempeño del canal
- Modelado de atribución
Inteligencia empresarial
Integre datos exportados en herramientas como:
- Tableau
- Power BI
- Looker
- Paneles personalizados
Solución de problemas
Exportación no recibida
Si su enlace de descarga no llega:
- Verifique su carpeta de spam para el correo electrónico de exportación.
- Verifique la dirección del destinatario en una exportación programada.
- Intente un rango de fechas más pequeño.
Los datos parecen incompletos
Si faltan datos:
- Verifique el rango de fechas.
- Confirme que el período está dentro de la ventana de retención de su plan.
- Permita que los datos recientes terminen de procesarse.
El archivo no se abre correctamente
- Confirme que la extensión del archivo coincida con el formato elegido.
- Los archivos CSV/JSON están codificados en UTF-8.
- Intente una aplicación diferente.
Privacidad y seguridad
Datos exportados
Las exportaciones de agregados diarios contienen métricas analíticas, no identificadores personales. Las exportaciones sin procesar incluyen detalles de sesión y dispositivo; trate estos archivos como sensibles.
Control de acceso
- Las herramientas de exportación y exportación programada requieren un rol de propietario o administrador en el plan Scale o superior.
- Limite los destinatarios en exportaciones programadas a personas que deben ver los datos.
Retención de datos
Los archivos de exportación:
- No se almacenan a largo plazo por Zenovay, sino que se entregan a su correo electrónico o sistema.
- Son su responsabilidad asegurar una vez descargado.