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

# Google Ads

> Manage your Google advertising

# Google Ads

Optima AI integrates with Google Ads, allowing you to manage ad campaigns through conversation.

## Connect Account

### First Connection

Tell AI you want to connect Google Ads:

```
Connect my Google Ads account
```

AI will guide you through the OAuth authorization process.

### MCC Account

If you use MCC (Manager Account) to manage multiple ad accounts:

```
Connect my Google Ads MCC account
```

After connecting, you can manage all sub-accounts under MCC.

## View Ads

### Campaign List

```
Show my ad campaigns
```

```
Show active ads
```

### Campaign Details

```
Show details for the "Spring Sale" campaign
```

### Ad Performance

```
How is the "Spring Sale" campaign performing
```

Metrics returned include:

* **Impressions**: Times the ad was seen
* **Clicks**: Times users clicked the ad
* **CTR (Click-through Rate)**: Clicks / Impressions
* **Spend**: Amount spent on ads
* **Conversions**: Completed target actions

## Manage Ads

### Pause Campaign

```
Pause the "Spring Sale" campaign
```

### Enable Campaign

```
Enable the "Spring Sale" campaign
```

### Adjust Budget

```
Set the "Spring Sale" daily budget to $50
```

<Warning>
  Budget changes take effect immediately. Please proceed carefully.
</Warning>

## @ Reference Ads

Use `@` to reference campaigns in conversation:

```
@Spring-Sale How can I improve this campaign's conversion rate
```

## Ad Analysis

### Performance Comparison

```
Compare "Spring Sale" and "Summer Clearance" performance
```

### Trend Analysis

```
Ad performance trends for the last 30 days
```

### Optimization Suggestions

```
Give me suggestions to optimize my ads
```

AI will provide personalized suggestions based on your ad data.

## Ad Preview

When viewing ads, a Google Search ad-style preview is displayed:

* **Headlines**: Ad titles (up to 3 lines)
* **Description**: Ad description text
* **URL**: Display URL and final destination URL

<Note>
  Preview is for reference only. Actual display depends on Google.
</Note>

## FAQ

<AccordionGroup>
  <Accordion title="How do I disconnect Google Ads?">
    Tell AI: "Disconnect Google Ads", or manually disconnect in settings.
  </Accordion>

  <Accordion title="What Google Ads features are supported?">
    Currently supports viewing campaigns, performance data, pausing/enabling ads, and adjusting budgets. Creating new campaigns is coming soon.
  </Accordion>

  <Accordion title="How often is data updated?">
    Ad data syncs hourly. Performance data may have 3-4 hour delays (Google's official limitation).
  </Accordion>
</AccordionGroup>