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.
"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."
Una risposta di fattibilita con availableUnits, matchedUnits, livello rischio e vincolo targeting da rilassare.
Flusso agente
- 01
Eseguire get_standalone_forecast per nuovo lavoro o get_delivery_forecast_by_line_item per line item esistente.
- 02
Passare priority reale, creativeSizes e frequencyCaps per evitare inventario gonfiato.
- 03
Usare get_prospective_delivery_forecast se piu line items candidati possono competere.
Funzioni MCP
Chiamata MCP parent mostrata con l'azione reporting.
| Funzione | Costo | Uso |
|---|---|---|
reporting(action="get_standalone_forecast") | 0 cr | Fa forecast di un line item pianificato. |
reporting(action="get_delivery_forecast_by_line_item") | 0 cr | Controlla un line item esistente. |
reporting(action="get_prospective_delivery_forecast") | 0 cr | Simula 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
| Name | Fonte | Descrizione |
|---|---|---|
| AD_UNIT_ID | GAM | Inventario target |
| COUNTRY_ID | GAM | Targeting geo |
| CREATIVE_TARGET_AD_UNIT_SIZE | GAM | Vincolo size creative |
| Name | Fonte | Descrizione |
|---|---|---|
availableUnits | Derived | Unita prenotabili dal forecast |
matchedUnits | Derived | Unita che matchano il targeting |
possibleUnits | Derived | Unita teoriche massime |
riskLevel | Derived | Livello 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 la guida editoriale per il contesto audience, poi torna qui per azioni MCP, campi e payload esatti.
