---
title: GA4 Web Traffic Report Generation agent
slug: agent-platform/docs/ga4-web-traffic-report-generation-agent
docTags: 
createdAt: 2026-08-12T15:37:07.000Z
---

**GA4 Web Traffic Report Generation** is an agent in 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](docId:7fZ7-gpdPyJMT0jSx2cPh) for instructions.

## Install agent

:::hint{type="info"}
**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.](../../get-started/get-started-with-optimizely-opal-for-administrators.mdx)
:::

Install the agent from the **Directory**.

1. Go to **Directory > Agents**.
2. (Optional) Begin entering *GA4 Web Traffic Report Generation* or use the drop-down list filters to narrow the list.
3. Click **Install** on **GA4 Web Traffic Report Generation** to add it to your Mark instance.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ocB_1NpsN7Pvh5kn81ee1_install-ga4-web-traffic-report-generatiom-agent.png)

## Use the agent

In [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), 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](docId:1_VDSKJ_RG0FEQe0MCTv1). 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](docId:2HD0fUsIsfdek516VtN9l), drag and drop it into your workflow. See [Create a workflow agent](docId\:KWaI2TBwD38sN7p74exoy).

## Details

These are the default details of the **GA4 Web Traffic Report Generation** agent. After you [install the agent in your Mark instance](docId\:Xook__T0BRyE_J2n76_DJ), customize these details for your organization's needs. See [Manage agents](docId\:SSeNiblVMXwVvDR_lhtvI) 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`

### Additional details

The agent uses the following default configuration:

- **Inference level** – Pro. Provides maximum reasoning depth.
- **Files** – None.
- **Output** – Text.

:::hint{type="info"}
**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](docId\:X5U0kKD2azV5cIdNqwGNj).
:::