GA4 Web Traffic Report Generation agent
GA4 Web Traffic Report Generation is an agent in Mark (Optimizely Agent Platform). It pulls Google Analytics 4 (GA4) traffic data. The agent delivers an executive-ready Hypertext Markup Language (HTML) report with period-over-period metrics, top pages, channel breakdowns, and recommended actions.
- Challenge – Pulling multiple reports manually to understand traffic trends, user behavior, and conversion performance is time-consuming and difficult.
- Agent outcome – Surfaces traffic trends, user behavior, and conversion performance. The agent automatically compares period-over-period performance and identifies growth signals and optimization opportunities.
- Value – Insights are delivered in an executive-ready format, accelerating data-driven decision-making.
Prerequisites
A Mark administrator must configure the Google Analytics (GA4) connector tools using Optimizely Connect Platform (OCP) before you use the GA4 Web Traffic Report Generation agent. See the GA4 connector tools documentation for instructions.
Install agent
Note
Mark Administrators, Agent Builders, and users with the Add, edit, and install specialized agents attribute for a custom role can add agents to their organization's Mark instance. See Add users and set permissions.
Install the agent from the Directory.
- Go to Directory > Agents.
- (Optional) Enter GA4 Web Traffic Report Generation or use the drop-down list filters to narrow the list.
- Click Install on GA4 Web Traffic Report Generation to add it to your Mark instance.
Use the agent
In Mark chat, enter @ga_traffic_reporter and provide the following details:
- (Optional) Date Range – Specify a date range in YYYY-MM-DD to YYYY-MM-DD format. If you omit the range, the agent defaults to the last 30 complete days, excluding today.
- (Optional) Domain – Enter the hostname to filter results by (for example, optimizely.com). Leave blank to include all domains.
The agent delivers a self-contained HTML performance report as a canvas. The report includes period-over-period metrics, top pages by sessions, channel attribution, and a prioritized action plan.
To use the GA4 Web Traffic Report Generation agent in a workflow agent, add it to your workflow. See Create a workflow agent.
Default agent details
These are the default details of the GA4 Web Traffic Report Generation agent. After you install the agent in your Mark instance, customize these details for your organization's needs. See Manage agents for instructions.
Input variables
The GA4 Web Traffic Report Generation agent takes the following input:
- (Optional) Date Range
- (Optional) Domain
Tools
The GA4 Web Traffic Report Generation agent uses the following tools internally to process your request:
- run_report
- create_canvas
- get_custom_dimensions_and_metrics
- get_dimensions
- get_metrics
- get_property_id
- lookup_dimension_metric_names
Default configuration
The agent uses the following default configuration:
- Inference level – Pro, which provides maximum reasoning depth.
- Files – None.
- Output – Text.
Note
If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.