Analytics
Baremetrics dans votre produit et vos agents IA, via une API
Le toolkit Baremetrics lit les métriques du compte jour par jour, avec la ventilation par plan et les clients derrière chaque métrique, ainsi que les sources, plans, clients, abonnements et utilisateurs. Il crée et supprime aussi des annotations sur les graphiques. Avec Connect, un produit ou un agent IA accède à ces données sans construire l'intégration Baremetrics.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/baremetrics_create_annotation/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"metric": "<metric>",
"annotation": "<annotation>",
"date": "<date>",
"global": true,
"user_id": "<user_id>"
}
}Fonctionnement
Du client connecté au premier appel à Baremetrics.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Baremetrics. 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 Baremetrics.
Métriques dans votre dashboard
Récupérez mrr, arr, arpu et user_churn sur une période et affichez-les à côté des autres données de votre client.
Expliquer un pic de churn
Laissez un agent IA lister les clients derrière une métrique un jour donné et la ventilation par plan, puis résumer ce qui a changé.
Annoter les lancements
Créez une annotation sur le graphique quand votre produit publie une version ou lance une campagne, pour que la date apparaisse dans les graphiques Baremetrics.
Tools
12 tools Baremetrics
- Lister les sourcesGETListe les sources du compte : chaque fournisseur de paiement connecté, comme Stripe, et l'API Baremetrics elle-même. L'id d'une source est le source_id que prennent les plans, clients et abonnements.
- Obtenir le résumé des métriquesGETRenvoie toutes les métriques du compte pour chaque jour d'une période, comme mrr, arr, arpu, ltv, active_customers, new_customers et user_churn. Les montants sont en centimes.
- Obtenir une métriqueGETRenvoie la valeur d'une métrique pour chaque jour d'une période, chacune avec la valeur de compare_to jours avant et la variation en pourcentage. Les montants sont en centimes, donc un mrr de 6024087 vaut 60 240,87.
- Lister les clients d'une métriqueGETListe, pour chaque jour d'une période, les clients qui composent une métrique, avec la contribution de chacun au MRR en centimes et le plan actuel et précédent. Par exemple, la métrique upgrades renvoie les clients qui ont fait un upgrade sur la période.
- Obtenir une métrique par planGETVentile une métrique par plan pour chaque jour d'une période : chaque valeur vient avec le plan auquel elle appartient. Les montants sont en centimes.
- Lister les plansGETListe les plans d'une source avec name, oid, intervalle de facturation et montants en centimes. La réponse a meta.pagination.has_more ; envoyez page pour lire la page suivante.
- Lister les clientsGETListe les clients d'une source avec oid, e-mail, LTV et MRR actuel en centimes, plans actuels et s'ils sont actifs ou résiliés. La réponse a meta.pagination.has_more ; envoyez page pour lire la page suivante.
- Lister les abonnementsGETListe les abonnements d'une source avec client, plan, quantité, remise et les dates de début et de résiliation en timestamps Unix. La réponse a meta.pagination.has_more ; envoyez page pour lire la page suivante.
- Lister les utilisateursGETListe les utilisateurs du compte Baremetrics avec id, nom, e-mail et s'ils sont administrateurs. L'id est le user_id que prend Create annotation.
- Lister les annotationsGETListe les annotations des graphiques, chacune avec id, métrique, texte, date, si elle s'affiche sur tous les graphiques et l'utilisateur qui l'a ajoutée. La réponse a meta.pagination.has_more ; envoyez page pour lire la page suivante.
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 Baremetrics
Dois-je intégrer l'API Baremetrics moi-même ?
Non. Connect fournit 12 tools Baremetrics 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 Baremetrics ?
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.
