Reporting GAM & GA4

26 endpoints REST et 29 outils MCP pour créer, exécuter et gérer des rapports GAM. Inclut les templates réutilisables, les bridge links et l'intégration GA4.

Endpoints REST

Méthode	Path	Description	Crédits
POST	/reports/custom	Exécuter un rapport custom (dimensions + métriques libres)	0.5
POST	/reports/inventory	Exécuter un rapport d'inventaire	0.5
GET	/reports/available-dimensions	Lister les 79 dimensions disponibles	0
GET	/reports/available-metrics	Lister les 68 métriques disponibles	0
GET	/reports/available-date-ranges	Lister les plages de dates relatives	0
GET	/reports/templates	Lister les templates (builtin + custom)	0
POST	/reports/templates	Créer un template personnalisé	0
POST	/reports/templates/{id}/run	Exécuter un template	0.5
PUT	/reports/templates/{id}	Modifier un template	0
DELETE	/reports/templates/{id}	Supprimer un template	0
POST	/reports/templates/{id}/clone	Dupliquer un template	0
POST	/reports/gam-reports/{id}/link	Lier un rapport GAM à un template	0
POST	/reports/gam-reports/{id}/clone-to-template	Importer un rapport GAM comme template	0
POST	/reports/templates/{id}/publish-to-gam	Publier un template vers GAM	0.5
PATCH	/reports/links/{id}/sync	Synchroniser un bridge link	0
GET	/reports/links/{id}/diff	Voir le diff d'un bridge link	0
GET	/reports/executions	Historique des exécutions	0

Outils MCP

Outil	Description	Crédits
run_custom_report	Exécuter un rapport avec dimensions/métriques/filtres libres	0.5
fetch_delivery_report	Rapport de livraison pour un job déployé	0.5
fetch_inventory_report	Rapport d'inventaire par ad unit	0.5
run_report_from_template	Exécuter un template sauvegardé	0.5
export_report_csv	Exporter les résultats en CSV	0.5
get_report_result	Récupérer un résultat en cache (par UUID)	0
get_report_dimensions	Catalogue des 79 dimensions	0
get_report_metrics	Catalogue des 68 métriques	0
get_report_date_ranges	Plages de dates disponibles	0
run_pql_query	Exécuter une requête PQL (SOAP)	0.5
run_ga_report	Exécuter un rapport GA4 Data API	0.5
get_standalone_forecast	Prévision d'inventaire disponible	0

Exemples

Rapport custom via MCP

{
  "tool": "run_custom_report",
  "arguments": {
    "dimensions": ["ADVERTISER_NAME", "DATE"],
    "metrics": ["AD_SERVER_IMPRESSIONS", "AD_SERVER_CTR"],
    "date_range": "LAST_30_DAYS",
    "filters": [
      {"dimension": "COUNTRY_NAME", "operator": "EQ", "values": ["France"]}
    ]
  }
}

Rapport via CLI

orbiads reporting run \
  --dimensions ADVERTISER_NAME,DATE \
  --metrics AD_SERVER_IMPRESSIONS,AD_SERVER_CTR \
  --date-range LAST_30_DAYS

Notes

• Les résultats sont mis en cache Firestore pendant 30 jours avec un UUID unique.
• Le polling LRO effectue jusqu'à 20 tentatives avec un intervalle de 5 secondes.
• Les templates builtin sont en lecture seule ; les templates custom sont modifiables et supprimables.
• Les bridge links détectent automatiquement les dérives de configuration (drift) entre OrbiAds et GAM.

Voir la page feature Toutes les docs features