Aller au contenu
Lire les chiffres/Lire le fil de l'euro

Lire le fil de l'euro

Donne le fil de l'euro d'un budget à un jour donné : de l'euro dépensé au revenu signé, sur les mêmes mois.

Dépensé, leads, SQO, deals gagnés, signé, CAC et signé par euro, au total et par canal. Les leads et les SQO demandent aussi le droit de lire le funnel. Les deals gagnés par canal demandent celui de lire le rendement par canal.

Appel

RepèreValeur
AdressePOST /api/v1/tools/get_euro_thread
RéponseSous data.
Nom de l'outilget_euro_thread
Droit demandéLire le détail par canal, fournisseur et contrat (spendDetail.read)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, DAF, Lecteur / auditeur
Par MCPOui, en lecture.

Paramètres

Les paramètres sont dans le corps de la requête, en JSON.

ParamètreRequisType et limitesÀ quoi il sert
budgetIdouitexte, non videLe budget. list_budgets donne les identifiants.
asOfouidate, AAAA-MM-JJLe jour de lecture. En général, aujourd'hui.

Exemple

curl -X POST "$MARVESTO_URL/api/v1/tools/get_euro_thread" \
  -H "x-api-key: $MARVESTO_API_KEY" \
  -H "content-type: application/json" \
  -d @corps.json

Le fichier corps.json :

{
  "budgetId": "BUDGET_ID",
  "asOf": "2026-11-12"
}

Réponse

Ce que l'écran affiche au membre de la clé : chaque valeur avec son statut, une valeur indisponible à null, et ce qui lui est masqué dit avec sa raison.

Refus

Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.