Analytics
Mixpanel no seu produto e nos seus agentes de IA, por uma API
O toolkit do Mixpanel cobre projetos, relatórios salvos de Insights e Funnels, nomes e propriedades de eventos, contagens de eventos, retenção, coortes, perfis de usuários e anotações, na residência de dados dos EUA. Pelo Connect, seu produto ou agente de IA chama tudo por um só endpoint, enquanto o Connect guarda as credenciais da conta de serviço e registra cada execução.
15 dias para testar. Sem cartão 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
}
}Como funciona
Do cliente conectado à primeira chamada no Mixpanel.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Mixpanel. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Mixpanel.
Embuta analytics de produto
Um SaaS lê um relatório salvo ou contagens de eventos do projeto Mixpanel do cliente e os mostra dentro do próprio painel.
Responda perguntas sobre uso
Um agente de IA lista os nomes de eventos e depois obtém contagens de eventos ou um relatório de retenção de um período para responder a uma pergunta sobre uso.
Marque lançamentos nos gráficos
Uma ferramenta de releases cria uma anotação no dia de uma campanha ou lançamento e a atualiza ou exclui depois.
Tools
12 tools do Mixpanel
- Listar projetosGETRetorna, em results, a própria conta de serviço e as organizações, projetos e workspaces a que ela tem acesso, cada um indexado por id. As chaves de results.projects são o project_id que as outras ferramentas pedem, e results.workspaces traz o workspace_id dos projetos que usam data views.
- Obter relatório salvoGETRetorna os dados de um relatório salvo de Insights ou Funnels, calculado com o período e os filtros salvos no relatório. Conta no limite da Query API de 60 consultas por hora.
- Listar nomes de eventosGETLista os nomes dos eventos mais comuns do projeto nos últimos 31 dias, para usar como argumentos event das outras ferramentas. Conta no limite da Query API de 60 consultas por hora.
- Listar propriedades de eventoGETLista os nomes de propriedade mais comuns de um evento, para montar as expressões on e where de Obter relatório de retenção. Conta no limite da Query API de 60 consultas por hora.
- Obter contagens de eventosGETRetorna, período a período, a contagem total, única ou média de um ou mais eventos entre duas datas. Conta no limite da Query API de 60 consultas por hora.
- Obter relatório de retençãoGETRetorna, para cada data de coorte, quantos usuários entraram na coorte (first) e quantos voltaram em cada intervalo depois dela (counts). Conta no limite da Query API de 60 consultas por hora.
- Listar coortesPOSTLista as coortes salvas do projeto com id, nome, número de usuários, descrição, data de criação e visibilidade. Conta no limite da Query API de 60 consultas por hora.
- Buscar perfisPOSTRetorna os perfis de usuário que correspondem a uma expressão where, a uma coorte ou a uma lista de distinct_ids, com suas propriedades. Uma página traz até page_size perfis: para a próxima, repita a chamada com os mesmos filtros, o session_id da resposta e page mais um. Conta no limite da Query API de 60 consultas por hora.
- Listar anotaçõesGETLista as anotações do projeto, as notas fixadas em uma data nos gráficos, com id, data, descrição, autor e tags.
- Criar anotaçãoPOSTCria uma anotação, uma nota exibida em uma data nos gráficos do projeto, como o lançamento de uma campanha. A conta de serviço precisa do papel Analyst ou superior no projeto.
Usuário e senha
O cliente informa as credenciais do app numa tela do Connect, ou o seu sistema as envia por POST /api/customer-toolkits, sem tela.
Perguntas sobre o toolkit do Mixpanel
Preciso implementar a API do Mixpanel?
Não. O Connect já traz 12 tools do Mixpanel descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Mixpanel?
Pelo modo que o toolkit aceita: Usuário e senha. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
