Referencia de herramientas — Datos y sitio

Google Analytics 4 tools

Overview, channel and landing page reports, realtime data, conversion events and Google Ads links.

Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son el texto original en inglés que ve el asistente.

Herramientas de lectura10 herramientas

list_ga4_properties

Lectura1 créditos

GA4 properties (id, name, account) the connected Google account can read, plus the default property used when property_id is omitted.

Esta herramienta no recibe parámetros.

ga4_report

Lectura1 créditos

Custom GA4 report (runReport): any dimensions × metrics for a date range with filters, ordering and limit. Rows carry conversion_rate (keyEvents/sessions %) when both are present. 'conversions' are GA4 key events (metric keyEvents). Requires a connected Google account; otherwise connected=false.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Opcional	string	YYYY-MM-DD
`end_date`Opcional	string	YYYY-MM-DD
`days`Opcional	integer (1–730)	window ending today when dates are omitted (default 30)
`metrics`Opcional	array<string>	GA4 Data API metric names, default [sessions, totalUsers, keyEvents]
`dimensions`Opcional	array<string>	GA4 dimension names, e.g. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName
`filters`Opcional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`order_by`Opcional	string	a metric or dimension in the request
`order`Opcional	asc \| desc	—
`limit`Opcional	integer (1–10000)	—
`offset`Opcional	integer (0–…)	—

ga4_overview

Lectura1 créditos

Overview totals for the period: sessions, users, new users, engaged sessions, key events (conversions), revenue, page views, with engagement and conversion rates; compare_previous adds the preceding equal period and change.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Opcional	string	YYYY-MM-DD
`end_date`Opcional	string	YYYY-MM-DD
`days`Opcional	integer (1–730)	window ending today when dates are omitted (default 30)
`compare_previous`Opcional	boolean	—

ga4_realtime

Lectura1 créditos

Active users right now (last 30 minutes) and where they are — by page/screen title by default.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`dimensions`Opcional	array<string>	realtime dimensions: unifiedScreenName (default), country, city, deviceCategory, eventName, platform
`metrics`Opcional	array<string>	realtime metrics: activeUsers (default), screenPageViews, eventCount, keyEvents
`limit`Opcional	integer (1–1000)	—

ga4_landing_pages

Lectura1 créditos

Landing pages with sessions, engaged sessions, key events (conversions), revenue and conversion rate, ordered by key events by default.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Opcional	string	YYYY-MM-DD
`end_date`Opcional	string	YYYY-MM-DD
`days`Opcional	integer (1–730)	window ending today when dates are omitted (default 30)
`filters`Opcional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`with_query_string`Opcional	boolean	—
`order_by`Opcional	keyEvents \| sessions \| engagedSessions \| totalRevenue	—
`limit`Opcional	integer (1–1000)	—

ga4_channel_report

Lectura1 créditos

Sessions, engaged sessions, users, key events (conversions), revenue and rates by default channel group (or source/medium/campaign).

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Opcional	string	YYYY-MM-DD
`end_date`Opcional	string	YYYY-MM-DD
`days`Opcional	integer (1–730)	window ending today when dates are omitted (default 30)
`filters`Opcional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`dimension`Opcional	string	sessionDefaultChannelGroup (default), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium
`limit`Opcional	integer (1–1000)	—

ga4_vs_google_ads

Lectura2 créditos

GA4 'Paid Search' channel (sessions, key events, revenue) next to Google Ads spend, clicks, conversions and CPA for the same last-N-days window, with the attribution gap. If Google Ads is not connected the Ads side is null with a note.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`days`Opcional	integer (1–90)	—

list_ga4_google_ads_links

Lectura1 créditos

Google Ads accounts linked to the GA4 property (customer id, personalization flag, creator, created time); linked=false flags a property with no link.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_conversion_events

Lectura1 créditos

Conversion (key) events defined on the property with counting method and custom/deletable flags.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_custom_dimensions

Lectura1 créditos

Custom dimensions on the property (parameter name, display name, scope).

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

Herramientas de escritura3 herramientas

create_ga4_conversion_event

Escritura2 créditos

Mark a GA4 event as a conversion (key event). Creates an approval item with a preview; applied via the Admin API only after approval and only with a connected account that has edit access.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`event_name`Obligatorio	string	—
`counting_method`Opcional	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éditos

Create a custom dimension (event, user or item scope). Goes through preview and approval before the Admin API call.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`parameter_name`Obligatorio	string	—
`display_name`Opcional	string	—
`scope`Opcional	EVENT \| USER \| ITEM	—
`description`Opcional	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éditos

Link a Google Ads account to the GA4 property so conversions flow to Google Ads. Goes through preview and approval; requires edit access on both sides.

Parámetro	Tipo	Descripción
`property_id`Opcional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`customer_id`Obligatorio	string	Google Ads customer id, 123-456-7890
`ads_personalization`Opcional	boolean	—

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