> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ppc/google-ads.md).

# Google Ads

Google Ads is Google's online advertising platform for creating and managing paid search, display, video, and shopping campaigns. By connecting Google Ads to Coupler.io, you can automatically export your advertising data to spreadsheets, BI tools, or databases without manual work.

## Why connect Google Ads to Coupler.io?

* **Automate reporting** — Schedule regular data refreshes so your dashboards and spreadsheets always have the latest campaign performance data.
* **Combine with other sources** — Merge Google Ads data with Google Analytics, Facebook Ads, CRM, or e-commerce data for a full-funnel view of your marketing spend and results.
* **Access 30+ report types** — Go beyond what the Google Ads interface shows. Pull campaign, keyword, ad group, geographic, demographic, and shopping performance reports — plus structural data like campaign budgets and labels.
* **Flexible destinations** — Export to AI tools, Google Sheets, Excel, BigQuery, Looker Studio, or other supported destinations.

## Prerequisites

Before connecting, make sure you have:

* A Google account with access to at least one active **Google Ads account**
* **Standard** or **Admin** access to the ad account you want to pull data from
* A Coupler.io account

## Quick start

{% hint style="success" %}
Start with a **Campaign performance** report for the last 60 days, split by Date. This gives you a daily breakdown of spend, clicks, impressions, conversions, and other key metrics across all your campaigns. Proceed to the Data sets or AI agent to get a quick snapshot and verify everything is connected correctly.
{% endhint %}

## How to connect

Google Ads uses **OAuth authentication** — you sign in with your Google account directly.

{% stepper %}
{% step %}
In Coupler.io, create a new **data flow** and select **Google Ads** as the source.\
Click **Connect** and sign in with your Google account.
{% endstep %}

{% step %}
Grant Coupler.io the requested permissions to access your advertising data.
{% endstep %}

{% step %}
Select the **ad account(s)** you want to pull data from.
{% endstep %}

{% step %}
Choose a **report type** (see the most popular ones below).
{% endstep %}

{% step %}
Set your **date range**.
{% endstep %}

{% step %}
Choose your **destination** and run the import.
{% endstep %}
{% endstepper %}

### Reports overview

| Report type                 | Whatit contains                                                                  | When to use it                                                     |
| --------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| **Campaign performance**    | Spend, clicks, impressions, conversions, and other metrics at the campaign level | Overall campaign analysis, budget tracking, performance dashboards |
| **Keywords performance**    | Keyword-level metrics for search campaigns                                       | Analyzing which keywords drive traffic and conversions             |
| **Ad group performance**    | Performance metrics at the ad group level                                        | Comparing ad groups within campaigns                               |
| **Ad performance**          | Individual ad creative performance                                               | Identifying top-performing ads and creative variations             |
| **Asset group performance** | Performance data for asset groups (Performance Max)                              | Evaluating Performance Max campaign components                     |
| **Custom GAQL**             | Any data available via Google Ads Query Language                                 | Advanced users who need custom report structures                   |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/ppc/google-ads.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
