Analítica
Fathom Analytics en tu producto y en tus agentes de IA, con una API
El toolkit de Fathom Analytics gestiona sitios, lista los eventos rastreados, arma informes de agregación personalizados sobre pageviews o eventos, muestra los visitantes actuales y maneja hitos. Con Connect, un producto o agente de IA lee las métricas del cliente sin construir la integración con Fathom.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/fathom_create_site/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Fathom Analytics.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Fathom Analytics. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Fathom Analytics.
Informes de tráfico en tu app
Arma informes personalizados agrupados por período, pathname, referrer_source o utm_campaign y muéstralos en tu propio dashboard.
Widget de visitantes en vivo
Muestra cuántas personas están ahora en el sitio del cliente, con las páginas y referidos principales cuando pidas la vista detallada.
Marcar fechas de campañas
Crea un hito cuando se lance una campaña para que la fecha aparezca en los informes de Fathom, y actualízalo o elimínalo después.
Tools
11 tools de Fathom Analytics
- Listar sitiosGETLista los sitios de la cuenta con id, name, sharing y timezone, del más antiguo al más nuevo. El id es el código del script de seguimiento que piden las demás herramientas. Mientras has_more sea true, envía el id del último sitio como starting_after.
- Obtener sitioGETDevuelve un sitio con su nombre, sharing, zona horaria y fecha de creación.
- Crear sitioPOSTCrea un sitio y lo devuelve con el id para poner en el script de seguimiento. Necesita un token con el permiso Admin.
- Actualizar sitioPOSTModifica un sitio. Solo cambian los campos enviados.
- Listar eventosGETLista todos los nombres de evento que el sitio ha rastreado, con su moneda, ordenados por nombre. Los informes de un evento usan el nombre; el id solo sirve como cursor de página. Mientras has_more sea true, envía el id del último evento como starting_after.
- Obtener agregaciónGETArma un informe personalizado sobre los pageviews de un sitio o sobre un evento: totales, o agrupados por período y por campos como pathname, referrer_source o utm_campaign. Los números vuelven como texto y no hay paginación: los informes agrupados devuelven hasta 500 filas, salvo que limit indique otro valor.
- Obtener visitantes actualesGETDevuelve cuántas personas están en el sitio ahora mismo. Con detailed, también las 150 páginas y los 150 referidos principales.
- Listar hitosGETLista los hitos del sitio, las fechas marcadas en sus informes, del más antiguo al más nuevo. Mientras has_more sea true, envía el id del último hito como starting_after.
- Crear hitoPOSTMarca una fecha en los informes del sitio, como el lanzamiento de una campaña.
- Actualizar hitoPOSTModifica un hito. Envía name y milestone_date, incluso el que no cambia.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Fathom Analytics
¿Necesito implementar la API de Fathom Analytics?
No. Connect ya trae 11 tools de Fathom Analytics descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Fathom Analytics?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
