Aller au contenu principal
Docs reporting
Use case Codex + Trafficking

Faisabilite pre-deploy

Forecast line item avec Codex

Utilisez Codex pour forecaster un line item planifie avant toute mutation GAM, avec sizes, priorite, geo, frequency caps et objectif.

Prompt utilisateur

"Codex, forecast ce line item STANDARD avant deploy: 300x250 et 728x90, France, ad units Homepage, 500 000 impressions, priorite 8, frequency cap 3 par jour. Dis-moi si c'est safe."

Résultat attendu

Une reponse de faisabilite avec availableUnits, matchedUnits, niveau de risque et contrainte de ciblage a relacher.

Workflow agent

  1. 01

    Executer get_standalone_forecast pour un nouveau besoin ou get_delivery_forecast_by_line_item pour un line item existant.

  2. 02

    Passer la vraie priority, creativeSizes et frequencyCaps pour eviter un inventaire gonfle.

  3. 03

    Utiliser get_prospective_delivery_forecast si plusieurs line items candidats peuvent se concurrencer.

Fonctions MCP

Appel MCP parent montré avec l'action reporting.

FonctionCoûtUsage
reporting(action="get_standalone_forecast")0 crForecast un line item planifie.
reporting(action="get_delivery_forecast_by_line_item")0 crControle un line item existant.
reporting(action="get_prospective_delivery_forecast")0 crSimule plusieurs line items candidats ensemble.

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

Sortie représentative

  • Forecast: 612 400 availableUnits pour un objectif de 500 000, riskLevel=LOW.
  • Contrainte: geoTargeting France retire 31% des matchedUnits; frequencyCaps retire encore 18%.
  • Recommendation: booking safe en priorite 8 si creativeSizes reste 300x250 + 728x90.
Dimensions
NameSourceDescription
AD_UNIT_IDGAMInventaire cible
COUNTRY_IDGAMCiblage geo
CREATIVE_TARGET_AD_UNIT_SIZEGAMContrainte size creative
Métriques
NameSourceDescription
availableUnitsDerivedUnites reservables du forecast
matchedUnitsDerivedUnites matchant le ciblage
possibleUnitsDerivedUnites theoriques maximum
riskLevelDerivedNiveau de risque decisionnel

Limites

  • Les forecasts sont des estimations et doivent etre regeneres proche du booking.
  • Des sizes ou frequency caps manquants peuvent sur-estimer fortement la livraison.
  • Les inventaires non-STANDARD ou non-SPONSORSHIP peuvent exposer moins de details de contention.
  • Les actions de forecast sont read-only; le booking demande une mutation confirmee separee.
Utilisez le forecast comme aide a la decision, pas comme garantie de delivery futur.
Lire le guide Academy

Utilisez le guide éditorial pour cadrer l'audience, puis revenez ici pour les actions MCP, champs et payloads exacts.

Lire le guide Academy
Références champs