5 min de lectura

Importador Fathom

Disponible en Pro y superior. El importador Fathom es una herramienta de un solo uso para traer tus últimos 90 días de agregados diarios de Fathom Analytics a Zenovay, de modo que no pierdas el contexto al cambiar.

Qué hace esta herramienta

Lee 90 días de agregados diarios desde Fathom Analytics: visitas, páginas vistas, fuentes principales, páginas principales, países principales, dispositivos, sistemas operativos y navegadores.
Los escribe en la tabla analytics_daily de Zenovay con imported_from='fathom' para que se distingan claramente de los datos nativos de Zenovay.
Idempotente: reimportar el mismo periodo realiza un UPSERT por fecha y sobrescribe limpiamente sin duplicados.

Qué NO hace esta herramienta

No importa sesiones individuales de visitantes.
No importa eventos personalizados, objetivos ni datos en tiempo real.
No sincroniza de forma continua — la V1 es de un solo uso. La sincronización recurrente está en la hoja de ruta.

Requisitos previos

Una cuenta de Zenovay en el plan Pro o superior.
Una cuenta de Fathom Analytics con al menos un sitio.
Una clave API de Fathom de solo lectura (ver más abajo).

Nota de seguridad. La clave API de Fathom proporciona acceso Bearer token a los datos de tu cuenta. Zenovay utiliza tu clave únicamente durante la solicitud de importación y no la almacena de forma permanente. Recomendamos crear una clave API dedicada para esta importación y revocarla en Fathom en cuanto la importación esté completada.

Paso a paso

1. Crear una clave API de solo lectura en Fathom

En Fathom, ve a Configuración → API y crea una nueva clave API. Dale un nombre reconocible (p. ej. zenovay-import-2026-05). Copia la clave — Fathom solo la muestra una vez.

No necesitas asignar permisos especiales; las claves API de Fathom tienen acceso de lectura a las estadísticas de tus sitios de forma predeterminada.

2. Encontrar el ID de sitio en Fathom

En Fathom, abre el sitio que quieres importar y fíjate en la URL — el ID de entidad es el segmento alfanumérico después de /sites/, por ejemplo ABCDE en https://app.usefathom.com/#/sites/ABCDE/. También puedes ir a Configuración → Sitios y copiar el ID que aparece junto al sitio.

3. Abrir la pestaña Importar en Zenovay

Ve a la página de detalle de tu dominio → pestaña Importar. Verás mosaicos de fuentes para Plausible (existente) y Fathom (nuevo).

4. Introducir la clave API y el ID de sitio

Haz clic en el mosaico Fathom → Conectar mediante API e introduce:

Clave API — el Bearer token del paso 1.
ID de sitio — el ID de entidad alfanumérico del paso 2.

5. Lanzar la importación

Haz clic en Importar últimos 90 días. La importación se ejecuta en segundo plano; la interfaz consulta el estado cada dos segundos y muestra una barra de progreso. Una importación de 90 días suele completarse en 30–60 segundos.

6. Revisar

Cuando termine, verás un resumen: filas importadas, rango de fechas y dimensiones encontradas. Los datos importados aparecen inmediatamente en tu panel con el marcador de origen Fathom.

7. Revocar la clave API en Fathom

Una vez confirmada la importación, vuelve a Configuración → API en Fathom y elimina o revoca la clave creada en el paso 1. Zenovay no la necesita de nuevo para el seguimiento nativo posterior.

Resolución de problemas

«Clave API no válida»

Comprueba que has copiado la clave completa sin espacios al inicio o al final. Regenera la clave en Configuración → API en Fathom y pégala de nuevo.

«Sitio no encontrado»

El ID de sitio debe ser el ID de entidad alfanumérico que aparece en la URL de Fathom o en la configuración — no el nombre de visualización ni el dominio del sitio. Confírmalo en Configuración → Sitios.

«Limitación de tasa»

Fathom limita las solicitudes API por clave por minuto. Si ves este error, espera 60 segundos y vuelve a intentarlo. Zenovay reintenta automáticamente tres veces con backoff antes de mostrar este error.

«Importación parcial»

Indica que Fathom ha devuelto menos de 90 días de datos — normalmente porque el sitio tiene menos de 90 días de antigüedad, o porque algunos días no tuvieron tráfico. Verifica por muestreo el rango importado en tu panel.

Los datos difieren ligeramente del panel de Fathom

Fathom y Zenovay cuentan las visitas y filtran los bots de forma ligeramente distinta. Espera pequeñas diferencias. El marcador imported_from='fathom' te permite filtrar para comparar lo equivalente.

Distinguir los datos importados

Cada fila importada lleva imported_from='fathom' en analytics_daily. En la Public Stats API de Zenovay (Pro+) puedes filtrar por el mismo campo. Los datos nativos de Zenovay tienen imported_from=NULL.

Reimportación y eliminación

Volver a ejecutar la importación para el mismo periodo realiza un UPSERT por fecha, por lo que es seguro repetirla (con una clave API válida). Para eliminar los datos de Fathom importados, abre el mosaico Fathom y usa Eliminar datos importados — las filas nativas de Zenovay no se ven afectadas.

Recursos relacionados

¿Necesitas ayuda? Contacta a [email protected] o visita nuestro Centro de ayuda.