Skip to content
AdlyseDocs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
list_ad_accountsget_dashboard_snapshotget_impact_analysisget_competitor_pressurelist_guidelinesget_brand_kitupdate_brand_kitimport_brand_kit_from_websitesave_brand_assetget_guidelinelist_suggestionsget_suggestionget_strategy_sessionlist_strategy_claimslist_strategy_proposalsget_creative_insightslist_watched_competitorslist_competitor_adswatch_competitorunwatch_competitorlist_audit_eventsga4_list_propertiesga4_run_reportlist_organic_propertiesget_organic_overviewget_organic_page_metricsinspect_pageget_organic_performanceget_site_inventorycheck_site_healthget_ai_visibilitylist_ai_visibility_answersget_cited_pageslist_ai_visibility_promptsupsert_ai_visibility_promptsrun_ai_visibility_checksget_growth_evidencelist_site_connection_optionslist_site_key_eventssave_site_sourceremove_site_sourceresync_site_sourceupdate_growth_deliveryget_growth_deliveryget_geo_workspaceupdate_geo_workspacelist_competitorsupdate_competitorscombine_competitor_listsget_search_workspaceupdate_search_monitoringplan_topic_workreview_search_findingget_keyword_researchstart_keyword_researchadd_keyword_research_terms
adlyse-ads
adlyse-workflows
adlyse-admin
adlyse-all
  1. Overview
  2. adlyse-insights

ga4_run_report

Run a Google Analytics 4 report: site-side sessions, users and conversions.

This is the OTHER side of the ad platforms. Where a platform reports the clicks it billed you for, GA4 reports the sessions that actually arrived, and the gap between them is where auto-tagging, redirects and consent banners hide. Use it to check an ad platform’s claim against the site, never as a second source for the same number.

Dates accept GA4’s own relative forms (28daysAgo, yesterday, today) as well as YYYY-MM-DD. Metric and dimension names are GA4’s, not any ad platform’s: sessions not clicks, sessionSource / sessionMedium / sessionCampaignName for attribution.

Reports are read-only; no GA4 settings or events are changed. Scope is the connected Analytics account’s selected properties. This is a bounded report, not a paginated export: narrow dates or dimensions when truncated and never total a partial result as the complete report. Returns {rows, row_count, total_rows, truncated, metadata}. total_rows is GA4’s own count, so a truncated report says so rather than looking complete.

Parameters#

NameTypeRequiredDefaultDescription
property_idstringyesGA4 property id, from ga4_list_properties.
metricsstringyesJSON array of GA4 metric names, e.g. [“sessions”,“totalUsers”].
dimensionsstringno""Optional JSON array of GA4 dimension names, e.g. [“sessionSource”,“sessionMedium”].
start_datestringno"28daysAgo"GA4 date or relative date (default 28daysAgo).
end_datestringno"yesterday"GA4 date or relative date (default yesterday).
limitintegerno100Max rows (1-2000, default 100).

Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.

Previousga4_list_propertiesNextlist_organic_properties