Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Informes

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éditos

Propiedades 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éditos

Informe 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ámetroTipoDescripción
property_idOpcionalstringid de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones.
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
daysOpcionalinteger (1–730)ventana que termina hoy cuando se omiten las fechas (por defecto 30)
metricsOpcionalarray<string>nombres de métricas de la GA4 Data API, por defecto [sessions, totalUsers, keyEvents]
dimensionsOpcionalarray<string>nombres de dimensiones GA4, p. ej. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName
filtersOpcionalarray<object>filtros de dimensión combinados con AND, p. ej. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
order_byOpcionalstringuna métrica o dimensión de la petición
orderOpcionalasc | desc—
limitOpcionalinteger (1–10000)—
offsetOpcionalinteger (0–…)—

ga4_overview

Lectura1 créditos

Totales 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ámetroTipoDescripción
property_idOpcionalstringid de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones.
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
daysOpcionalinteger (1–730)ventana que termina hoy cuando se omiten las fechas (por defecto 30)
compare_previousOpcionalboolean—
all_propertiesOpcionalbooleantrue: 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éditos

Usuarios activos ahora mismo (últimos 30 minutos) y dónde están: por título de página/pantalla por defecto.

ParámetroTipoDescripción
property_idOpcionalstringid de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones.
dimensionsOpcionalarray<string>dimensiones en tiempo real: unifiedScreenName (por defecto), country, city, deviceCategory, eventName, platform
metricsOpcionalarray<string>métricas en tiempo real: activeUsers (por defecto), screenPageViews, eventCount, keyEvents
limitOpcionalinteger (1–1000)—

ga4_landing_pages

Lectura1 créditos

Pá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ámetroTipoDescripción
property_idOpcionalstringid de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones.
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
daysOpcionalinteger (1–730)ventana que termina hoy cuando se omiten las fechas (por defecto 30)
filtersOpcionalarray<object>filtros de dimensión combinados con AND, p. ej. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
with_query_stringOpcionalboolean—
order_byOpcionalkeyEvents | sessions | engagedSessions | totalRevenue—
limitOpcionalinteger (1–1000)—

ga4_channel_report

Lectura1 créditos

Sesiones, sesiones con interacción, usuarios, eventos clave (conversiones), ingresos y tasas por grupo de canales predeterminado (o fuente/medio/campaña).

ParámetroTipoDescripción
property_idOpcionalstringid de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones.
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
daysOpcionalinteger (1–730)ventana que termina hoy cuando se omiten las fechas (por defecto 30)
filtersOpcionalarray<object>filtros de dimensión combinados con AND, p. ej. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
dimensionOpcionalstringsessionDefaultChannelGroup (por defecto), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium
limitOpcionalinteger (1–1000)—

ga4_vs_google_ads

Lectura2 créditos

Canal '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ámetroTipoDescripción
property_idOpcionalstringid de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones.
daysOpcionalinteger (1–90)—

list_ga4_conversion_events

Lectura1 créditos

Eventos de conversión (clave) definidos en la propiedad con el método de recuento y los indicadores de personalizado/eliminable.

ParámetroTipoDescripción
property_idOpcionalstringid 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éditos

Dimensiones personalizadas de la propiedad (nombre del parámetro, nombre visible, ámbito).

ParámetroTipoDescripción
property_idOpcionalstringid 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éditos

Flujos 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ámetroTipoDescripción
property_idOpcionalstringid 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éditos

Inicia 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éditos

Marca 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ámetroTipoDescripción
property_idOpcionalstringid de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones.
event_nameObligatoriostring—
counting_methodOpcionalONCE_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éditos

Crea 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ámetroTipoDescripción
property_idOpcionalstringid de propiedad GA4 (dígitos o properties/123). Omitir para usar la predeterminada conectada; list_ga4_properties muestra las opciones.
parameter_nameObligatoriostring—
display_nameOpcionalstring—
scopeOpcionalEVENT | USER | ITEM—
descriptionOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.