Si está migrando de Fathom Analytics a Zenovay, el Fathom Importer lleva sus agregados diarios recientes a Zenovay para que conserve todo el contexto el día del cambio. La importación usa la API de Fathom con una clave API de solo lectura y el ID de su sitio en Fathom.
Qué se importa
- Páginas vistas y visitantes únicos diarios (últimos 90 días)
- Páginas principales, referentes principales, países principales (desglose de ventana)
- Desglose por navegador, tipo de dispositivo y sistema operativo
Qué no se importa
- Historial más antiguo que los últimos 90 días
- Sesiones de visitantes individuales o registros de eventos sin procesar
- Objetivos de Fathom / conversiones (solo totales agregados)
- Datos de e-commerce / ingresos
- Datos en tiempo real (solo días completados; el día actual siempre se excluye)
Cómo importar
Paso 1: Obtener su clave API de Fathom
- Inicie sesión en su cuenta de Fathom en usefathom.com.
- Vaya a Cuenta → API (en la barra lateral izquierda).
- Haga clic en Crear clave API.
- Asigne un nombre descriptivo (p. ej. «Importación Zenovay — junio 2026»).
- Establezca el permiso en Solo lectura — Zenovay no necesita acceso de escritura.
- Copie la clave; solo se muestra una vez.
Paso 2: Obtener el ID de su sitio en Fathom
- En Fathom, vaya a Sitios.
- Encuentre el sitio que desea importar. El ID es el breve código alfanumérico que aparece debajo del nombre del sitio (p. ej.
ABCDE). También puede encontrarlo en la URL:app.usefathom.com/sites/ABCDE/...
Paso 3: Importar en Zenovay
- Abra el sitio web que desea importar, luego abra su configuración y seleccione la pestaña Import.
- En el selector de origen, elija el mosaico Fathom Analytics.
- Pegue su clave API y el ID de su sitio en Fathom.
- Haga clic en Conectar y espere a que se complete la barra de progreso.
La importación se ejecuta en segundo plano. Puede salir y volver; el estado le estará esperando en la pestaña Import, junto con el historial de importaciones.
Paso 4: Revocar la clave API tras la importación
Cuando la importación finalice con éxito, vuelva a Fathom → Cuenta → API y elimine o revoque la clave creada. Zenovay no la necesita después de la importación, y revocarla limita la exposición si la clave llegara a ser comprometida.
Verificar su importación
Cuando la importación finalice, repase esta breve checklist para confirmar que los datos llegaron correctamente.
- Abra cualquier vista de analítica en su panel (por ejemplo, páginas vistas de los últimos 90 días). Los datos importados aparecen al instante, combinados con los datos nativos ya recopilados.
- Verifique 3 días al azar contra su panel de Fathom. Espere ±5 % en páginas vistas y ±3 % en visitantes únicos — Fathom y Zenovay desduplican visitantes de manera diferente, por lo que una pequeña diferencia es normal.
- Las filas importadas están etiquetadas en la base de datos con
imported_from='fathom', por lo que se sitúan junto a (no sobre) sus datos nativos de Zenovay. La pestaña Import muestra cada importación completada y el rango de fechas que cubrió. - Reimporte el mismo período para confirmar la idempotencia. El recuento de filas debe permanecer igual — los duplicados son imposibles porque cada día está codificado de forma única por sitio a nivel de base de datos.
- Una vez satisfecho, revoque la clave API de Fathom (paso 4 arriba) si aún no lo ha hecho.
Si algún chequeo no cuadra, escriba a [email protected] con la fecha de importación y qué días se ven mal. Podemos corregir manualmente los días individuales.
Solución de problemas
Mensaje «Disponible en Pro»
El Fathom Importer requiere un plan de pago. Actualizar plan →
«Clave API no válida»
Asegúrese de haber copiado la clave completa desde Fathom — solo se muestra en el momento de la creación. Si ya no puede verla, elimine la antigua y cree una nueva. La clave debe tener permiso de Solo lectura o superior.
«ID de sitio no encontrado»
Verifique el ID en Fathom → Sitios. Es un breve código alfanumérico en mayúsculas. Si está usando la URL del panel para encontrarlo, extraiga solo la parte del código (p. ej. ABCDE de app.usefathom.com/sites/ABCDE/). Asegúrese de que la clave API tiene acceso a ese sitio específico.
«Sin datos devueltos»
Confirme que:
- Los últimos 90 días se superponen con el período en que su sitio de Fathom estaba activamente siendo rastreado.
- El ID de sitio coincide con el sitio que rastreó — no otro sitio de Fathom en su cuenta.
- La retención de datos de su cuenta de Fathom incluye los últimos 90 días.
«Error de autenticación»
La clave API puede haber sido eliminada o haber caducado. Cree una nueva clave de solo lectura en Fathom y vuelva a intentarlo.
«Importación expirada»
Las ventanas muy grandes pueden llevar tiempo. Zenovay reintenta automáticamente. Si sigue agotando el tiempo, reintente la importación — volver a ejecutar un rango superpuesto es seguro porque cada día está codificado de forma única por sitio.
Preguntas frecuentes
¿Sobrescribirá mis datos nativos de Zenovay?
No. Las filas importadas están etiquetadas con imported_from='fathom'. Se almacenan junto a (no sobre) los datos nativos, por lo que sus análisis recopilados por Zenovay permanecen intactos.
¿Puedo reimportar? Sí, cuando quiera. Reimportar sobrescribe limpiamente el mismo rango de fechas — sin duplicados, sin filas huérfanas.
¿Por qué debo revocar la clave API tras la importación? Las claves API de Fathom son persistentes. Como Zenovay solo necesita la clave para la importación única, revocarla después es una buena práctica de seguridad — no debe dejar una clave activa después de que ya no sea necesaria.
¿Zenovay almacena mi clave API de Fathom? No. Zenovay usa la clave solo durante la solicitud de importación y no la almacena después. Después de la importación, revóquela en Fathom para que no pueda ser utilizada de nuevo.
¿Qué zona horaria usan los totales diarios? Fathom almacena datos en UTC. Las filas importadas usan fechas UTC, que coinciden con el panel de Fathom.
¿Verá Zenovay los datos personales de mis visitantes? No. La API de Fathom devuelve solo estadísticas agregadas. Ningún registro de visitante individual, IP o identificador de usuario se transfiere a Zenovay.
¿Afecta esto a mis datos de Fathom? No. El importador es de solo lectura. Zenovay nunca escribe en su cuenta de Fathom.
¿Puedo importar objetivos de Fathom? No en V1. Importamos totales agregados diarios para páginas vistas y visitantes. Los datos de objetivos / conversiones están en la hoja de ruta para una versión futura.