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

# Google Ads

> Connect Google Ads to your Macaly account

Google Ads is Google's advertising platform for running campaigns across Search, Display, YouTube, and more. Connect your account once and the agent can report on performance, adjust campaigns, and pull your ad data into dashboards inside your project.

<Callout icon="user">
  Available on all plans
</Callout>

## Why connect Google Ads

* **Turn your ad performance into a live dashboard.** Build a page that shows clicks, cost, and conversions for your active campaigns, updated daily, so your team always has current numbers without logging into Google Ads.
* **Query exactly the numbers you need.** Ask for a custom report using Google Ads' own query language, and pull it straight into your project instead of exporting spreadsheets.
* **Manage campaigns without switching tools.** Pause underperforming campaigns, adjust ad groups, or update budgets directly from the chat, and the change happens in your live account immediately.

## What you need

* A **Google Ads account** with at least one campaign. Create one at [ads.google.com](https://ads.google.com)

## Connect Google Ads to Macaly

<Steps>
  <Step title="Open Settings">
    Go to **Settings → Integrations** in your Macaly workspace.
  </Step>

  <Step title="Connect Google Ads">
    Find the Google Ads card in the list of apps and click the **Connect** button.
  </Step>

  <Step title="Authorize your account">
    A new window opens, where you'll be asked to sign in to Google. Once you approve access, you'll be redirected back to Macaly.
  </Step>
</Steps>

## Use Google Ads from the chat

Once connected, describe what you want and the agent handles the rest.

See how a campaign performed:

```
Show me how my "Summer Sale" campaign performed last month in
Google Ads, including clicks, impressions, and cost.
```

Act fast on underperformers:

```
Pause every campaign in my Google Ads account that spent more
than $500 last week without a single conversion.
```

Or build a live reporting dashboard:

```
Build a dashboard that pulls my active Google Ads campaigns and
shows clicks, cost, and conversions for each, updated daily.
```

```
Make a page where my team can see our Google Ads spend this
month, grouped by campaign, with a total at the top.
```

## What the agent can do in Google Ads

Check campaign performance, create and update campaigns and ad groups, build customer lists, run custom GAQL reports, and list the accounts you have access to.

## Good to know

* **You connect once.** Every project in your workspace reuses the same Google Ads connection.
* **Changes are real.** When you ask the agent to pause or update a campaign, it changes your live Google Ads account, so be specific about what you want.
* **Your account, your control.** The agent only acts when you ask it to. You can disconnect Google Ads anytime from **Settings → Integrations**.