Audit Google Ads Account
Connect to the Google Ads API, extract account data, and generate an AI-powered audit checklist covering configuration, governance, and conversions.
What Does This Workflow Do?
Performing an initial Google Ads account audit — the standard "Account Checklist" — is a fundamental yet repetitive and time-consuming task. This template automates 100% of this process.
By simply providing the account credentials, the workflow runs a comprehensive API sweep and uses an AI agent to cross-reference the current settings with market best practices. It delivers a ready-to-use diagnosis across three main fronts:
- Configuration: Validates time zone, currency, account status, and auto-tagging.
- Governance: Analyzes the access structure and account hierarchy (MCC).
- Conversions: Does a deep dive into tracking metrics, attribution models, conversion windows, and configured values.
How Does It Work?
The flow was designed to be highly efficient and require zero manual token maintenance:
- Automatic Authentication: A Code Node uses your Refresh Token to generate a brand new, valid Access Token on every single execution. No more manually refreshing expired tokens.
- Parallel Extraction (GAQL): The system makes three simultaneous HTTP requests to the Google Ads API to pull general account data, conversion settings, and access structure.
- Data Merge: The responses from the parallel requests are unified into a single, structured data package.
- AI Analysis: The AI agent analyzes all the raw JSON extracted from the account and writes an actionable, easy-to-read checklist.
| Step | Node Type | Purpose |
|---|---|---|
| 1 | Code | Generates a fresh OAuth2 Access Token |
| 2a | HTTP Request | Fetches general account info (currency, time zone, status, auto-tagging) |
| 2b | HTTP Request | Fetches conversion action settings |
| 2c | HTTP Request | Fetches account hierarchy and linked clients |
| 3 | Merge | Combines all API responses into one payload |
| 4 | AI Agent | Analyzes merged data and generates the audit checklist |
Who Is This For?
- Performance Agencies & PPC Managers: Streamline new client onboarding with an immediate, high-quality audit.
- Consultants: Generate quick and highly technical diagnostic reports for pitches or consulting sessions.
Prerequisites
To use this template, you will need to set up the following variables in your environment:
| Variable | Description |
|---|---|
| Developer Token | Your Google Ads API developer token |
| OAuth2 Client ID | The client ID from your Google Cloud OAuth2 credentials |
| OAuth2 Client Secret | The client secret from your Google Cloud OAuth2 credentials |
| OAuth2 Refresh Token | A valid refresh token for the target Google Ads account |
| Customer ID | The target account's Customer ID (e.g., 123-456-7890) |
What the Audit Covers
The AI-generated checklist evaluates each item using clear status indicators (OK, Attention, Problem, or Info) and is organized into three pillars:
- Configuration — Account name, currency, time zone, auto-tagging (gclid), tracking URL template, and account status.
- Governance — MCC structure, access hierarchy, partner badge status, and linked accounts.
- Conversions — For each conversion action: type, status, category, counting method, attribution model, default value settings, click-through and view-through windows, and inclusion in the main conversions column.
At the end, the report includes a summary with total items checked, a breakdown by status, and the top 3 priority actions to take.
Want to showcase your own workflows?
Become a Needle workflow partner and turn your expertise into recurring revenue.
