Aller au contenu principal
Docs reporting
Caso d'uso GAM REST + Analytics link

Solo se il link GAM e attivo

Campi Analytics collegati in GAM REST

Usa i campi Google Analytics che Google Ad Manager espone nei report HISTORICAL quando il collegamento e attivo in GAM.

Prompt utente

"In GAM REST, se i campi Analytics collegati sono disponibili, mostra gli ultimi 30 giorni per DATE, PAGE_PATH e PAGE_TITLE_AND_SCREEN_NAME. Includi SESSIONS, ACTIVE_USERS, GOOGLE_ANALYTICS_VIEWS e GOOGLE_ANALYTICS_REVENUE. Se un campo non e disponibile, nominalo e continua con i campi GAM restanti."

Risultato atteso

Un report GAM REST che spiega contesto pagina e sessione con campi restituiti da Google Ad Manager, senza chiamata GA4 Data API.

Flusso agente

  1. 01

    Controllare get_report_dimensions e get_report_metrics per campi REST compatibili con HISTORICAL.

  2. 02

    Eseguire run_custom_report con api='rest' e report_type='HISTORICAL'.

  3. 03

    Spiegare campi collegati mancanti o vuoti come disponibilita link/dati in GAM, non come connettore GA4 OrbiAds.

Funzioni MCP

Chiamata MCP parent mostrata con l'azione reporting.

FunzioneCostoUso
reporting(action="get_report_dimensions")0 crControlla dimensioni GAM REST.
reporting(action="get_report_metrics")0 crControlla metriche Analytics collegate esposte da GAM.
reporting(action="run_custom_report")0.5 crEsegue il report 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"
      ]
    }
  }
}

Output rappresentativo

  • DATE=2026-06-08 | PAGE_PATH=/sports/live | SESSIONS=18.420 | GOOGLE_ANALYTICS_REVENUE=EUR 642,80.
  • PAGE_TITLE_AND_SCREEN_NAME=Live scores | ACTIVE_USERS=12.940 | GOOGLE_ANALYTICS_VIEWS=31.220.
  • Nota: PAGE_PATH e un campo Analytics collegato esposto da GAM REST; non e stato interrogato GA4.

Dimensioni e metriche

Dimensioni
NameFonteDescrizione
DATEGAMGiorno report
PAGE_PATHGAMPage path Analytics collegato esposto da GAM
PAGE_TITLE_AND_SCREEN_NAMEGAMTitolo pagina / screen name Analytics collegato esposto da GAM
Metriche
NameFonteDescrizione
SESSIONSGAMSessioni esposte in GAM reporting
ACTIVE_USERSGAMUtenti attivi esposti in GAM reporting
GOOGLE_ANALYTICS_VIEWSGAMViews unite in GAM reporting
GOOGLE_ANALYTICS_REVENUEGAMRevenue Analytics unito in GAM reporting

Limiti

  • Il link Analytics deve essere gia attivo e visibile nel reporting Google Ad Manager.
  • OrbiAds non chiama GA4 Data API qui e non richiede GA4 property ID.
  • Costi campagna Google Ads, bids, keywords e click nativi non sono disponibili in questo workflow.
  • Usare get_report_result per leggere il risultato completo in cache quando la risposta inline e troncata.
Sono colonne di report GAM le cui definizioni menzionano Google Analytics. OrbiAds chiama ancora solo GAM REST.
Leggi la guida Academy

Usa la guida editoriale per il contesto audience, poi torna qui per azioni MCP, campi e payload esatti.

Leggi la guida Academy
Reference campi