Analytics
Fathom Analytics no seu produto e nos seus agentes de IA, por uma API
O toolkit do Fathom Analytics gerencia sites, lista os eventos rastreados, monta relatórios de agregação personalizados sobre pageviews ou eventos, mostra os visitantes atuais e cuida dos marcos. Pelo Connect, um produto ou agente de IA lê as métricas do cliente sem construir a integração com o Fathom.
15 dias para testar. Sem cartão 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>"
}
}Como funciona
Do cliente conectado à primeira chamada no Fathom Analytics.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Fathom Analytics. 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 Fathom Analytics.
Relatórios de tráfego no seu app
Monte relatórios personalizados agrupados por período, pathname, referrer_source ou utm_campaign e mostre no seu próprio dashboard.
Widget de visitantes ao vivo
Mostre quantas pessoas estão no site do cliente agora, com as páginas e origens principais quando pedir a visão detalhada.
Marcar datas de campanhas
Crie um marco quando uma campanha for lançada para a data aparecer nos relatórios do Fathom, e atualize ou exclua depois.
Tools
11 tools do Fathom Analytics
- Listar sitesGETLista os sites da conta com id, name, sharing e timezone, do mais antigo ao mais novo. O id é o código do script de rastreamento que as outras ferramentas pedem. Enquanto has_more for true, envie o id do último site como starting_after.
- Obter siteGETRetorna um site com nome, sharing, fuso horário e data de criação.
- Criar sitePOSTCria um site e o retorna com o id para colocar no script de rastreamento. Precisa de um token com a permissão Admin.
- Atualizar sitePOSTAltera um site. Só os campos enviados mudam.
- Listar eventosGETLista todos os nomes de evento que o site rastreou, com a moeda de cada um, ordenados por nome. Os relatórios de um evento usam o nome; o id só funciona como cursor de página. Enquanto has_more for true, envie o id do último evento como starting_after.
- Obter agregaçãoGETMonta um relatório personalizado sobre os pageviews de um site ou sobre um evento: totais, ou agrupados por período e por campos como pathname, referrer_source ou utm_campaign. Os números voltam como texto e não há paginação: relatórios agrupados retornam até 500 linhas, a menos que limit diga outro valor.
- Obter visitantes atuaisGETRetorna quantas pessoas estão no site agora. Com detailed, também as 150 páginas e as 150 origens principais.
- Listar marcosGETLista os marcos do site, as datas marcadas nos relatórios, do mais antigo ao mais novo. Enquanto has_more for true, envie o id do último marco como starting_after.
- Criar marcoPOSTMarca uma data nos relatórios do site, como o lançamento de uma campanha.
- Atualizar marcoPOSTAltera um marco. Envie name e milestone_date, mesmo o que não muda.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
Perguntas sobre o toolkit do Fathom Analytics
Preciso implementar a API do Fathom Analytics?
Não. O Connect já traz 11 tools do Fathom Analytics 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 Fathom Analytics?
Pelo modo que o toolkit aceita: Chave de API. 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.
