> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Ads source

> Connect Google Ads to Chartcastr for automated campaign performance charts. Track spend, clicks, conversions, and ROAS with scheduled deliveries.

<Info>
  **Paid Feature** — Google Ads is available on all paid plans (Starter, Pro, Enterprise). [See pricing](https://chartcastr.com/pricing).
</Info>

## Overview

Use Google Ads as a data source for Chartcastr. Connect your account via OAuth and Chartcastr will pull campaign performance metrics to generate charts delivered automatically to your destinations.

## Setup

<Steps>
  <Step title="Connect your Google Ads account">
    In Chartcastr, go to **Settings → Sources** and click **Connect** next to Google Ads. You'll be redirected to Google to authorize access.
  </Step>

  <Step title="Select a customer account">
    After connecting, choose which Google Ads customer account to pull data from.
  </Step>

  <Step title="Select a metric">
    Choose which performance metric to track. Each metric becomes its own source.
  </Step>

  <Step title="Create a connection">
    Pick a destination and delivery schedule, then optionally enable AI summaries.
  </Step>
</Steps>

<Info>
  Chartcastr requests the Google Ads OAuth scope (`https://www.googleapis.com/auth/adwords`) when you connect this source.
</Info>

## Access Requirements

Google Ads account discovery depends on both OAuth scope and Google Ads account access.

* Your Google user must grant the Google Ads scope during OAuth.
* Your Google user must also have direct access to the Google Ads customer account, or direct access to a manager (MCC) account that can enumerate its child accounts.
* Seeing an account in the Google Ads web UI does not always mean the API will list it for this login. Manager hierarchies and inherited access can behave differently during account discovery.

## Troubleshooting

If Chartcastr says **No Google Ads accounts found** even though Google OAuth is connected:

1. Confirm the Google user granted Google Ads access during OAuth.
2. In Google Ads, open **Admin → Access and security** and verify that the same Google email has direct access to the advertiser account, or direct access to the relevant MCC account.
3. If access was added recently, reconnect Google Ads in Chartcastr and try again.
4. If you only have indirect visibility through someone else's manager hierarchy, the account may be visible in the Google Ads UI but still not discoverable by the API for your login.

## Available Metrics

Chartcastr supports **18 pre-built Google Ads metrics** across spend, delivery, conversions, and campaign overview.

<CardGroup cols={2}>
  <Card title="Spend & Efficiency" icon="dollar-sign">
    Daily spend, CPC, CPM, ROAS, cost per conversion, and spend by campaign.
  </Card>

  <Card title="Delivery" icon="eye">
    Impressions, clicks, CTR, search impression share, and impressions by campaign.
  </Card>

  <Card title="Conversions" icon="bullseye">
    Daily conversions, conversion value, conversion rate, and campaign breakdowns.
  </Card>

  <Card title="Overview" icon="chart-bar">
    Spend vs conversions combo chart and campaign performance comparison.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/google-ads/available-charts">
  See the full list of Google Ads metrics with chart types and descriptions.
</Card>

## Next Steps

<CardGroup cols={2}>
  <Card title="Slack destination" icon="slack" href="/integrations/destinations/slack">
    Deliver Google Ads charts to your Slack channels with AI summaries.
  </Card>

  <Card title="Email destination" icon="envelope" href="/integrations/destinations/email">
    Schedule campaign performance reports to any inbox.
  </Card>
</CardGroup>