Analytics
Fathom Analytics dans votre produit et vos agents IA, via une API
Le toolkit Fathom Analytics gère les sites, liste les événements suivis, construit des rapports d'agrégation personnalisés sur les pages vues ou les événements, affiche les visiteurs actuels et gère les jalons. Avec Connect, un produit ou un agent IA lit les statistiques du client sans construire l'intégration Fathom.
15 jours d'essai. Sans carte bancaire.
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>"
}
}Fonctionnement
Du client connecté au premier appel à Fathom Analytics.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Fathom Analytics. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Fathom Analytics.
Rapports de trafic dans votre app
Construisez des rapports personnalisés regroupés par période, pathname, referrer_source ou utm_campaign et affichez-les dans votre propre dashboard.
Widget de visiteurs en direct
Affichez combien de personnes sont sur le site du client en ce moment, avec les pages et les sources principales quand vous demandez la vue détaillée.
Marquer les dates de campagne
Créez un jalon au lancement d'une campagne pour que la date apparaisse dans les rapports Fathom, puis mettez-le à jour ou supprimez-le.
Tools
11 tools Fathom Analytics
- Lister les sitesGETListe les sites du compte avec id, name, sharing et timezone, du plus ancien au plus récent. L'id est le code du script de suivi que demandent les autres outils. Tant que has_more est true, envoyez l'id du dernier site comme starting_after.
- Obtenir un siteGETRenvoie un site avec son nom, sharing, fuseau horaire et date de création.
- Créer un sitePOSTCrée un site et le renvoie avec l'id à mettre dans le script de suivi. Nécessite un jeton avec la permission Admin.
- Mettre à jour un sitePOSTModifie un site. Seuls les champs envoyés changent.
- Lister les événementsGETListe tous les noms d'événements que le site a suivis, avec leur devise, triés par nom. Les rapports sur un événement utilisent son nom ; l'id ne sert que de curseur de page. Tant que has_more est true, envoyez l'id du dernier événement comme starting_after.
- Obtenir une agrégationGETConstruit un rapport personnalisé sur les pages vues d'un site ou sur un événement : totaux, ou regroupés par période et par champs comme pathname, referrer_source ou utm_campaign. Les nombres reviennent sous forme de texte et il n'y a pas de pagination : les rapports regroupés renvoient jusqu'à 500 lignes, sauf si limit indique autre chose.
- Obtenir les visiteurs actuelsGETRenvoie combien de personnes sont sur le site en ce moment. Avec detailed, aussi les 150 pages et les 150 sources principales.
- Lister les jalonsGETListe les jalons du site, les dates marquées sur ses rapports, du plus ancien au plus récent. Tant que has_more est true, envoyez l'id du dernier jalon comme starting_after.
- Créer un jalonPOSTMarque une date sur les rapports du site, comme le lancement d'une campagne.
- Mettre à jour un jalonPOSTModifie un jalon. Envoyez name et milestone_date, même celui qui ne change pas.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Fathom Analytics
Dois-je intégrer l'API Fathom Analytics moi-même ?
Non. Connect fournit 11 tools Fathom Analytics décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Fathom Analytics ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
