Pre-deploy Machbarkeit
Line Item Forecast mit Codex
Nutze Codex, um ein geplantes Line Item vor GAM Mutationen zu forecasten, inklusive sizes, priority, geo, frequency caps und Ziel.
"Codex, forecaste dieses geplante STANDARD Line Item vor Deploy: 300x250 und 728x90, France, Homepage ad units, 500.000 Impressions, priority 8, frequency cap 3 pro Tag. Sag mir, ob es safe ist."
Eine Machbarkeitsantwort mit availableUnits, matchedUnits, Risiko und Targeting-Constraint zum Lockern.
Agentenablauf
- 01
get_standalone_forecast fuer neue Planung oder get_delivery_forecast_by_line_item fuer bestehende Line Items ausfuehren.
- 02
Tatsaechliche priority, creativeSizes und frequencyCaps uebergeben, damit Inventory nicht aufgeblasen wird.
- 03
get_prospective_delivery_forecast nutzen, wenn mehrere Kandidaten gegeneinander konkurrieren koennen.
MCP-Funktionen
Parent-MCP-Aufruf mit reporting action.
| Funktion | Kosten | Zweck |
|---|---|---|
reporting(action="get_standalone_forecast") | 0 cr | Forecastet ein geplantes Line Item. |
reporting(action="get_delivery_forecast_by_line_item") | 0 cr | Prueft ein bestehendes Line Item. |
reporting(action="get_prospective_delivery_forecast") | 0 cr | Simuliert mehrere Kandidaten zusammen. |
JSON Payload
{
"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
}
}
}Beispielausgabe
- Forecast: 612.400 availableUnits fuer Ziel 500.000, riskLevel=LOW.
- Constraint: geoTargeting France entfernt 31% der matchedUnits; frequencyCaps weitere 18%.
- Empfehlung: Booking auf priority 8 ist safe, wenn creativeSizes 300x250 + 728x90 bleiben.
Dimensionen und Metrics
| Name | Quelle | Beschreibung |
|---|---|---|
| AD_UNIT_ID | GAM | Zielinventar |
| COUNTRY_ID | GAM | Geo Targeting |
| CREATIVE_TARGET_AD_UNIT_SIZE | GAM | Creative Size Constraint |
| Name | Quelle | Beschreibung |
|---|---|---|
availableUnits | Derived | Reservierbare Forecast-Einheiten |
matchedUnits | Derived | Einheiten passend zum Targeting |
possibleUnits | Derived | Maximale theoretische Einheiten |
riskLevel | Derived | Risikolabel |
Grenzen
- Forecasts sind Schaetzungen und sollten kurz vor Booking neu erzeugt werden.
- Fehlende sizes oder frequency caps koennen Delivery stark ueberzeichnen.
- Nicht-STANDARD oder nicht-SPONSORSHIP Inventar kann weniger Contention-Details liefern.
- Forecast Actions sind read-only; Booking braucht eine separate bestaetigte Mutation.
Nutze den redaktionellen Guide fuer die Zielgruppenlogik und komme dann fuer exakte MCP Actions, Felder und Payloads hierher zurueck.