Aller au contenu principal
Docs reporting
Caso de uso GAM REST + Analytics link

Solo si el enlace GAM esta activo

Campos Analytics vinculados en GAM REST

Usa los campos Google Analytics que Google Ad Manager expone en informes HISTORICAL cuando el enlace esta activo en GAM.

Prompt del usuario

"En GAM REST, si los campos Analytics vinculados estan disponibles, muestra los ultimos 30 dias por DATE, PAGE_PATH y PAGE_TITLE_AND_SCREEN_NAME. Incluye SESSIONS, ACTIVE_USERS, GOOGLE_ANALYTICS_VIEWS y GOOGLE_ANALYTICS_REVENUE. Si un campo no esta disponible, nombralo y continua con los campos GAM restantes."

Resultado esperado

Un informe GAM REST que explica contexto de pagina y sesion con campos devueltos por Google Ad Manager, sin llamada GA4 Data API.

Flujo del agente

  1. 01

    Comprobar get_report_dimensions y get_report_metrics para campos REST compatibles con HISTORICAL.

  2. 02

    Ejecutar run_custom_report con api='rest' y report_type='HISTORICAL'.

  3. 03

    Explicar campos vinculados ausentes o vacios como disponibilidad de enlace/datos en GAM, no como conector GA4 de OrbiAds.

Funciones MCP

Llamada MCP padre mostrada con la accion reporting.

FuncionCosteUso
reporting(action="get_report_dimensions")0 crComprueba dimensiones GAM REST.
reporting(action="get_report_metrics")0 crComprueba metricas Analytics vinculadas expuestas por GAM.
reporting(action="run_custom_report")0.5 crEjecuta el informe GAM REST HISTORICAL.

Payload JSON

{
  "tool": "reporting",
  "arguments": {
    "action": "run_custom_report",
    "params": {
      "api": "rest",
      "report_type": "HISTORICAL",
      "date_range_type": "LAST_30_DAYS",
      "dimensions": [
        "DATE",
        "PAGE_PATH",
        "PAGE_TITLE_AND_SCREEN_NAME"
      ],
      "metrics": [
        "SESSIONS",
        "ACTIVE_USERS",
        "GOOGLE_ANALYTICS_VIEWS",
        "GOOGLE_ANALYTICS_REVENUE"
      ]
    }
  }
}

Salida representativa

  • DATE=2026-06-08 | PAGE_PATH=/sports/live | SESSIONS=18.420 | GOOGLE_ANALYTICS_REVENUE=EUR 642,80.
  • PAGE_TITLE_AND_SCREEN_NAME=Live scores | ACTIVE_USERS=12.940 | GOOGLE_ANALYTICS_VIEWS=31.220.
  • Nota: PAGE_PATH es un campo Analytics vinculado expuesto por GAM REST; no se consulto GA4.

Dimensiones y metricas

Dimensiones
NameFuenteDescripcion
DATEGAMDia del informe
PAGE_PATHGAMPage path Analytics vinculado expuesto por GAM
PAGE_TITLE_AND_SCREEN_NAMEGAMTitulo pagina / screen name Analytics vinculado expuesto por GAM
Metricas
NameFuenteDescripcion
SESSIONSGAMSesiones expuestas en GAM reporting
ACTIVE_USERSGAMUsuarios activos expuestos en GAM reporting
GOOGLE_ANALYTICS_VIEWSGAMViews unidas en GAM reporting
GOOGLE_ANALYTICS_REVENUEGAMRevenue Analytics unido en GAM reporting

Limites

  • El enlace Analytics debe estar activo y visible en reporting de Google Ad Manager.
  • OrbiAds no llama GA4 Data API aqui y no necesita GA4 property ID.
  • Costes de campana Google Ads, bids, keywords y clics nativos no estan disponibles en este workflow.
  • Usar get_report_result para leer el resultado completo en cache cuando la respuesta inline esta truncada.
Son columnas de informe GAM cuyas definiciones mencionan Google Analytics. OrbiAds sigue llamando solo GAM REST.
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