Aller au contenu principal
Reporting GAM REST

Utiliser les champs Analytics, AdSense et Ad Exchange lies via GAM REST

OrbiAds ne se connecte pas a GA4 ni a Google Ads pour ce workflow. L assistant utilise uniquement les champs que Google Ad Manager retourne en reporting REST quand le lien ou la source est actif dans GAM.

OA
OrbiAds Engineering
Publie le 9 juin 2026 - 7 min

Commencer par la vraie limite

L outil MCP reste dans run_custom_report avec api="rest" et report_type="HISTORICAL". Il n y a pas de GA4 property ID, Google Ads account ID, spend import, donnees de bid ou rapport keyword dans ce cas d usage.

Si PAGE_PATH, SESSIONS, ADSENSE_REVENUE ou AD_EXCHANGE_REVENUE manque, la bonne explication est un sujet de lien ou de disponibilite data dans GAM. La reponse ne doit pas laisser croire a un connecteur GA4 ou Google Ads separe.

  • Actions autorisees : get_report_dimensions, get_report_metrics, run_custom_report, get_report_result.
  • Scope requis : le compte Google doit etre autorise pour le reporting Google Ad Manager.
  • Condition requise : le lien Analytics ou la source demande doit deja etre actif cote GAM.

Champs Analytics si le lien GAM est actif

Demandez d abord a l assistant de verifier le catalogue de champs, puis de lancer un rapport historique avec DATE, PAGE_PATH et PAGE_TITLE_AND_SCREEN_NAME. Les metrics utiles sont SESSIONS, ACTIVE_USERS, GOOGLE_ANALYTICS_VIEWS et GOOGLE_ANALYTICS_REVENUE.

Une vraie ligne de sortie doit ressembler a du reporting : /news/live | 2026-06-08 | 18 420 sessions | 22 814 views | 1 284 EUR revenue Analytics.

  • Prompt : "Avec GAM REST uniquement, montre les page paths avec sessions et revenue Analytics sur les 30 derniers jours."
  • Dimensions payload : dimensions=["DATE","PAGE_PATH","PAGE_TITLE_AND_SCREEN_NAME"].
  • Metrics payload : metrics=["SESSIONS","ACTIVE_USERS","GOOGLE_ANALYTICS_VIEWS","GOOGLE_ANALYTICS_REVENUE"].

Champs demande AdSense et Ad Exchange

Le meme schema fonctionne pour la demande quand GAM expose les champs de source. Utilisez DEMAND_CHANNEL_NAME avec les metrics AdSense et Ad Exchange pour separer les revenus sans appeler Google Ads API.

Une ligne utile : Ad Exchange | Sports/Home | 244 180 impressions | 942 EUR revenue | 3,86 EUR average eCPM. Si l utilisateur demande spend Google Ads, CPC, bids, keywords ou clics natifs, repondre que ce workflow GAM REST ne fournit pas ces champs.

  • Prompt : "Compare AdSense et Ad Exchange par ad unit sur les 7 derniers jours via GAM REST."
  • Dimensions payload : dimensions=["DATE","AD_UNIT_NAME","DEMAND_CHANNEL_NAME"].
  • Metrics payload : metrics=["ADSENSE_IMPRESSIONS","ADSENSE_REVENUE","AD_EXCHANGE_IMPRESSIONS","AD_EXCHANGE_REVENUE","AD_EXCHANGE_AVERAGE_ECPM"].

Garde-fou de skill a personnaliser

Ajoutez ce garde-fou a Claude, Codex ou un autre coworker MCP : "Utilise uniquement les champs de reporting GAM REST. Valide les noms de champs avec le catalogue. Si un champ lie est indisponible, explique que le lien ou la source n est peut-etre pas actif dans Google Ad Manager."

Cela garde la reponse precise pour AdOps : l assistant peut produire un compte rendu journalier, un diagnostic d invendus ou une comparaison de sources demande sans halluciner une integration GA4 Data API ou Google Ads API.

  • Bonne note finale : Ce sont des champs lies GAM REST ; aucun appel GA4 Data API ni Google Ads API.
  • Bonne note d echec : PAGE_PATH n est pas disponible dans le catalogue de ce reseau ; verifier si le lien Analytics est actif dans GAM.
  • Bonne prochaine etape : renvoyer vers les catalogues dimensions et metrics avant de changer le prompt.