Aller au contenu principal
OrbiAds logo — infrastructure AdOps IA pour Google Ad Manager OrbiAds
OrbiAds logo — infrastructure AdOps IA pour Google Ad Manager
Iniciar Sesión
GitHub
Docs reporting

Skills MCP

Personalizar skills de reporting para Claude, Codex y MCP

Usa un skill cuando la misma pregunta de reporting vuelve cada dia. El skill debe fijar acciones MCP permitidas, dimensiones y metricas exactas, formato de salida y guardrails.

Que debe contener un skill de reporting

Un buen skill no es un prompt generico. Es un contrato operativo para el agente: funciones MCP permitidas, campos GAM validos, forma de salida JSON o prosa, y acciones prohibidas.

Acciones permitidas

MCP functions + scope

Contrato de campos

Dimensions + metrics

Contrato de salida

JSON, CSV, or summary

Mapa de enlaces internos

Cada skill debe enlazar al catalogo de campos y a la pagina exacta del caso. El lector tiene una ruta clara y el SEO entiende mejor el cluster de reporting.

Claude Cowork

Skill de informe GAM diario

Para un brief AdOps matinal que explique delivery, revenue, problemas de fill y acciones sin abrir una hoja de calculo.

Abrir caso tecnico Leer guia Academy

Prompt de usuario

Claude, ejecuta el informe GAM de ayer por DATE, ADVERTISER_NAME, ORDER_NAME, LINE_ITEM_NAME y AD_UNIT_NAME. Incluye AD_SERVER_IMPRESSIONS, AD_SERVER_CLICKS, AD_SERVER_CTR, AD_SERVER_REVENUE, AD_REQUESTS, FILL_RATE y UNFILLED_IMPRESSIONS. Resume anomalias y dame el resultId.

Instrucciones del skill

Acciones MCP permitidas: get_report_dimensions, get_report_metrics, run_custom_report, get_report_result, export_report_csv. api=rest por defecto. Usa api=soap solo si la referencia indica que REST no esta disponible. Devuelve resumen humano, lista de acciones y resultId.

Funciones MCP permitidas

get_report_dimensionsget_report_metricsrun_custom_reportget_report_resultexport_report_csv

Referencias de campos

Salida representativa

  • Ayer: 1.284.220 impresiones, EUR 4.862 revenue, CTR 0,42 %, fill rate 91,8 %.
  • Atencion: LI-8241 esta 18 % bajo su media de 7 dias en AD_UNIT_NAME=Sports/Home.
  • Accion: revisar rotacion creativa antes del mediodia; resultId rep_20260609_daily.

Guardrails

  • No inventar campos. Validar nombres inciertos con get_report_dimensions o get_report_metrics.
  • Usar GAM REST para todo el reporting aqui; los campos Analytics vinculados son columnas GAM opcionales solo si el enlace esta activo.

Codex

Skill de triage de inventario no vendido

Para priorizar ad units donde existe demanda pero hay fuga de fill o monetizacion.

Abrir caso tecnico Leer guia Academy

Prompt de usuario

Codex, encuentra inventario no vendido de los ultimos 7 dias por DATE, AD_UNIT_NAME, AD_UNIT_CODE y DEVICE_CATEGORY_NAME. Usa AD_REQUESTS, AD_SERVER_IMPRESSIONS, UNFILLED_IMPRESSIONS y FILL_RATE. Ordena por revenue perdido estimado y exporta CSV si hay mas de 20 filas.

Instrucciones del skill

Usa run_custom_report para el informe REST completo. fetch_inventory_report solo sirve como vista rapida de ad-unit inventory, no como fuente de todas las metricas de no vendido. Mantener AD_REQUESTS junto a UNFILLED_IMPRESSIONS.

Funciones MCP permitidas

get_report_metricsrun_custom_reportget_report_resultexport_report_csvfetch_inventory_report

Referencias de campos

Salida representativa

  • Sports/Homepage | 184.210 ad requests | 52.440 unfilled | fill rate 71,5 % | revenue perdido estimado EUR 1.126.
  • Hipotesis: problema de demanda o sizes, no perdida de trafico.
  • Accion: revisar filtros, price floor y bidder sizes antes de cambiar trafficking.

Guardrails

  • No llamar GA4 ni Google Ads API en este workflow.
  • No optimizar price floors con un solo dia; comparar ayer, 7 dias y mismo dia de semana.

Codex

Skill guardrail de forecast line item

Para comprobar si un line item planificado puede entregar antes de mutar GAM.

Abrir caso tecnico Leer guia Academy

Prompt de usuario

Codex, ejecuta standalone forecast para un line item STANDARD planificado: Francia, ad units Homepage, sizes 300x250 y 728x90, objetivo 500000 impresiones, prioridad 8, frequency cap 3 por dia. Devuelve availableUnits, matchedUnits, possibleUnits, riskLevel y constraint a relajar.

Instrucciones del skill

Usar funciones forecast, no run_custom_report, porque la disponibilidad futura no es una metrica historica. No crear, actualizar ni reservar el line item. Devolver decision: safe, review o unsafe.

Funciones MCP permitidas

get_standalone_forecastget_delivery_forecast_by_line_itemget_prospective_delivery_forecast

Referencias de campos

Dimensiones

lineItemType=STANDARDadUnitIdscreativePlaceholdersgeoTargetingfrequencyCaps

Metricas

availableUnitsmatchedUnitspossibleUnitsriskLevel

Salida representativa

  • Forecast: 612.400 availableUnits para objetivo 500.000, matchedUnits 544.900, riskLevel=LOW.
  • Constraint a vigilar: Homepage + Francia + frequency cap 3/dia reduce possibleUnits 21 %.
  • Decision: safe para revisar con sales, regenerar antes de booking.

Guardrails

  • El forecast es una estimacion de planning, no garantia de delivery.
  • Para line items existentes, usar get_delivery_forecast_by_line_item.

Codex / LLM JSON

Skill forecast JSON order y key-values

Para devolver un forecast JSON repetible que combina contexto order GAM, IDs de custom targeting resueltos y numeros de disponibilidad.

Abrir caso tecnico Leer guia Academy

Prompt de usuario

Codex, produce solo un JSON forecastDecision para el order OR-2026-SUMMER: resuelve el order, resuelve audience=sports y hb_pb=20 a keyId/valueIds, forecastea ad units Homepage/Sports del 2026-07-01 al 2026-07-31 para 500000 impresiones, sizes 300x250 y 728x90, prioridad 8, frequency cap 3 por dia.

Instrucciones del skill

Acciones MCP permitidas: orders list/get, targeting search_custom_targeting/get_custom_targeting_values, reporting get_standalone_forecast/get_delivery_forecast_by_line_item/get_prospective_delivery_forecast. Resolver IDs antes del forecast. Devolver solo JSON, sin prosa. El forecast no es un informe REST HISTORICAL.

Funciones MCP permitidas

list_ordersget_ordersearch_custom_targetingget_custom_targeting_valuesget_standalone_forecastget_delivery_forecast_by_line_itemget_prospective_delivery_forecast

Referencias de campos

Metricas

availableUnitsmatchedUnitsutilizationPercentriskLevel

Salida representativa

  • {"order":{"id":"9482","name":"OR-2026-SUMMER","status":"DRAFT","advertiserId":"7712"},"targeting":{"adUnitIds":["1234567","1234568"],"keyValues":[{"keyId":1871,"valueIds":[9912]},{"keyId":2450,"valueIds":[3301]}]}}
  • {"forecast":{"availableUnits":612400,"matchedUnits":544900,"utilizationPercent":81.6,"contendingLineItems":[{"lineItemId":"90031","priority":6}]}}
  • {"decision":{"riskLevel":"LOW","status":"safe_to_review","relaxFirst":null,"nextAction":"regenerate_before_booking"}}

Guardrails

  • No crear, actualizar, aprobar ni reservar el order desde esta skill.
  • No forecastear con nombres key-value brutos; resolver IDs primero.
  • Mantener claves JSON estables para que prompts LLM posteriores validen campos requeridos.

GAM REST / liens actifs

Skill campos vinculados GAM REST

Para reportar campos Analytics, AdSense o Ad Exchange expuestos por Google Ad Manager cuando el enlace o la fuente esta activa en GAM.

Abrir caso tecnico Leer guia Academy

Prompt de usuario

Solo con GAM REST, si los campos vinculados estan disponibles, ejecuta un informe HISTORICAL de los ultimos 7 dias por DATE, PAGE_PATH y DEMAND_CHANNEL_NAME. Incluye SESSIONS, GOOGLE_ANALYTICS_REVENUE, ADSENSE_REVENUE, AD_EXCHANGE_REVENUE y AD_EXCHANGE_AVERAGE_ECPM.

Instrucciones del skill

Acciones MCP permitidas: get_report_dimensions, get_report_metrics, run_custom_report, get_report_result. Usar api="rest" y report_type="HISTORICAL". Si falta un campo o esta vacio, explicar que la fuente vinculada puede no estar activa en GAM.

Funciones MCP permitidas

get_report_dimensionsget_report_metricsrun_custom_reportget_report_result

Referencias de campos

Dimensiones

DATEPAGE_PATHDEMAND_CHANNEL_NAME

Metricas

SESSIONSGOOGLE_ANALYTICS_REVENUEADSENSE_REVENUEAD_EXCHANGE_REVENUEAD_EXCHANGE_AVERAGE_ECPM

Salida representativa

  • /news/live | Direct | 18.420 sessions | EUR 1.284 revenue Analytics GAM | EUR 942 revenue Ad Exchange | EUR 3,82 eCPM AdX.
  • DEMAND_CHANNEL_NAME=AdSense suma EUR 218 sobre 62.410 impresiones; AD_EXCHANGE_REVENUE es la fuente vinculada mayor.
  • Nota: son campos vinculados GAM REST; no se llamo GA4 Data API ni Google Ads API.

Guardrails

  • No pedir GA4 property ID ni Google Ads account ID.
  • No describir coste, keywords, bids o clics nativos no disponibles como salida GAM REST.

Finance / AdOps

Skill billing y export de evidencias

Para controles mensuales finance que comparan cantidades contratadas, impresiones entregadas, revenue y filas CSV.

Abrir caso tecnico

Prompt de usuario

Prepara el billing report de mayo. Incluye solo line items STANDARD y SPONSORSHIP, muestra contracted vs delivered impressions, revenue y eCPM, y exporta CSV para finance.

Instrucciones del skill

Usar generate_billing_report para filas contracted vs delivered. Usar get_report_result para revision y export_report_csv para finance. Si existe URL de descarga, usar get_report_download_link tras export.

Funciones MCP permitidas

generate_billing_reportget_report_resultexport_report_csvget_report_download_link

Referencias de campos

Salida representativa

  • Billing mayo: 42 line items facturables, 38 dentro de tolerancia, 4 para make-good.
  • STANDARD entrego 93,2 % de impresiones contratadas; SPONSORSHIP 101,4 %.
  • Export CSV listo: billing_2026_05_standard_sponsorship.csv.

Guardrails

  • Los billing reports son evidencias operativas, no documentos contables finales.
  • Conservar siempre order, line item y advertiser names en el export.