Aller au contenu principal
Docs reporting
Use case Codex + Yield

Detection de fuite yield

Audit inventaire invendu avec Codex

Demandez a Codex de trouver les ad units avec impressions invendues, fill rate faible et volume suffisant pour justifier un travail yield.

Prompt utilisateur

"Codex, inspecte les 7 derniers jours d'inventaire GAM. Classe les ad units ou les unfilled impressions sont elevees, le fill rate sous 85%, et les requests assez fortes pour compter. Donne les correctifs par priorite."

Résultat attendu

Une liste d'inventaire priorisee avec volume invendu, fill rate, cause probable et premiere remediation.

Workflow agent

  1. 01

    Recuperer les donnees inventaire sur la periode choisie.

  2. 02

    Trier par UNFILLED_IMPRESSIONS et filtrer les lignes a faible FILL_RATE.

  3. 03

    Recommander des controles demande, floor, ad unit ou tagging.

Fonctions MCP

Appel MCP parent montré avec l'action reporting.

FonctionCoûtUsage
reporting(action="run_custom_report")0.5 crExecute le rapport complet des invendus avec AD_REQUESTS, UNFILLED_IMPRESSIONS et FILL_RATE.
reporting(action="get_report_metrics")0 crVerifie la disponibilite de FILL_RATE et UNFILLED_IMPRESSIONS.
reporting(action="fetch_inventory_report")0.5 crLance un controle inventaire plus limite quand le probleme est deja scope.
reporting(action="export_report_csv")0.5 crExporte la liste priorisee des fuites.

Payload JSON

{
  "tool": "reporting",
  "arguments": {
    "action": "run_custom_report",
    "params": {
      "api": "rest",
      "dateRangeType": "FIXED",
      "startDate": "2026-06-02",
      "endDate": "2026-06-08",
      "dimensions": [
        "DATE",
        "AD_UNIT_NAME",
        "AD_UNIT_CODE",
        "DEVICE_CATEGORY_NAME"
      ],
      "metrics": [
        "AD_REQUESTS",
        "AD_SERVER_IMPRESSIONS",
        "UNFILLED_IMPRESSIONS",
        "FILL_RATE"
      ]
    }
  }
}

Sortie représentative

  • Fuite principale: News/Article/Mobile a 482 913 UNFILLED_IMPRESSIONS et 71,4% FILL_RATE.
  • Cause probable: trou de demande sur DEVICE_CATEGORY_NAME=Mobile, pas une panne globale.
  • Prochaine etape: comparer floors et couverture bidders sur les 5 premieres ad units.
Dimensions
NameSourceDescription
AD_UNIT_NAMEGAMNom inventaire
AD_UNIT_CODEGAMCode tag
DATEGAMSplit quotidien
DEVICE_CATEGORY_NAMEGAMCategorie device
Métriques
NameSourceDescription
AD_REQUESTSGAMOpportunites de demande
AD_SERVER_IMPRESSIONSGAMImpressions remplies
UNFILLED_IMPRESSIONSGAMImpressions invendues
FILL_RATEGAMRatio de fill

Limites

  • run_custom_report coute des credits car il execute un rapport GAM.
  • Utiliser fetch_inventory_report seulement pour un controle rapide par ad unit; l'analyse complete demande AD_REQUESTS, UNFILLED_IMPRESSIONS et FILL_RATE.
  • Utiliser SOAP uniquement si la metric inventaire legacy requise n'existe pas en REST.
  • Valider chaque champ dans les références dimensions et métriques avant d'automatiser le prompt.
Codex peut transformer ce diagnostic en issues ou taches code, mais le rapport MCP reste read-only.
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