Référence des outils — Données & site

Google Analytics 4 tools

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

Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont le texte anglais d'origine vu par l'assistant.

Outils de lecture10 outils

list_ga4_properties

Lecture1 crédits

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

Cet outil ne prend aucun paramètre.

ga4_report

Lecture1 crédits

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.

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

ga4_overview

Lecture1 crédits

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.

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Facultatif	string	YYYY-MM-DD
`end_date`Facultatif	string	YYYY-MM-DD
`days`Facultatif	integer (1–730)	window ending today when dates are omitted (default 30)
`compare_previous`Facultatif	boolean	—

ga4_realtime

Lecture1 crédits

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

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`dimensions`Facultatif	array<string>	realtime dimensions: unifiedScreenName (default), country, city, deviceCategory, eventName, platform
`metrics`Facultatif	array<string>	realtime metrics: activeUsers (default), screenPageViews, eventCount, keyEvents
`limit`Facultatif	integer (1–1000)	—

ga4_landing_pages

Lecture1 crédits

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

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

ga4_channel_report

Lecture1 crédits

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

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

ga4_vs_google_ads

Lecture2 crédits

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.

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`days`Facultatif	integer (1–90)	—

list_ga4_google_ads_links

Lecture1 crédits

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

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_conversion_events

Lecture1 crédits

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

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_custom_dimensions

Lecture1 crédits

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

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

Outils d'écriture3 outils

create_ga4_conversion_event

Écriture2 crédits

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.

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`event_name`Obligatoire	string	—
`counting_method`Facultatif	ONCE_PER_EVENT \| ONCE_PER_SESSION	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_ga4_custom_dimension

Écriture2 crédits

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

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`parameter_name`Obligatoire	string	—
`display_name`Facultatif	string	—
`scope`Facultatif	EVENT \| USER \| ITEM	—
`description`Facultatif	string	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_ga4_google_ads_link

Écriture2 crédits

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.

Paramètre	Type	Description
`property_id`Facultatif	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`customer_id`Obligatoire	string	Google Ads customer id, 123-456-7890
`ads_personalization`Facultatif	boolean	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.