Aller au contenu principal
Docs reporting
Caso de uso Codex + Trafficking

Factibilidad pre-deploy

Forecast de line item con Codex

Usa Codex para predecir un line item planificado antes de mutar GAM, incluyendo sizes, prioridad, geo, frequency caps y objetivo.

Prompt del usuario

"Codex, haz forecast de este line item STANDARD antes del deploy: 300x250 y 728x90, Francia, ad units Homepage, 500.000 impresiones, prioridad 8, frequency cap 3 por dia. Dime si es seguro."

Resultado esperado

Una respuesta de factibilidad con availableUnits, matchedUnits, riesgo y la restriccion de targeting a relajar.

Flujo del agente

  1. 01

    Ejecutar get_standalone_forecast para trabajo nuevo o get_delivery_forecast_by_line_item para line item existente.

  2. 02

    Pasar priority real, creativeSizes y frequencyCaps para evitar inventario inflado.

  3. 03

    Usar get_prospective_delivery_forecast si varios line items candidatos compiten.

Funciones MCP

Llamada MCP padre mostrada con la accion reporting.

FuncionCosteUso
reporting(action="get_standalone_forecast")0 crPredice un line item planificado.
reporting(action="get_delivery_forecast_by_line_item")0 crComprueba un line item existente.
reporting(action="get_prospective_delivery_forecast")0 crSimula varios line items candidatos juntos.

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
    }
  }
}

Salida representativa

  • Forecast: 612.400 availableUnits para objetivo 500.000, riskLevel=LOW.
  • Restriccion: geoTargeting France quita 31% de matchedUnits; frequencyCaps otro 18%.
  • Recomendacion: seguro reservar en priority 8 si creativeSizes sigue 300x250 + 728x90.

Dimensiones y metricas

Dimensiones
NameFuenteDescripcion
AD_UNIT_IDGAMInventario objetivo
COUNTRY_IDGAMTargeting geo
CREATIVE_TARGET_AD_UNIT_SIZEGAMRestriccion de size creative
Metricas
NameFuenteDescripcion
availableUnitsDerivedUnidades reservables del forecast
matchedUnitsDerivedUnidades que coinciden con targeting
possibleUnitsDerivedUnidades teoricas maximas
riskLevelDerivedNivel de riesgo

Limites

  • Los forecasts son estimaciones y deben regenerarse cerca del booking.
  • Sizes o frequency caps ausentes pueden sobrestimar mucho el delivery.
  • Inventario no-STANDARD o no-SPONSORSHIP puede exponer menos detalle de contencion.
  • Las acciones de forecast son read-only; el booking requiere una mutacion confirmada aparte.
Usa el forecast como ayuda de decision, no como garantia de delivery futuro.
Leer la guia Academy

Usa la guia editorial para el contexto de audiencia y vuelve aqui para acciones MCP, campos y payloads exactos.

Leer la guia Academy
Referencias de campos