> ## 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.

# Configure the Google Conversion API

> Set up the Google Conversion API in Cometly to send your tracked leads and sales to Google Ads as offline conversions, mapped to your conversion actions.

Cometly's Google Conversion API sends your tracked events (leads, sales and other conversions) into Google Ads as offline conversions. It is a server-side connection: you create the offline conversion actions in Google Ads, then map each one to a Cometly event. Cometly does the uploads for you, so you never import a file or connect a data source in Google Ads.

Set up the Google Conversion API when you want Google Ads to see the conversions that happen after the click, such as a qualified lead or a closed deal. Google can then report on those conversions, and you can point a campaign's bidding at them with a custom goal.

> [!NOTE]
>
> Make sure Enhanced conversions for leads is turned on in your Google Ads account. It lets Google match conversions by email and phone when there is no click ID. [Follow the steps in this article](https://docs.cometly.com/support/troubleshooting/conversion-api/google-enhanced-conversions-for-leads.md) to improve your Google event match rate.

## Why use the Google Conversion API

* Send all events, not just Google-attributed ones, so Google's AI has more to learn from.
* Each conversion carries the contact details Cometly has collected for that visitor (hashed email and phone), plus the Google click ID when there is one.
* Better match quality gives Google better signals for bidding and reporting.

Other tools send only the data available at the moment of conversion. Cometly builds a profile for each visitor over time and sends the most complete data it has when the event happens.

[Feeding the ad platform's AI with accurate data](https://www.loom.com/embed/1b4fcb623b17409ba6a2547ec21330e1)

## Before you start

* Connect your Google Ads account to the space (a space is a workspace in your Cometly account, with its own tracking, ad accounts and reports). See [Connect your ad platforms](https://docs.cometly.com/getting-started/connect-ad-platforms.md).
* Make sure your events are tracking accurately in Cometly. The Conversion API page recommends waiting at least 7 days after events start flowing before you turn data sharing on.

## Step 1: Create your offline conversion actions in Google Ads

To receive Cometly events in Google Ads, start by creating offline conversion actions.

1. Log in to Google Ads and go to **Goals > Conversions > Summary**.

   ![Google Ads side menu with Goals selected and Summary highlighted under Conversions](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/01.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=301d1b5e6e862b4f3f5cf15268823e49)

2. Click **+ New conversion action**.

   ![Google Ads Conversions Summary page with an arrow on the New conversion action button](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/02.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=03c6992c10bbc654c1264aa0a0237c00)

3. Choose **Import**, then **CRMs, files, or other data sources**.

4. Under **Data source**, select **Skip this step and set up a data source later**. You do not need to create or configure a data source. Cometly sends the data once your events are mapped.

> [accordion] Configure the conversion action settings
>
> Name the conversion action anything you want, for example "Qualified Lead" or "Closed Deal". The name is for your own reporting.
>
> Choose a **goal category** that best matches your event, such as "Qualified lead", "Purchase" or "Submit lead form".
>
> Next, choose whether the conversion is **Primary** or **Secondary**:
>
> * Use **Secondary** if your campaigns are set to **account-level goals**. This stops the new conversion from affecting existing campaign optimization.
> * Use **Primary** only if your campaigns use **campaign-specific goals** and you want this conversion to be part of bidding optimization.
>
> **Not sure what your campaign is using?** Go to your campaign settings and check the "Goals" section:
>
> * If it says **Account goals**, choose **Secondary**.
>
> * If it uses **Campaign-specific goals**, you can choose **Primary** if you want.
>
> > [accordion] How to check if you are using account goals or campaign-specific goals
> >
> > [How to check if you are using account goals or campaign specific goals](https://www.loom.com/embed/8db87a42f60146d0aba0ebb922d908cf)
>
> > [!TIP]
> >
> > If Google Ads does not let you choose Secondary, try a different goal category. Some categories are part of your default account goals and do not offer a secondary option. For example, instead of "Submit lead form", try "Other" or "Qualified lead".
>
> In the example below, we selected "Qualified lead" and set it as a **Secondary** conversion action that is not used for bidding optimization.
>
> ![Google Ads conversion action form: Qualified lead category, Secondary action selected, conversion name filled in](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/04.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=04332314b18f9fdb8c884a27c5641af9)
>
> #### Value settings
>
> This setting defines how Google Ads values your conversions.
>
> If Cometly is not sending a value:
>
> * Choose "Don't use a value" (not recommended).
> * Or choose "Use the same value for each conversion" and enter a static number (for example \$50 per lead).
>
> If Cometly is sending a value:
>
> * Choose "Use different values for each conversion".
> * Enter a default fallback value (for example \$650) so conversions still track in the rare case that no value is received.
>
> #### Count settings
>
> This setting controls how many conversions are counted per interaction:
>
> * Choose "One" for leads, sign-ups and similar actions (only the first instance matters).
> * Choose "Every" for purchases or revenue-based actions (each conversion counts).
>
> #### Attribution settings
>
> * Set the click-through conversion window to 90 days.
> * Set the engaged-view conversion window to 3 days.
> * Choose "Data-driven" attribution.
>
> Click **Save** to finish setting up your conversion action.

> [!WARNING]
>
> If your campaigns are set to account goals and you create the conversion action as Primary, it is included in your account goals and can change how your current campaigns perform. Create this offline conversion action as Secondary.

### If Google shows you a different setup screen

If Google Ads shows you a newer conversion action setup view than the one above, follow these steps instead:

1. Go to the **Conversions** page.
2. Both **Conversions on a website** and **Conversions offline** are disabled. Click **Continue**.
3. On the next page, select the category you want to use for offline uploads. For example, if you select **Purchase**, click **Add an event to this category**.
4. Choose **Offline data sources**.
5. Click **Settings** next to it and adjust the conversion settings as described above.
6. Click **Done**, then **Save and continue**.

Then check that the offline conversion action was created.

## Step 2: Create a custom goal in Google Ads

After your offline conversion action is set up, group it into a custom goal so you can use it at the campaign level.

A custom goal groups one or more conversion actions under a single objective that you assign to specific campaigns. Use it when you want different campaigns to optimize for different outcomes.

1. Scroll to the bottom of the Conversions Summary page in Google Ads (**Goals > Conversions > Summary**, as in Step 1).

2. Click **Add custom goal**.

   ![Google Ads Conversions Summary page with the Custom goals section and the Add custom goal link highlighted](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/05.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=ddc71edb3765cdaee97d168ee297685d)

3. Name your custom goal, select the secondary offline conversion action you want to associate with it, and click **Save**.

   ![Google Ads Create custom goal dialog with a goal name entered and one conversion action ticked](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/06.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=001769d2b79eabae219e91bb3846a5e5)

Once saved, the custom goal is available in your campaign settings, so each campaign can focus on its own conversion priority: demo bookings, closed deals, purchases or qualified leads.

## Step 3: Turn on data sharing in Cometly

1. In Cometly, click **Events Manager** in the sidebar, then open the **Conversion API** tab.

   ![Cometly Conversion API page with arrow 1 on Events Manager in the sidebar and arrow 2 on the Conversion API tab, above the platform rows from Meta to Reddit](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/07.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=cf9befcad2f04fbd8583d265b3004855)

2. Click the **Google** row to expand it.

3. Under **Manage data sharing**, select **Turn on data sharing**. The change is saved straight away and the row's badge switches to **Active**.

4. Expand **Setup Offline Google Conversions**, read the five statements, and click **Acknowledge**. You confirm that:

   * You have read this setup guide.
   * The offline conversion actions you created are set to secondary action optimization, not primary.
   * You will wait until you have 35 to 50 conversions on the secondary offline conversion action before testing Google campaigns with the custom goal.
   * Your Cometly account is tracking events accurately. If you turn data sharing on before it is, you send inaccurate data to Google.
   * You are responsible for the results of changing conversion goals on your campaigns, and you understand it can affect campaign performance.

   You acknowledge once per space. The account picker and the mapping table appear after you do.

## Step 4: Map Cometly events to Google conversion actions

The mapping tells Cometly which tracked event to send to each Google offline conversion action.

1. Under **Google Ads account**, select the ad account you want to map. Cometly loads that account's offline conversion actions (the ones created with **Import > CRMs, files, or other data sources**). If you see "Selected account doesn't contain compatible actions.", go back to Step 1 and create one.

2. For each row under **Google Conversion Actions**, pick the event to send under **Cometly events**. Leave it on **Do not map** for actions you do not want Cometly to send to.

   ![Expanded Google row with data sharing turned on, the Acknowledged badge, a Google Ads account selected, and the mapping table with its Google Conversion Actions, Cometly Events and Rule columns](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/08.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=367fcd15cf21ac620c27bb66de8c345c)

3. For each mapped row, choose a **Rule**:

   * **Send all events**: sends every occurrence of the event to this Google Ads account, even when it is not attributed to one of its ads. Events without a usable Google click ID are sent with the contact's hashed email and phone instead. This gives Google's AI the most data to learn from.
   * **Only send attributed events**: sends the event only when Cometly attributed it to an ad in this Google Ads account and it carries that account's click ID.

4. Click **Save** at the bottom of the mapping table.

   ![Bottom of the Google mapping table, with mapped rows, one row left on Do not map, and an arrow pointing at the Save button](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/09.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=9b5c4fb26a31634596506d5f3780d695)

If you have more than one Google Ads account connected to the space, select each one in turn and map it separately.

Cometly now sends tracked events to the mapped Google conversion actions.

> [!WARNING]
>
> **Processing time.** Cometly sends each conversion to Google about 15 minutes after the event is tracked. Google can then take up to 12 hours to process and display it.

## Step 5: Accumulate 35 to 50 conversions, then launch a campaign with the custom goal

[Accumulating data on your conversion action](https://www.loom.com/embed/c443438025b146c8a82cb14981d66afb)

1. **Accumulate conversions.** Wait until Google has received 35 to 50 conversions through your offline conversion action.

2. **Duplicate or create a campaign.** If you have a successful campaign, duplicate it. If you have no campaigns, create a new one.

3. **Set the campaign goal.** On the duplicated or new campaign, set the campaign goal to your custom goal.

   Go to your campaign settings and click **Edit in settings**:

   ![Google Ads campaign overview with an arrow on the Edit in settings link](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/10.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=bb100336d86d8dd68f0c40a9a0817909)

   Select **Use campaign-specific goal settings** and choose your custom goal:

   ![Google Ads campaign Goals setting with Use campaign-specific goal settings selected and a custom goal chosen](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/google/11.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=5ea44d8d7664a0a3bca7db8ef8cdda56)

4. **Leave existing campaigns alone.** Do not change the campaign goals of your existing Google campaigns. Changing them can hurt their performance.

5. **Monitor the new campaign.** Check that it works and starts accumulating data.

6. **Move other campaigns over carefully.** Once the new campaign has gathered enough data and shown good results, you can consider switching other campaigns to the custom goal.

## Check it worked

In Cometly, the **Google** row on the **Conversion API** tab shows the **Active** badge. In Google Ads, open **Goals > Conversions > Summary**: conversions start to appear on your offline conversion action once Google has processed them, which can take up to 12 hours after Cometly sends them.

## Why Cometly and Google Ads numbers differ

When you use the Conversion API, it is normal to see differences between the conversion data in Cometly and in Google Ads. Each platform processes and reports events differently.

* **Google Ads takes time to process conversions.** It can take 12 to 48 hours to fully process conversions sent through the API, so recent conversions may not show up right away.
* **Google Ads reports conversions on the click date.** If someone clicks an ad today and converts later, Google logs the conversion at the time of the click.
* **Cometly reports conversions on the event date.** Cometly logs the conversion when the person actually converts.

Because of this, the data will never match exactly. Wait up to 48 hours for Google Ads to finish processing, and expect small differences after that. For more detail, see [Google Ads conversion differences](https://docs.cometly.com/support/troubleshooting/conversion-api/google-ads-conversion-differences.md).

## Frequently asked questions

### Can Cometly send a conversion to Google Ads without a gclid?

Yes, when the mapped row uses the **Send all events** rule. Cometly sends the event with the contact's hashed email and phone instead of the Google click ID (gclid). Google can only match it to an ad click if Enhanced conversions for leads is turned on and your Google tag captures the email or phone on your forms. See [Set up Google Enhanced Conversions for Leads](https://docs.cometly.com/support/troubleshooting/conversion-api/google-enhanced-conversions-for-leads.md).

### Why is my Google conversion action not showing in Cometly?

Cometly only lists enabled conversion actions that were created with **Import > CRMs, files, or other data sources**. Website conversion actions and removed actions do not appear in the mapping table. Create the action as described in Step 1, then select the Google Ads account again in Cometly.

### Why are my Cometly conversions not showing in Google Ads?

First allow for the delay: Cometly sends each conversion about 15 minutes after the event is tracked, and Google can take up to 12 hours to display it. If nothing arrives after that, check in Google Ads that you have accepted the customer data terms and that Enhanced conversions for leads is turned on, because Google rejects the uploads without them. [Set up Google Enhanced Conversions for Leads](https://docs.cometly.com/support/troubleshooting/conversion-api/google-enhanced-conversions-for-leads.md) walks through each setting.

## Next steps

* [Improve your Google match rate with Enhanced Conversions for Leads](https://docs.cometly.com/support/troubleshooting/conversion-api/google-enhanced-conversions-for-leads.md)
* [Understand why Cometly and Google Ads conversion numbers differ](https://docs.cometly.com/support/troubleshooting/conversion-api/google-ads-conversion-differences.md)
* [Exclude an event from the Conversion API](https://docs.cometly.com/guides/conversion-api/exclude-an-event.md)
* [Set up the Conversion API for another ad platform](https://docs.cometly.com/guides/conversion-api/overview.md)

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.