Exportación de Datos para Usuarios

Zenovay le ofrece dos caminos de exportación distintos, y es importante mantenerlos separados:

• Sus propios datos personales (el titular de la cuenta): una exportación gratuita de los artículos 20/15 de GDPR de los datos que Zenovay mantiene sobre usted, el usuario de Zenovay.
• Sus datos de análisis (los visitantes de los sitios que rastrea): los datos comerciales que recopila con Zenovay, exportados como CSV o JSON para sus registros o para cumplir solicitudes de sus propios usuarios.

Este artículo cubre ambos.

Entender la Portabilidad de Datos

GDPR Artículo 20

Las personas tienen derecho a:

• Recibir sus datos personales
• En un formato estructurado y comúnmente utilizado
• Que sea legible por máquina (por ejemplo, JSON)
• Y transmitirlo a otro responsable

Cuándo Aplica

La portabilidad de datos se aplica cuando:

• El procesamiento se basa en consentimiento o contrato
• El procesamiento es automatizado
• La solicitud proviene del sujeto de datos

Exporte Sus Propios Datos Personales (gratis, todos los planes)

Este es su derecho GDPR artículo 20 a la portabilidad y derecho de acceso artículo 15 para los datos que Zenovay mantiene sobre usted como usuario de Zenovay (perfil, metadatos de sitios, membresías de equipo, su propio registro de auditoría, y más). Es gratis en todos los planes.

1. 1

   Abra la configuración de su cuenta

   Vaya a Configuración → Cuenta en la aplicación (app.zenovay.com/settings/account).

2. 2

   Solicite la exportación

   En la sección Exportación de datos, haga clic en Descargar mis datos.

3. 3

   Guarde el archivo

   Zenovay genera un archivo JSON estructurado con sus datos personales y lo descarga en su navegador. Sin cola de espera, sin paso de correo electrónico.

La exportación excluye deliberadamente material de credenciales (hashes de contraseña, secretos MFA, hashes de claves API, tokens OAuth) y cualquier dato que pertenezca a otras personas, mientras que aún incluye el hecho de estos elementos donde sea relevante (por ejemplo, que tiene MFA habilitado o GitHub vinculado en una fecha determinada). También excluye los datos de análisis de los sitios que rastrea, que son los datos comerciales del operador del sitio web cubiertos en la siguiente sección.

Exporte Sus Datos de Análisis (Pro y superior)

La exportación de análisis cubre los datos de visitante y evento que recopila, separados de sus datos de cuenta personal. Es parte de la característica Exportación de Datos, disponible en los planes Pro, Scale y Enterprise.

Vía API

Use la API Externa para recuperar datos de análisis mediante programación. El acceso a la API requiere un plan pagado (Pro y superior), y las claves comienzan con zv_:

# Recuperar datos de análisis de visitantes para un sitio web
curl -X GET "https://api.zenovay.com/api/external/v1/analytics/{websiteId}/visitors" \
  -H "X-API-Key: zv_YOUR_API_KEY"

# Recuperar datos de análisis de páginas
curl -X GET "https://api.zenovay.com/api/external/v1/analytics/{websiteId}/pages" \
  -H "X-API-Key: zv_YOUR_API_KEY"

También puede autenticarse con Authorization: Bearer zv_YOUR_API_KEY. Cree y administre claves bajo Configuración → Seguridad → Claves API.

Exportaciones CSV y JSON por correo electrónico

Para una exportación empaquetada de análisis de un sitio web, solicite un trabajo CSV o JSON a través de la API. Zenovay genera el archivo y lo envía por correo electrónico al propietario del equipo cuando está listo:

# Solicitar una exportación CSV para un sitio web
curl -X POST "https://api.zenovay.com/api/team/{teamId}/export/{websiteId}/csv" \
  -H "Authorization: Bearer zv_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "date_from": "2024-01-01", "date_to": "2024-12-31", "aggregation_level": "daily" }'

# Solicitar una exportación JSON en su lugar
curl -X POST "https://api.zenovay.com/api/team/{teamId}/export/{websiteId}/json" \
  -H "Authorization: Bearer zv_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "date_from": "2024-01-01", "date_to": "2024-12-31", "aggregation_level": "daily" }'

aggregation_level puede ser raw, daily o monthly. La exportación se entrega a la dirección de correo electrónico del propietario del equipo.

Formatos de Datos de Exportación

Las exportaciones de análisis están disponibles como JSON o CSV.

Formato JSON

{
  "website_id": "wb_abc123",
  "date_from": "2024-01-01",
  "date_to": "2024-12-31",
  "pageviews": [
    {
      "timestamp": "2025-01-14T15:30:00Z",
      "url": "/products/widget",
      "title": "Widget Product Page",
      "referrer": "https://google.com",
      "device": "desktop",
      "browser": "Chrome",
      "country": "US"
    }
  ],
  "events": [
    {
      "timestamp": "2025-01-14T15:35:00Z",
      "name": "add_to_cart",
      "properties": {
        "product_id": "SKU-001",
        "price": 99.99
      }
    }
  ]
}

Formato CSV

Archivos separados para cada tipo de datos:

pageviews.csv:

timestamp,url,title,referrer,device,browser,country
2025-01-14T15:30:00Z,/products/widget,Widget Product Page,https://google.com,desktop,Chrome,US
2025-01-14T15:32:00Z,/checkout,Checkout,/products/widget,desktop,Chrome,US

events.csv:

timestamp,name,property_product_id,property_price,property_quantity
2025-01-14T15:35:00Z,add_to_cart,SKU-001,99.99,1
2025-01-14T15:40:00Z,purchase,SKU-001,99.99,1

Exportaciones Programadas

En Pro y superior, puede programar exportaciones de análisis recurrentes. Una exportación programada se ejecuta en una cadencia diaria, semanal o mensual y se entrega al correo electrónico del propietario del equipo cuando se completa cada ejecución. Las exportaciones programadas solo pueden ser creadas por el propietario del equipo.

Exportaciones de Warehouse a Cloud Storage (Scale y superior)

En Scale y Enterprise, puede enrutar los agregados de análisis diarios a su propio almacenamiento en la nube. La versión actual admite Amazon S3 (y servicios compatibles con S3 como Cloudflare R2, Backblaze B2 y Wasabi). Los destinos BigQuery y Snowflake están planeados.

Configure un destino en la configuración de su equipo, o a través de la API de exportación de warehouse:

# Crear un destino S3 para un equipo
curl -X POST "https://api.zenovay.com/api/team/{teamId}/warehouse-exports" \
  -H "Authorization: Bearer zv_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destination_type": "s3",
    "destination_config": { "bucket": "your-bucket", "region": "us-east-1", "path": "zenovay-exports/" },
    "credentials": { "access_key_id": "AKIA...", "secret_access_key": "..." }
  }'

Las credenciales que proporciona están encriptadas en reposo y nunca son devueltas por la API una vez guardadas.

Manejo de Solicitudes de Personas Interesadas

Cuando uno de sus propios usuarios le solicita sus datos, el flujo de trabajo es:

1. Recibir Solicitud
   └── Verificar identidad

2. Generar Exportación
   └── API: GET /api/external/v1/analytics/{websiteId}/visitors
   └── O solicite un trabajo CSV/JSON para el sitio web

3. Preparar Datos
   └── Filtrar los registros de la persona que solicita

4. Entregar Datos
   └── Enviar al solicitante a través de su propio canal

5. Confirmar Finalización
   └── Registrar para sus propios registros de cumplimiento

Zenovay es su procesador aquí: usted es el responsable de los datos de sus visitantes, por lo que la verificación de identidad y la entrega a la persona interesada son su responsabilidad.

Consideraciones de Seguridad

Entrega

• Las exportaciones de datos personales se descargan directamente en su sesión de navegador autenticada.
• Las exportaciones de análisis CSV/JSON se entregan al correo electrónico verificado del propietario del equipo.
• Las exportaciones de warehouse se escriben en un destino que posee y controla.
• Todo el tráfico de API es solo HTTPS y requiere una clave API válida.

Encriptación en Reposo

• Las credenciales de exportación de warehouse que proporciona (por ejemplo, claves de acceso S3) están encriptadas en reposo y nunca son devueltas por la API después de guardarse.
• Las direcciones IP asociadas con su cuenta se almacenan como hashes SHA-256 unidireccionales salados diariamente y no se pueden invertir; los hashes mismos no se incluyen en su exportación de datos personales.

Mejores Prácticas

Verificar Antes de Exportar

Al satisfacer una solicitud de uno de sus propios usuarios, siempre verifique la identidad:

• Enviar un correo electrónico de verificación
• Confirmar a través de un método de contacto conocido
• Documentar la verificación

Documéntalo Todo

Mantenga registros de:

• Fecha de recepción de solicitud
• Verificación realizada
• Exportación generada
• Datos entregados
• Usuario confirma la recepción

Respuesta Oportuna

GDPR requiere una respuesta dentro de 30 días:

• Establecer seguimiento interno
• Escalar plazos que se acercan
• Extender si es necesario (y notificar al solicitante)

Solución de Problemas

La exportación personal no se descargó

• Confirme que ha iniciado sesión y que accede a Configuración → Cuenta.
• Las exportaciones se limitan a pocas solicitudes por hora por usuario. Espere unos minutos e inténtelo de nuevo.

El correo electrónico de exportación de análisis no llegó

• Las exportaciones de análisis programadas y bajo demanda se envían al correo electrónico del propietario del equipo. Confirme que esa dirección es correcta y verifique el spam.
• Las exportaciones muy grandes tardan más en generarse. Intente un rango de fechas más estrecho.

Datos Faltantes

Si una exportación de análisis parece incompleta:

• Verificar rango de fechas
• Verificar que los datos no hayan sido eliminados ya
• Verificar la ventana de retención de datos de su plan

Próximos Pasos

• Derecho al Olvido
• Retención de Datos
• Descripción General del GDPR