Aller au contenu principal
Docs reporting
Caso d'uso GAM REST + Demand links

Domanda collegata dentro GAM

Campi AdSense e Ad Exchange in GAM REST

Usa metriche AdSense e Ad Exchange che Google Ad Manager espone nei report HISTORICAL quando queste fonti domanda sono collegate e attive.

Prompt utente

"In GAM REST, confronta revenue AdSense e Ad Exchange degli ultimi 7 giorni per DATE, AD_UNIT_NAME e DEMAND_CHANNEL_NAME. Includi ADSENSE_IMPRESSIONS, ADSENSE_REVENUE, AD_EXCHANGE_IMPRESSIONS, AD_EXCHANGE_REVENUE e AD_EXCHANGE_AVERAGE_ECPM."

Risultato atteso

Una lettura delle fonti domanda da GAM REST che separa AdSense e Ad Exchange senza usare Google Ads API.

Flusso agente

  1. 01

    Controllare che le metriche AdSense o Ad Exchange richieste esistano in get_report_metrics per REST/HISTORICAL.

  2. 02

    Eseguire run_custom_report su GAM REST con dimensioni demand-channel.

  3. 03

    Segnalare metriche domanda non disponibili come limiti di collegamento GAM o permessi account.

Funzioni MCP

Chiamata MCP parent mostrata con l'azione reporting.

FunzioneCostoUso
reporting(action="get_report_dimensions")0 crControlla dimensioni domanda GAM.
reporting(action="get_report_metrics")0 crControlla metriche AdSense e Ad Exchange esposte da GAM.
reporting(action="run_custom_report")0.5 crEsegue il report domanda GAM REST.

Payload JSON

{
  "tool": "reporting",
  "arguments": {
    "action": "run_custom_report",
    "params": {
      "api": "rest",
      "report_type": "HISTORICAL",
      "date_range_type": "LAST_7_DAYS",
      "dimensions": [
        "DATE",
        "AD_UNIT_NAME",
        "DEMAND_CHANNEL_NAME"
      ],
      "metrics": [
        "ADSENSE_IMPRESSIONS",
        "ADSENSE_REVENUE",
        "AD_EXCHANGE_IMPRESSIONS",
        "AD_EXCHANGE_REVENUE",
        "AD_EXCHANGE_AVERAGE_ECPM"
      ]
    }
  }
}

Output rappresentativo

  • DATE=2026-06-08 | AD_UNIT_NAME=Sports/Home | DEMAND_CHANNEL_NAME=Ad Exchange | AD_EXCHANGE_REVENUE=EUR 1.284,20.
  • DATE=2026-06-08 | AD_UNIT_NAME=Sports/Home | DEMAND_CHANNEL_NAME=AdSense | ADSENSE_REVENUE=EUR 342,10.
  • Azione: rivedere ad unit dove eCPM Ad Exchange cala mentre le requests GAM restano stabili.

Dimensioni e metriche

Dimensioni
NameFonteDescrizione
DATEGAMGiorno report
AD_UNIT_NAMEGAMPlacement inventario
DEMAND_CHANNEL_NAMEGAMCanale domanda esposto da GAM
Metriche
NameFonteDescrizione
ADSENSE_IMPRESSIONSGAMImpression AdSense in GAM reporting
ADSENSE_REVENUEGAMRevenue AdSense in GAM reporting
AD_EXCHANGE_IMPRESSIONSGAMImpression Ad Exchange in GAM reporting
AD_EXCHANGE_REVENUEGAMRevenue Ad Exchange in GAM reporting
AD_EXCHANGE_AVERAGE_ECPMGAMeCPM medio Ad Exchange in GAM reporting

Limiti

  • Le righe AdSense e Ad Exchange dipendono dalla configurazione GAM publisher e dalla disponibilita della domanda collegata.
  • Non e reporting Google Ads: nessuno spend campagna, keyword, bid o metrica account Google Ads.
  • Usare solo campi restituiti da GAM REST; cambiare campi se il network non ne espone uno.
  • Usare get_report_result per leggere il risultato completo in cache quando la risposta inline e troncata.
AdSense e Ad Exchange sono qui famiglie di reporting GAM; non descriverle come copertura Google Ads API.
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