Audit inventario invenduto con Codex

Chiedi a Codex di trovare ad unit con impression invendute, fill rate basso e volume sufficiente per meritare lavoro yield.

Prompt utente

"Codex, analizza gli ultimi 7 giorni di inventario GAM. Ordina le ad unit con molte unfilled impressions, fill rate sotto 85% e requests rilevanti. Dammi fix per priorita."

Risultato atteso

Una lista prioritaria con volume invenduto, fill rate, causa probabile e prima remediation.

Flusso agente

01

Recuperare dati inventario per la finestra scelta.
02

Ordinare per UNFILLED_IMPRESSIONS e filtrare righe con FILL_RATE basso.
03

Raccomandare controlli su demand, floor, ad unit o tagging.

Funzioni MCP

Chiamata MCP parent mostrata con l'azione reporting.

Funzione	Costo	Uso
`reporting(action="run_custom_report")`	0.5 cr	Esegue il report completo dell'invenduto con AD_REQUESTS, UNFILLED_IMPRESSIONS e FILL_RATE.
`reporting(action="get_report_metrics")`	0 cr	Verifica se FILL_RATE e UNFILLED_IMPRESSIONS sono disponibili.
`reporting(action="fetch_inventory_report")`	0.5 cr	Esegue un controllo inventory piu limitato quando il problema e gia circoscritto.
`reporting(action="export_report_csv")`	0.5 cr	Esporta la lista prioritaria delle perdite.

Payload JSON

{
  "tool": "reporting",
  "arguments": {
    "action": "run_custom_report",
    "params": {
      "api": "rest",
      "dateRangeType": "FIXED",
      "startDate": "2026-06-02",
      "endDate": "2026-06-08",
      "dimensions": [
        "DATE",
        "AD_UNIT_NAME",
        "AD_UNIT_CODE",
        "DEVICE_CATEGORY_NAME"
      ],
      "metrics": [
        "AD_REQUESTS",
        "AD_SERVER_IMPRESSIONS",
        "UNFILLED_IMPRESSIONS",
        "FILL_RATE"
      ]
    }
  }
}

Output rappresentativo

Perdita principale: News/Article/Mobile ha 482.913 UNFILLED_IMPRESSIONS e 71,4% FILL_RATE.
Causa probabile: gap di domanda su DEVICE_CATEGORY_NAME=Mobile, non outage globale.
Prossimo step: confrontare floors e copertura bidders sulle prime 5 ad unit.

Dimensioni e metriche

Apri dimensioni Apri metriche

Dimensioni

Name	Fonte	Descrizione
AD_UNIT_NAME	GAM	Nome inventario
AD_UNIT_CODE	GAM	Codice tag
DATE	GAM	Split giornaliero
DEVICE_CATEGORY_NAME	GAM	Categoria device

Metriche

Name	Fonte	Descrizione
AD_REQUESTS	GAM	Opportunita di domanda
AD_SERVER_IMPRESSIONS	GAM	Impression riempite
UNFILLED_IMPRESSIONS	GAM	Impression invendute
FILL_RATE	GAM	Fill ratio

Limiti

run_custom_report costa crediti perche esegue un report GAM.
Usare fetch_inventory_report solo per un controllo rapido per ad unit; l'analisi completa richiede AD_REQUESTS, UNFILLED_IMPRESSIONS e FILL_RATE.
Usare SOAP solo quando la metrica legacy richiesta non esiste in REST.
Validare ogni campo nelle reference di dimensioni e metriche prima di automatizzare il prompt.

Codex puo trasformare il risultato in issue o task codice, ma il report MCP resta read-only.

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

Apri dimensioni Apri metriche Personalizzare skill reporting