ActionGoogle Analytics 4Updated June 2026

How do I run a GA4 analytics report?

Short answer: Drop the "Google Analytics 4 → GA4 Run Report" action anywhere in your workflow, map the inputs from upstream nodes, and publish.

Use this action All 3 Google Analytics 4 actions

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Metric names metrics	array	Required	e.g. ["activeUsers","sessions"]
Dimension names dimensions	array	Optional	e.g. ["date","country"]
Start Date start_date	string	Optional	YYYY-MM-DD or 7daysAgo, yesterday
End Date end_date	string	Optional	—
Row Limit limit	string	Optional	—

Sample request

{
  "metrics": "{{trigger.metrics}}",
  "dimensions": "{{trigger.dimensions}}",
  "start_date": "YYYY-MM-DD or 7daysAgo, yesterday",
  "end_date": "{{trigger.end_date}}",
  "limit": "{{trigger.limit}}"
}

Returns

{
  "rows": [
    {
      "metricValues": [
        {
          "value": "1234"
        }
      ],
      "dimensionValues": [
        {
          "value": "20260511"
        }
      ]
    }
  ],
  "metadata": {
    "currencyCode": "USD"
  },
  "rowCount": 1,
  "metricHeaders": [
    {
      "name": "activeUsers",
      "type": "TYPE_INTEGER"
    }
  ],
  "dimensionHeaders": [
    {
      "name": "date"
    }
  ]
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about GA4 Run Report.

What does the GA4 Run Report action do in Google Analytics 4?

Standard date-range query with dimensions and metrics. For "weekly traffic digest to Slack" or "monthly board report on key KPIs" reporting workflows. 24-48h processing lag for fully-consolidated data.

What inputs does GA4 Run Report require?

Required: Metric names. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if Google Analytics 4 returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does GA4 Run Report support batch operations?

Yes. Run GA4 Run Report inside a Loop node to process arrays. Tiny Command handles Google Analytics 4's rate limits automatically so you don't have to throttle manually.

How do I run a GA4 analytics report?

The fields this action accepts.

Apps that pair well as the trigger for GA4 Run Report.

Questions about GA4 Run Report.

Other Google Analytics 4 actions.

Send ga4 run report from your workflows.