---
title: Google Ads Account Auditor agent
slug: agent-platform/docs/google-ads-account-auditor-agent
docTags: 
createdAt: 2026-08-12T15:37:11.000Z
---

Google Ads Account Auditor is an agent in Agent Platform. It performs a full Google Ads account audit. The audit covers baseline metrics, n-gram theme analysis, search term waste, duplicate keywords, best performers, Strengths, Weaknesses, Opportunities, and Threats (SWOT) analysis, and a prioritized action plan.

- **Challenge** – Manually auditing a Google Ads account for wasted spend, underperforming keywords, and missed opportunities takes hours.
- **Agent outcome** – The agent produces a single-page Hypertext Markup Language (HTML) audit report. The report includes a baseline scorecard, n-gram themes, budget leeches, best performers, a SWOT grid, and a ranked action plan with estimated monthly savings.
- **Value** – The agent recovers wasted ad spend and surfaces high-impact optimizations in minutes instead of hours.

## Prerequisites

The Google Ads Account Auditor agent uses the [Google Ads connector tools](docId\:JiNgmE32vFNO8mGMuRB9Z). Ensure the following before using the agent:

- A Mark administrator has [installed and connected the Mark Google Ads Tool in Optimizely Connect Platform (OCP).](docId\:JiNgmE32vFNO8mGMuRB9Z)
- You have [authenticated with Google Ads](docId\:JiNgmE32vFNO8mGMuRB9Z) in Mark.

## 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 *Google Ads Account Auditor* or use the drop-down list filters to narrow the list.
3. Click **Install** on **Google Ads Account Auditor** to add it to your Mark instance.

## Use the agent

In [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), enter *@google\_ads\_account\_auditor* and provide the following details:

- `Reporting Period` – The audit date range. Use a minimum of 30 days. For example, *Last 30 days*, *Last 60 days*, or *This quarter*.
- `Primary Goal` – The primary success metric. Valid options are *Conversions*, *Revenue / ROAS* (return on ad spend), and *Leads*.
- (Optional) `Campaign Filter` – Scope the audit to specific campaigns. Leave blank for all active campaigns.
- (Optional) `Waste Threshold` – Minimum spend with zero conversions to flag as a budget leech. The default is $50. Increase the threshold for high-spend accounts.

The agent delivers a single-page HTML [canvas](docId:1_VDSKJ_RG0FEQe0MCTv1). The canvas contains a baseline scorecard, n-gram theme analysis, search term waste identification, best performers, a SWOT grid, and a prioritized action plan with estimated monthly savings.

To use the Google Ads Account Auditor 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 for the Google Ads Account Auditor agent. After you [install the agent in your Mark instance](docId\:aBw3H8lx_W-qEBMP_tVJm), customize these details for your organization's needs. See [Manage agents](docId\:SSeNiblVMXwVvDR_lhtvI) for instructions.

### Input variables

The Google Ads Account Auditor agent takes the following input:

- `Reporting Period`
- `Primary Goal`
- (Optional) `Campaign Filter`
- (Optional) `Waste Threshold`

### Tools

The Google Ads Account Auditor agent uses the following tools to process your request:

- `google_ads_list_accessible_customers`
- `google_ads_get_account_info`
- `google_ads_get_campaigns`
- `google_ads_get_search_terms`
- `create_canvas`
- `code_execute`
- `list_files`
- `read_file`
- `read_file_content`
- `retrieve_file_from_gcs_uri`
- `search_files`

The Google Ads Account Auditor agent uses the [Google Ads connector tools](docId\:JiNgmE32vFNO8mGMuRB9Z). See the [Prerequisites](docId\:aBw3H8lx_W-qEBMP_tVJm) section for information.

### 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).
:::