Aller au contenu principal
Docs reporting
Use case GAM REST + Analytics link

Seulement si le lien GAM est actif

Champs Analytics liés dans GAM REST

Utilisez les champs Google Analytics que Google Ad Manager expose dans les rapports HISTORICAL quand la liaison est active côté GAM.

Prompt utilisateur

"Dans GAM REST, si les champs Analytics liés sont disponibles, montre les 30 derniers jours par DATE, PAGE_PATH et PAGE_TITLE_AND_SCREEN_NAME. Inclue SESSIONS, ACTIVE_USERS, GOOGLE_ANALYTICS_VIEWS et GOOGLE_ANALYTICS_REVENUE. Si un champ est indisponible, nomme-le et continue avec les champs GAM restants."

Résultat attendu

Un rapport GAM REST qui explique le contexte page et session avec des champs retournés par Google Ad Manager, sans appel GA4 Data API.

Workflow agent

  1. 01

    Vérifier get_report_dimensions et get_report_metrics pour les champs REST compatibles HISTORICAL.

  2. 02

    Exécuter run_custom_report avec api='rest' et report_type='HISTORICAL'.

  3. 03

    Expliquer les champs liés manquants ou vides comme un sujet de liaison ou de disponibilité dans GAM, pas comme un connecteur GA4 OrbiAds.

Fonctions MCP

Appel MCP parent montré avec l'action reporting.

FonctionCoûtUsage
reporting(action="get_report_dimensions")0 crVérifie les dimensions GAM REST.
reporting(action="get_report_metrics")0 crVérifie les métriques Analytics liées exposées par GAM.
reporting(action="run_custom_report")0.5 crExécute le rapport GAM REST HISTORICAL.

Payload JSON

{
  "tool": "reporting",
  "arguments": {
    "action": "run_custom_report",
    "params": {
      "api": "rest",
      "report_type": "HISTORICAL",
      "date_range_type": "LAST_30_DAYS",
      "dimensions": [
        "DATE",
        "PAGE_PATH",
        "PAGE_TITLE_AND_SCREEN_NAME"
      ],
      "metrics": [
        "SESSIONS",
        "ACTIVE_USERS",
        "GOOGLE_ANALYTICS_VIEWS",
        "GOOGLE_ANALYTICS_REVENUE"
      ]
    }
  }
}

Sortie représentative

  • DATE=2026-06-08 | PAGE_PATH=/sports/live | SESSIONS=18 420 | GOOGLE_ANALYTICS_REVENUE=642,80 EUR.
  • PAGE_TITLE_AND_SCREEN_NAME=Live scores | ACTIVE_USERS=12 940 | GOOGLE_ANALYTICS_VIEWS=31 220.
  • Note: PAGE_PATH est un champ Analytics lié exposé par GAM REST; aucun rapport GA4 n'a été interrogé.
Dimensions
NameSourceDescription
DATEGAMJour du rapport
PAGE_PATHGAMPage path Analytics lié exposé par GAM
PAGE_TITLE_AND_SCREEN_NAMEGAMTitre page / screen name Analytics lié exposé par GAM
Métriques
NameSourceDescription
SESSIONSGAMSessions exposées dans GAM reporting
ACTIVE_USERSGAMUtilisateurs actifs exposés dans GAM reporting
GOOGLE_ANALYTICS_VIEWSGAMViews jointes dans GAM reporting
GOOGLE_ANALYTICS_REVENUEGAMRevenu Analytics joint dans GAM reporting

Limites

  • La liaison Analytics doit déjà être active et visible dans le reporting Google Ad Manager.
  • OrbiAds n'appelle pas GA4 Data API ici et ne demande pas de GA4 property ID.
  • Les coûts campagne Google Ads, bids, keywords et clics natifs ne sont pas disponibles dans ce workflow.
  • Utiliser get_report_result pour relire le résultat complet en cache si la réponse inline est tronquée.
Ce sont des colonnes de rapport GAM dont les définitions mentionnent Google Analytics. OrbiAds appelle toujours GAM REST uniquement.
Lire le guide Academy

Utilisez le guide éditorial pour cadrer l'audience, puis revenez ici pour les actions MCP, champs et payloads exacts.

Lire le guide Academy
Références champs