Herramientas de Google Analytics 4
Informe general, informes de canales y páginas de destino, datos en tiempo real, eventos de conversión y vínculos con Google Ads.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura11 herramientas
list_ga4_properties
Lectura1 créditosPropiedades GA4 (id, nombre, cuenta) que la cuenta de Google conectada puede leer, más la propiedad por defecto usada cuando se omite property_id.
Esta herramienta no recibe parámetros.
ga4_report
Lectura1 créditosInforme GA4 personalizado (runReport): cualquier combinación de dimensiones × métricas para un rango de fechas con filtros, orden y límite. Las filas incluyen conversion_rate (keyEvents/sessions %) cuando ambos están presentes. 'conversions' son los eventos clave de GA4 (métrica keyEvents). Requiere una cuenta de Google conectada; si no, connected=false.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
daysOpcional | integer (1–730) | ventana que termina hoy cuando se omiten las fechas (por defecto 30) |
metricsOpcional | array<string> | nombres de métricas de la GA4 Data API, por defecto [sessions, totalUsers, keyEvents] |
dimensionsOpcional | array<string> | nombres de dimensiones GA4, p. ej. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName |
filtersOpcional | array<object> | filtros de dimensión combinados con AND, p. ej. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
order_byOpcional | string | una métrica o dimensión de la petición |
orderOpcional | asc | desc | — |
limitOpcional | integer (1–10000) | — |
offsetOpcional | integer (0–…) | — |
ga4_overview
Lectura1 créditosTotales generales del periodo: sesiones, usuarios, usuarios nuevos, sesiones con interacción, eventos clave (conversiones), ingresos, páginas vistas, con tasas de interacción y conversión; compare_previous añade el periodo anterior equivalente y la variación.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
daysOpcional | integer (1–730) | ventana que termina hoy cuando se omiten las fechas (por defecto 30) |
compare_previousOpcional | boolean | — |
all_propertiesOpcional | boolean | true: every selected property of this project in one call (per-property rows + grand total); use for 'all my sites today' (days=1) |
ga4_realtime
Lectura1 créditosUsuarios activos ahora mismo (últimos 30 minutos) y dónde están: por título de página/pantalla por defecto.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
dimensionsOpcional | array<string> | dimensiones en tiempo real: unifiedScreenName (por defecto), country, city, deviceCategory, eventName, platform |
metricsOpcional | array<string> | métricas en tiempo real: activeUsers (por defecto), screenPageViews, eventCount, keyEvents |
limitOpcional | integer (1–1000) | — |
ga4_landing_pages
Lectura1 créditosPáginas de destino con sesiones, sesiones con interacción, eventos clave (conversiones), ingresos y tasa de conversión, ordenadas por eventos clave por defecto.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
daysOpcional | integer (1–730) | ventana que termina hoy cuando se omiten las fechas (por defecto 30) |
filtersOpcional | array<object> | filtros de dimensión combinados con AND, p. ej. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
with_query_stringOpcional | boolean | — |
order_byOpcional | keyEvents | sessions | engagedSessions | totalRevenue | — |
limitOpcional | integer (1–1000) | — |
ga4_channel_report
Lectura1 créditosSesiones, sesiones con interacción, usuarios, eventos clave (conversiones), ingresos y tasas por grupo de canales predeterminado (o fuente/medio/campaña).
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
daysOpcional | integer (1–730) | ventana que termina hoy cuando se omiten las fechas (por defecto 30) |
filtersOpcional | array<object> | filtros de dimensión combinados con AND, p. ej. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
dimensionOpcional | string | sessionDefaultChannelGroup (por defecto), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium |
limitOpcional | integer (1–1000) | — |
ga4_vs_google_ads
Lectura2 créditosCanal 'Paid Search' de GA4 (sesiones, eventos clave, ingresos) junto al gasto, clics, conversiones y CPA de Google Ads en la misma ventana de los últimos N días, con la brecha de atribución. Si Google Ads no está conectado, el lado de Ads es null con una nota.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
daysOpcional | integer (1–90) | — |
list_ga4_google_ads_links
Lectura1 créditosCuentas de Google Ads vinculadas a la propiedad GA4 (id de cliente, indicador de personalización, creador, fecha de creación); linked=false marca una propiedad sin vínculo.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
list_ga4_conversion_events
Lectura1 créditosEventos de conversión (clave) definidos en la propiedad con el método de recuento y los indicadores de personalizado/eliminable.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
list_ga4_custom_dimensions
Lectura1 créditosDimensiones personalizadas de la propiedad (nombre del parámetro, nombre visible, ámbito).
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
ga4_list_data_streams
Lectura1 créditosFlujos de datos de una propiedad de GA4 (web, Android, iOS) con id del flujo, nombre, URI predeterminado y, en los flujos web, el ID de medición (G-XXXXXXX) necesario para configurar una etiqueta de GA4 en Tag Manager. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de la propiedad de GA4 (dígitos o properties/123). Omítelo para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
Herramientas de escritura4 herramientas
connect_ga4
Escritura0 créditosInicia la conexión de Google Analytics 4: devuelve un enlace de autorización de un solo uso que el usuario abre (el mismo flujo que connect_account). Nada se conecta hasta que el usuario inicie sesión.
Esta herramienta no recibe parámetros.
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_ga4_conversion_event
Escritura2 créditosMarca un evento GA4 como conversión (evento clave). Crea un elemento de aprobación con vista previa; se aplica mediante la Admin API solo tras la aprobación y solo con una cuenta conectada con permiso de edición.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
event_nameObligatorio | string | — |
counting_methodOpcional | ONCE_PER_EVENT | ONCE_PER_SESSION | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_ga4_custom_dimension
Escritura2 créditosCrea una dimensión personalizada (ámbito de evento, usuario o artículo). Pasa por vista previa y aprobación antes de la llamada a la Admin API.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
parameter_nameObligatorio | string | — |
display_nameOpcional | string | — |
scopeOpcional | EVENT | USER | ITEM | — |
descriptionOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_ga4_google_ads_link
Escritura2 créditosVincula una cuenta de Google Ads a la propiedad GA4 para que las conversiones fluyan a Google Ads. Pasa por vista previa y aprobación; requiere permiso de edición en ambos lados.
| Parámetro | Tipo | Descripción |
|---|---|---|
property_idOpcional | string | id de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones. |
customer_idObligatorio | string | id de cliente de Google Ads, 123-456-7890 |
ads_personalizationOpcional | boolean | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.