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

Detector de fuga de yield

Auditoria de inventario no vendido con Codex

Pide a Codex que encuentre ad units con impresiones sin llenar, fill rate bajo y volumen suficiente para justificar trabajo de yield.

Prompt del usuario

"Codex, revisa los ultimos 7 dias de inventario GAM. Ordena ad units con muchas unfilled impressions, fill rate por debajo de 85% y requests relevantes. Dame acciones por prioridad."

Resultado esperado

Una lista priorizada con volumen no vendido, fill rate, causa probable y primera remediacion.

Flujo del agente

  1. 01

    Traer datos de inventario para la ventana elegida.

  2. 02

    Ordenar por UNFILLED_IMPRESSIONS y filtrar filas con FILL_RATE bajo.

  3. 03

    Recomendar checks de demanda, floors, ad unit o tagging.

Funciones MCP

Llamada MCP padre mostrada con la accion reporting.

FuncionCosteUso
reporting(action="run_custom_report")0.5 crEjecuta el informe completo de inventario no vendido con AD_REQUESTS, UNFILLED_IMPRESSIONS y FILL_RATE.
reporting(action="get_report_metrics")0 crComprueba si FILL_RATE y UNFILLED_IMPRESSIONS estan disponibles.
reporting(action="fetch_inventory_report")0.5 crEjecuta una comprobacion de inventario mas acotada cuando el problema ya esta delimitado.
reporting(action="export_report_csv")0.5 crExporta la lista priorizada de fugas.

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

Salida representativa

  • Fuga principal: News/Article/Mobile tiene 482.913 UNFILLED_IMPRESSIONS y 71,4% FILL_RATE.
  • Causa probable: gap de demanda en DEVICE_CATEGORY_NAME=Mobile, no una caida global.
  • Siguiente paso: comparar floors y cobertura bidders en las 5 ad units principales.

Dimensiones y metricas

Dimensiones
NameFuenteDescripcion
AD_UNIT_NAMEGAMNombre inventario
AD_UNIT_CODEGAMCodigo tag
DATEGAMCorte diario
DEVICE_CATEGORY_NAMEGAMCategoria device
Metricas
NameFuenteDescripcion
AD_REQUESTSGAMOportunidades de demanda
AD_SERVER_IMPRESSIONSGAMImpresiones llenadas
UNFILLED_IMPRESSIONSGAMImpresiones no vendidas
FILL_RATEGAMRatio fill

Limites

  • run_custom_report consume creditos porque ejecuta un informe GAM.
  • Usa fetch_inventory_report solo para una comprobacion rapida por ad unit; el analisis completo necesita AD_REQUESTS, UNFILLED_IMPRESSIONS y FILL_RATE.
  • Usa SOAP solo cuando la metrica legacy no exista en REST.
  • Validar cada campo en las referencias de dimensiones y metricas antes de automatizar el prompt.
Codex puede convertirlo en issues o tareas de codigo, pero el informe MCP es read-only.
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