Exportación de almacén a AWS S3

Scale Plan

Zenovay puede enviar sus agregados diarios de análisis a su propio bucket de AWS S3 de forma programada. Usted aporta su propio bucket y credenciales IAM; Zenovay firma las solicitudes PUT con AWS SigV4. Los datos son suyos, en su cuenta, con su política de retención: Zenovay simplemente escribe en él.

Qué se exporta

La V1 exporta los agregados de analytics_daily: una fila por sitio web por fecha con los mismos números que ve en su panel.

Columna	Descripción
`website_id`	UUID del sitio web al que pertenece la fila
`date`	La fecha que agrega la fila (UTC)
`total_visitors`	Total de visitantes ese día
`unique_visitors`	Visitantes únicos ese día
`pageviews`	Páginas vistas ese día
`bounce_rate`	Tasa de rebote (0–1)
`avg_session_duration`	Duración media de sesión en segundos

La expansión futura (BigQuery, Snowflake y conjuntos de datos más ricos como eventos personalizados) está en la hoja de ruta. Este artículo cubre solo S3.

Lo que necesitará

Una cuenta de AWS
Un bucket de S3 (cualquier región)
Un usuario IAM (o rol) con s3:PutObject en el prefijo que configurará: no se necesitan otros permisos
ID de clave de acceso + clave de acceso secreta para ese usuario IAM
Un equipo de Zenovay en el plan Scale o superior

Paso 1 — Crear la política IAM

En la consola IAM de AWS, cree una política con este conjunto mínimo de permisos. Reemplace your-bucket y zenovay/ con el bucket y el prefijo que usará.

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

Zenovay nunca lista, lee ni elimina objetos en su bucket. La política solo otorga PutObject en un único prefijo.

Paso 2 — Crear un usuario IAM

Adjunte la política del Paso 1 a un nuevo usuario IAM. Genere una clave de acceso para el usuario y copie el ID de clave de acceso + la clave de acceso secreta: los pegará en Zenovay en el Paso 4.

Paso 3 — (Opcional) Política de ciclo de vida en su bucket

Cada ejecución programada escribe en:

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

La clave del objeto es idempotente: volver a ejecutar para la misma fecha sobrescribe la misma clave. Puede configurar una política de ciclo de vida de S3 para:

Transicionar objetos más antiguos a S3 Glacier o Glacier Deep Archive para almacenamiento a largo plazo más económico
Expirar objetos después de N días/años si no necesita retención a largo plazo

Esto está completamente bajo su control; Zenovay no gestiona el ciclo de vida en su bucket.

Paso 4 — Conectar el destino en Zenovay

Vaya a Settings → sección Data → pestaña Warehouse de su sitio web
Haga clic en Add S3 destination
Complete el formulario:

Campo	Valor
Nombre del bucket	`your-bucket`
Región de AWS	La región donde está su bucket (por ejemplo, `eu-central-1`)
ID de clave de acceso	Del Paso 2
Clave de acceso secreta	Del Paso 2
Prefijo de clave de objeto	`zenovay/` (o cualquier prefijo; debe coincidir con su política IAM)
Programación	Diaria o por horas

Zenovay cifra su clave de acceso secreta en reposo con AES-GCM y nunca la devuelve en respuestas de API.

Paso 5 — Probar el destino

Después de guardar, haga clic en Run now en la fila del destino. Zenovay:

Leerá las filas de analytics_daily del día más reciente de sus datos
Las formateará como CSV
Realizará un PUT a s3://your-bucket/<prefix><team_id>/<yesterday>/analytics_daily.csv

El resultado aparece en segundos. Si falla, el mensaje de error le indica qué rechazó AWS: generalmente un error tipográfico en el nombre del bucket, una discrepancia de región o un permiso IAM faltante.

Cadencia de programación

Diaria: se ejecuta una vez cada 24 horas por destino
Por horas: se ejecuta cada hora en el minuto 0

El cron por horas de Zenovay procesa hasta 200 destinos por tick; si su equipo tiene muchos destinos, las ejecuciones pueden desfasarse unos minutos.

Pausar, reanudar, eliminar

Pausar detiene las ejecuciones programadas sin perder la configuración. La opción "Run now" manual sigue funcionando.
Reanudar vuelve a activar las ejecuciones programadas con el mismo reloj next_run_at.
Eliminar borra la configuración del destino Y su historial de ejecuciones. Los archivos existentes en su bucket de S3 no se tocan: permanecen bajo su control.

Privacidad y eliminación de cuenta

Solo agregados; ninguna IP de visitante individual ni datos personales salen de Zenovay
Credenciales almacenadas cifradas en reposo con AES-GCM
Eliminar su cuenta de Zenovay purga las credenciales cifradas y la configuración del destino como parte de la cascada estándar del derecho al olvido

Preguntas frecuentes

¿Puedo usar un almacén compatible con S3 que no sea AWS, como MinIO, R2 o Wasabi? Sí. Expanda Advanced (S3-compatible endpoints) en el formulario de destino y pegue la URL del endpoint S3 de su proveedor (por ejemplo https://abc123.r2.cloudflarestorage.com). Para Cloudflare R2 y otros destinos que no sean AWS, seleccione la región Auto (Cloudflare R2 / S3-compatible). El endpoint debe ser accesible públicamente: para probar contra una instancia MinIO local, expóngala a través de un túnel (cloudflared o ngrok) y use la URL pública.

¿Y BigQuery y Snowflake? Llegarán en una versión posterior. Se aplicarán la misma programación, restricción por plan y almacenamiento de credenciales; solo difiere el conector.

¿Puedo exportar a mi propio bucket en una cuenta de AWS diferente? Sí: ese es el modelo admitido. Su usuario IAM, su bucket, su cuenta. Zenovay simplemente firma el PUT.

¿Cómo descargo los datos una vez que están en S3? Con las herramientas estándar de AWS: aws s3 cp, la consola de AWS o cualquier cliente de S3. A partir de ahí son suyos: consúltelos con Athena, cárguelos en Glue/Redshift/BigQuery o inclúyalos en sus propios pipelines.

¿Qué región debo elegir para el bucket? Donde vivan sus herramientas de procesamiento. Zenovay no cobra tarifas de egreso de datos: esas son entre usted y AWS. Los clientes de la UE generalmente eligen eu-central-1 por razones de residencia de datos.