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

# Google Ads

> Synchronize your data with Google Ads to link leads and conversions back to campaigns.

The Google Ads integration uses the **Offline Conversions API**, allowing Octanist to automatically upload qualified and converted leads into Google Ads for better campaign optimization.

## Table of Contents

1. [Connect Your Google Ads Account](#1-connect-your-google-ads-account)
2. [Map Your Conversions](#2-map-your-conversions)
3. [Finalize Setup](#3-finalize-setup)

<iframe src="https://www.youtube.com/embed/Gb-4Cg_5nT4" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

***

## 1. Connect Your Google Ads Account

1. In the Octanist dashboard, navigate to **Integrations** and click **Add Integration**.
2. Go to **Ad Platforms** and click **Set Up** next to Google Ads.
3. If prompted, grant the required Google permissions.
4. Select the **Google Ads account** you want to connect (e.g., your company account).
5. Click **Continue**.

<Tip>
  If you've previously granted permissions, you'll skip the authorization screen and go straight to account selection.
</Tip>

***

## 2. Map Your Conversions

In this step, you'll link your Octanist lead stages to Google Ads conversion actions.

1. For each lead stage, either **select an existing conversion** from your Google Ads account or **create a new one**.
2. Map the following:
   * **Qualified Lead** → select or create the corresponding Google Ads conversion.
   * **Converted (Won) Lead** → select or create the corresponding Google Ads conversion.
3. Click **Next Step**.

<Tip>
  If you've already set up conversion actions in Google Ads, they'll appear here ready to select.
</Tip>

***

## 3. Finalize Setup

1. Give the integration an **internal name** so you can easily identify it later (e.g., *Company Name – Google Ads*).
2. Review the **advanced settings**:
   * **Enhanced Conversions for Leads** is enabled by default for improved match rates.
   * Enable **Backfill Existing Leads** if you want to retroactively upload leads that were qualified or converted before this integration was activated.
3. Click **Complete Setup**.

Your Google Ads Offline Conversions integration is now **active**. Octanist will automatically upload your qualified and converted leads to Google Ads.

***

## 4. Get Your Ad Spend in Octanist

The new Google Ads integration automatically syncs your **ad spend**, unlocking metrics like **cost per lead**, **cost per won lead**, and **ROAS** directly in your dashboard.

**Already using a legacy Google Ads integration?** Follow the steps below to migrate. The process takes approximately 2 minutes.

<iframe src="https://www.youtube.com/embed/fcXXEIK-lWU" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

1. Follow steps [1–3](#1-connect-your-google-ads-account) above to set up the new Google Ads integration.

   <Warning>
     When mapping your conversions, make sure the conversion names **exactly match** the ones you configured in your old integration.
   </Warning>
2. Once the new connection is active, return to **Integrations**.
3. **Delete your old Google Ads integration.** If you have set up multiple legacy integrations, make sure to **revoke all of them**.

Your ad spend will now sync automatically and your dashboard will start showing cost and ROAS metrics.

***

If you need assistance, reach out to [support@octanist.com](mailto:support@octanist.com).