Aller au contenu principal
Docs reporting
Caso d'uso Codex + Trafficking

Fattibilita pre-deploy

Forecast line item con Codex

Usa Codex per fare forecast di un line item pianificato prima di mutare GAM, includendo sizes, priorita, geo, frequency caps e goal.

Prompt utente

"Codex, fai forecast di questo line item STANDARD prima del deploy: 300x250 e 728x90, Francia, ad units Homepage, 500.000 impression, priority 8, frequency cap 3 al giorno. Dimmi se e sicuro."

Risultato atteso

Una risposta di fattibilita con availableUnits, matchedUnits, livello rischio e vincolo targeting da rilassare.

Flusso agente

  1. 01

    Eseguire get_standalone_forecast per nuovo lavoro o get_delivery_forecast_by_line_item per line item esistente.

  2. 02

    Passare priority reale, creativeSizes e frequencyCaps per evitare inventario gonfiato.

  3. 03

    Usare get_prospective_delivery_forecast se piu line items candidati possono competere.

Funzioni MCP

Chiamata MCP parent mostrata con l'azione reporting.

FunzioneCostoUso
reporting(action="get_standalone_forecast")0 crFa forecast di un line item pianificato.
reporting(action="get_delivery_forecast_by_line_item")0 crControlla un line item esistente.
reporting(action="get_prospective_delivery_forecast")0 crSimula piu line items candidati insieme.

Payload JSON

{
  "tool": "reporting",
  "arguments": {
    "action": "get_standalone_forecast",
    "params": {
      "adUnitIds": [
        "1234567",
        "1234568"
      ],
      "startDate": "2026-07-01T00:00:00",
      "endDate": "2026-07-31T23:59:59",
      "primaryGoalUnits": 500000,
      "lineItemType": "STANDARD",
      "priority": 8,
      "geoTargeting": [
        "2250"
      ],
      "creativeSizes": [
        {
          "width": 300,
          "height": 250
        },
        {
          "width": 728,
          "height": 90
        }
      ],
      "frequencyCaps": [
        {
          "maxImpressions": 3,
          "numTimeUnits": 1,
          "timeUnit": "DAY"
        }
      ],
      "includeTargetingCriteriaBreakdown": true
    }
  }
}

Output rappresentativo

  • Forecast: 612.400 availableUnits per goal 500.000, riskLevel=LOW.
  • Vincolo: geoTargeting France rimuove 31% dei matchedUnits; frequencyCaps un altro 18%.
  • Raccomandazione: booking safe a priority 8 se creativeSizes resta 300x250 + 728x90.

Dimensioni e metriche

Dimensioni
NameFonteDescrizione
AD_UNIT_IDGAMInventario target
COUNTRY_IDGAMTargeting geo
CREATIVE_TARGET_AD_UNIT_SIZEGAMVincolo size creative
Metriche
NameFonteDescrizione
availableUnitsDerivedUnita prenotabili dal forecast
matchedUnitsDerivedUnita che matchano il targeting
possibleUnitsDerivedUnita teoriche massime
riskLevelDerivedLivello di rischio

Limiti

  • I forecast sono stime e vanno rigenerati vicino al booking.
  • Sizes o frequency caps mancanti possono sovrastimare molto il delivery.
  • Inventario non-STANDARD o non-SPONSORSHIP puo esporre meno dettagli di contention.
  • Le azioni forecast sono read-only; il booking richiede una mutazione confermata separata.
Usa il forecast come supporto decisionale, non come garanzia di delivery futuro.
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