Aller au contenu principal
Docs reporting
Caso d'uso Claude + AdOps

Standup delivery quotidiano

Report GAM giornaliero con Claude come coworker

Dai a Claude un prompt ogni mattina per leggere il delivery GAM di ieri, riassumere il pacing e preparare un handoff AdOps compatto.

Prompt utente

"Claude, ogni mattina, recupera la performance GAM di ieri per advertiser, order, line item e ad unit. Evidenzia revenue, CTR, problemi di fill e azioni trafficker prima delle 10:00."

Risultato atteso

Un breve readout quotidiano con totali, anomalie, principali variazioni e un resultId in cache per la tabella completa.

Flusso agente

  1. 01

    Eseguire il report GAM con i soli campi utili alla review del mattino.

  2. 02

    Raggruppare le righe per advertiser e line item, poi segnalare delta di CTR, revenue o delivery.

  3. 03

    Esportare CSV solo quando l'utente chiede la tabella operativa.

Funzioni MCP

Chiamata MCP parent mostrata con l'azione reporting.

FunzioneCostoUso
reporting(action="run_custom_report")0.5 crEsegue il report GAM giornaliero.
reporting(action="get_report_result")0 crRilegge la tabella completa in cache con resultId.
reporting(action="export_report_csv")0.5 crEsporta la tabella operativa quando serve.

Payload JSON

{
  "tool": "reporting",
  "arguments": {
    "action": "run_custom_report",
    "params": {
      "api": "rest",
      "dateRangeType": "YESTERDAY",
      "dimensions": [
        "DATE",
        "ADVERTISER_NAME",
        "ORDER_NAME",
        "LINE_ITEM_NAME",
        "AD_UNIT_NAME"
      ],
      "metrics": [
        "AD_SERVER_IMPRESSIONS",
        "AD_SERVER_CLICKS",
        "AD_SERVER_CTR",
        "AD_SERVER_REVENUE",
        "AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE"
      ]
    }
  }
}

Output rappresentativo

  • Ieri: 1.284.220 impression GAM, EUR 4.862 di revenue, CTR 0,42%.
  • Attenzione: Line Item LI-8241 e 18% sotto la media 7 giorni su AD_UNIT_NAME=Sports/Home.
  • Azione: controllare la rotazione creative prima di mezzogiorno; resultId completo rep_20260609_daily.

Dimensioni e metriche

Dimensioni
NameFonteDescrizione
DATEGAMGiorno del report
ADVERTISER_NAMEGAMNome advertiser
ORDER_NAMEGAMOrder campagna
LINE_ITEM_NAMEGAMLine item erogato
AD_UNIT_NAMEGAMPlacement inventario
Metriche
NameFonteDescrizione
AD_SERVER_IMPRESSIONSGAMImpression erogate
AD_SERVER_CLICKSGAMClick registrati
AD_SERVER_CTRGAMCTR
AD_SERVER_REVENUEGAMRevenue ad server
AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATEGAMTasso di viewability

Limiti

  • run_custom_report restituisce una preview inline e mantiene il risultato completo in cache per 30 giorni.
  • REST e l'API consigliata; usare api='soap' solo per campi legacy-only.
  • Usare get_report_result per leggere il risultato completo in cache quando la risposta inline e troncata.
  • Validare ogni campo nelle reference di dimensioni e metriche prima di automatizzare il prompt.
I nomi MCP e GAM non vengono tradotti per restare copiabili nei prompt.
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