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

# Google Ads integration

> Connect Google Ads to Cometly to see spend next to tracked leads and sales, attribute each conversion to its ad, and send conversions back to Google.

When you connect Google Ads to Cometly, your campaigns, ad groups and ads appear in the Cometly **Ads Manager** with their spend, impressions and clicks. Cometly can then attribute each conversion to the ad that produced it.

That lets you see which Google campaign, ad group and ad produced each lead and sale, next to what it cost, and decide where to move budget. You can then send those conversions back to Google through the Conversion API (Cometly's server-side connection to the ad platform), so Google's reporting and bidding can use them too.

## Before you start

* **A Google login with access to the ad accounts.** Cometly lists the Google Ads accounts your login can open directly, plus the enabled accounts under any manager (MCC) account it can open. Test accounts are not listed.
* **The Administrator or Advertiser role** in the Cometly space (a space is a workspace in your Cometly account, with its own tracking, ad accounts and reports).
* **The Cometly pixel** (the tracking script that records your visitors) on your landing pages. See [Install the pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Connect Google Ads

**1. Open the Google Ads row**

In Cometly, click **Integrations** in the left sidebar and find **Google Ads** under **Ad Platforms**.

**2. Sign in with Google**

Click **Sign in with Google**. A pop-up window opens on Google. Choose your Google account and allow Cometly to access Google Ads. When the window comes back to Cometly, click **Done** to close it.

**3. Find your ad accounts**

The row expands and the **Ad Accounts** table lists every account your Google login can access. Use **Search ad account** to find one. Manager accounts carry an **MCC** badge, and the accounts under a manager are listed as their own rows.

**4. Connect each ad account to the space**

In the space the account should report into, click **Connect & Sync Data** next to it. You see **Ad Account Connected - Data will sync in 30-60 minutes**.

## Check it worked

The account now shows **Connected** with the space's name in the **Space** column, and it appears in the **Connected Google Ad Accounts** card, where everyone in the space can see who connected it. Within 30 to 60 minutes, your active campaigns start to appear in the **Ads Manager** with their spend.

> [!NOTE]
>
> Your Google sign-in is personal: only you can see and manage it. An ad account can be connected to one space at a time. See [Same ad account in two spaces](https://docs.cometly.com/support/troubleshooting/ad-accounts/same-ad-account-in-two-spaces.md).

## Add Cometly's URL parameters

Google Ads carries Cometly's parameters in a tracking template. Use the one that matches the campaign type.

**Search, Display, Discovery, Demand Gen, Shopping**

```text theme={null}
{lpurl}?comet_source=google&comet_network={network}&comet_campaign={campaignid}&comet_ad_group={adgroupid}&comet_ad_id={creative}&comet_keyword={keyword}
```

**Performance Max**

```text theme={null}
{lpurl}?comet_source=google&comet_network={network}&comet_campaign={campaignid}&comet_ad_group={adgroupid}&comet_ad_id={creative}&comet_keyword={keyword}&comet_type=smart
```

**Video**

```text theme={null}
{lpurl}?comet_source=google&comet_network=ytv&comet_campaign={campaignid}&comet_ad_group={adgroupid}&comet_ad_id={creative}&comet_keyword={keyword}
```

![Setup step 4, Add URL parameters to your ads, with Google Ads selected, showing the three tracking templates for Search, Performance Max and Video, each with a Copy Tracking Template button.](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/integrations/ad-platforms/google/02.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=e9cbc570ce6e840cc5a12f7ce360fbc2)

Paste the template into the **Tracking template** field of each campaign you want to track. [Google Ads URL parameters](https://docs.cometly.com/getting-started/url-parameters.md#google-ads-url-parameters) walks through it click by click. To copy the templates in Cometly, open **Setup**, step 4 **Add URL parameters to your ads**, choose **Google Ads** under **Select integration** and click **Copy Tracking Template**.

Cometly cannot add the template to Google Ads for you, but it checks your ads on every data refresh:

* It reads the tracking template and the final URL suffix on the ad, ad group, campaign and account, and applies the lowest level that has one. A template on an ad or ad group overrides the campaign's.
* An active ad whose landing page does not receive Cometly's parameters gets a red dot with the tooltip **UTM Setup Error** in the Ads Manager. Performance Max campaigns only pass with `comet_type=smart`. Call ads and app campaigns have no landing page, so they are never flagged.
* To see what each level carries, add the **URL Params** column from the **Columns** menu. An account-level template is shown above the table, next to **Account URL Params:**.

To fix a flagged ad, see [Fix UTM Setup Errors](https://docs.cometly.com/support/troubleshooting/url-parameters/utm-setup-errors.md).

## Send conversions back (Conversion API)

The **Google** section of the Conversion API (**Events Manager**, then the **Conversion API** tab) sends your Cometly events to Google Ads as offline conversions. You create offline conversion actions in Google Ads, turn on data sharing, and map each action to a Cometly event with a rule: **Send all events** or **Only send attributed events**. See [Configure the Google Conversion API](https://docs.cometly.com/guides/conversion-api/google.md).

## What to expect after connecting

* **Data.** Active campaigns start populating within 30 to 60 minutes. After that, Cometly refreshes Google Ads data every 30 minutes and pulls each of the previous four days again twice a day, so Google's later adjustments are captured.
* **Campaigns.** New campaigns are picked up automatically while **Auto-track new campaigns** is on (**Settings**, then **Campaign tracking** under **Workspace**). If a campaign that was already running is missing, see [Manually turn on tracking](https://docs.cometly.com/support/troubleshooting/ad-data/manually-turn-on-tracking.md).
* **Status.** The row shows **Connected**, or **Connection Issue, Resync Required** when Cometly cannot load your ad accounts from Google: click **Resync** to sign in again (see [Ad data not syncing](https://docs.cometly.com/support/troubleshooting/ad-data/ad-data-not-syncing.md)). **Last Synced** is the last time you signed in to Google from this row, not the time of the last data refresh.
* **Disconnect.** At the top of the expanded row it removes your Google profile, and ad data stops tracking immediately in every space that uses its ad accounts. Next to one ad account it removes only that account from its space.

## Troubleshooting

### You received an "Action Required" notification

When a sync fails, Cometly posts a notification in the space and sends it by email. Each one has its own fix:

| Notification | What it means | What to do |
| - | - | - |
| **Action Required: Resync Google Connection** | Google no longer accepts the sign-in made by the user named in the message. | That user clicks **Resync** on the **Google Ads** row and signs in again. |
| **Action Required: Restore Google Account Access** | The connected Google user lost permission on that ad account. | Restore the user's access in Google Ads, or connect a Google user who has it. Resyncing does not help. |
| **Action Required: Reactivate Your Google Ad Account** | Google reports the ad account as not active. | Reactivate it in Google Ads (usually billing setup or reopening it). |
| **Action Required: Unblock Your Google Login** | 2-Step Verification is now mandatory and the connected Google account does not have it on. | Turn on 2-Step Verification for that Google account. |

Syncing resumes on its own after the fix. You then get **Google Connection Restored**, and the last 48 hours of data are restored automatically.

### An ad account is missing from the list

Sign in with a Google login that can open the account, directly or through a manager account, then click **Resync**. An account that already shows **Connected** with another space's name must be disconnected there first.

### Ads show a UTM Setup Error

Look for a different template lower down: see [Check for Google tracking templates at the ad group or ad level](https://docs.cometly.com/support/troubleshooting/url-parameters/google-tracking-template-ad-group-level.md). For Shopping ads, see [Fix URL parameters in Google Merchant Center](https://docs.cometly.com/support/troubleshooting/url-parameters/google-merchant-center-url-parameters.md).

## Frequently asked questions

### Does Cometly import historical Google Ads data?

No. Cometly tracks a campaign from the moment its tracking is turned on, and from that point forward, so campaigns are not tracked retroactively. To turn on tracking for campaigns that were already running, see [Tracking historical ad data](https://docs.cometly.com/support/troubleshooting/ad-data/historical-ad-data.md).

### How do I remove Cometly's access to my Google Ads account?

In Cometly, click **Disconnect** at the top of the expanded **Google Ads** row to remove your Google profile. To revoke the access on Google's side as well, delete the Cometly connection in your Google Account settings. See [Remove Cometly access from your Google Ads account](https://docs.cometly.com/support/troubleshooting/ad-data/remove-google-ads-access.md).

### Why don't Cometly and Google Ads conversion numbers match?

When you send conversions through the Conversion API, Google Ads reports each conversion on the date of the click, while Cometly reports it on the date the person converted. Google can also take 12 to 48 hours to process conversions it receives. Expect small differences even after that. See [Google Ads conversion differences](https://docs.cometly.com/support/troubleshooting/conversion-api/google-ads-conversion-differences.md).

## Next steps

* [Add Cometly's tracking template to your Google campaigns](https://docs.cometly.com/getting-started/url-parameters.md)
* [Configure the Google Conversion API to send conversions back](https://docs.cometly.com/guides/conversion-api/google.md)
* [Review your Google campaigns in the Ads Manager](https://docs.cometly.com/guides/ads-manager/overview.md)
* [See how often ad data updates in Cometly](https://docs.cometly.com/support/troubleshooting/ad-data/data-update-frequency.md)
* [Contact support](https://docs.cometly.com/support/contact.md) if a fix above does not work. Include the name of the Google Ads account, the status on the **Google Ads** row and the title of any notification you received.

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.