Analítica
Mixpanel en tu producto y en tus agentes de IA, con una API
El toolkit de Mixpanel cubre proyectos, informes guardados de Insights y Funnels, nombres y propiedades de eventos, conteos de eventos, retención, cohortes, perfiles de usuarios y anotaciones, en residencia de datos de EE. UU. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda las credenciales de la cuenta de servicio y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/mixpanel_list_cohorts/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"project_id": 1
}
}Cómo funciona
Del cliente conectado a la primera llamada a Mixpanel.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Mixpanel. 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 Mixpanel.
Integra analítica de producto
Un SaaS lee un informe guardado o conteos de eventos del proyecto de Mixpanel del cliente y los muestra en su propio panel.
Responde preguntas sobre uso
Un agente de IA lista los nombres de eventos y luego obtiene conteos de eventos o un informe de retención de un periodo para responder una pregunta sobre uso.
Marca lanzamientos en los gráficos
Una herramienta de releases crea una anotación el día de una campaña o lanzamiento y la actualiza o elimina después.
Tools
12 tools de Mixpanel
- Listar proyectosGETDevuelve, en results, la propia cuenta de servicio y las organizaciones, proyectos y workspaces a los que tiene acceso, cada uno indexado por id. Las claves de results.projects son el project_id que piden las otras herramientas, y results.workspaces trae el workspace_id de los proyectos que usan data views.
- Obtener informe guardadoGETDevuelve los datos de un informe guardado de Insights o Funnels, calculado con el rango de fechas y los filtros guardados en el informe. Cuenta para el límite de la Query API de 60 consultas por hora.
- Listar nombres de eventosGETLista los nombres de los eventos más comunes del proyecto en los últimos 31 días, para usarlos como argumentos event de las otras herramientas. Cuenta para el límite de la Query API de 60 consultas por hora.
- Listar propiedades de eventoGETLista los nombres de propiedad más comunes de un evento, para construir las expresiones on y where de Obtener informe de retención. Cuenta para el límite de la Query API de 60 consultas por hora.
- Obtener conteos de eventosGETDevuelve, periodo a periodo, el conteo total, único o promedio de uno o más eventos entre dos fechas. Cuenta para el límite de la Query API de 60 consultas por hora.
- Obtener informe de retenciónGETDevuelve, para cada fecha de cohorte, cuántos usuarios entraron en la cohorte (first) y cuántos volvieron en cada intervalo posterior (counts). Cuenta para el límite de la Query API de 60 consultas por hora.
- Listar cohortesPOSTLista las cohortes guardadas del proyecto con id, nombre, número de usuarios, descripción, fecha de creación y visibilidad. Cuenta para el límite de la Query API de 60 consultas por hora.
- Buscar perfilesPOSTDevuelve los perfiles de usuario que coinciden con una expresión where, una cohorte o una lista de distinct_ids, con sus propiedades. Una página trae hasta page_size perfiles: para la siguiente, repite la llamada con los mismos filtros, el session_id de la respuesta y page más uno. Cuenta para el límite de la Query API de 60 consultas por hora.
- Listar anotacionesGETLista las anotaciones del proyecto, las notas fijadas en una fecha en los gráficos, con id, fecha, descripción, autor y tags.
- Crear anotaciónPOSTCrea una anotación, una nota que se muestra en una fecha en los gráficos del proyecto, como el lanzamiento de una campaña. La cuenta de servicio necesita el rol Analyst o superior en el proyecto.
Usuario y contraseña
Tu cliente ingresa las credenciales de la app en una pantalla de Connect, o tu sistema las envía con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Mixpanel
¿Necesito implementar la API de Mixpanel?
No. Connect ya trae 12 tools de Mixpanel 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 Mixpanel?
Con el modo que acepta el toolkit: Usuario y contraseña. 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
