# Google Ads Quick Start Guide

Optimize your Google Ads spend by attributing ad clicks to conversion and other key behaviors.

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Supports forwarding from the [Google Tag Manager Integration](https://documentation.freshpaint.io/integrations/google-tag-manager-integration)
* Refer to this destination as **Google AdWords New** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)
  * If you've configured multiple Conversion IDs, you can choose a specific one by suffixing the Conversion ID, such as: **Google AdWords New::123456789.** You can retrieve this value from the Google Ads configuration page for the Conversion ID of interest.  

{% hint style="info" %}
When no suffix is specified, all configured Conversion IDs are selected for inclusion / exclusion.
{% endhint %}

* Connection Modes:

<table><thead><tr><th align="right"> </th><th width="229" data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>true</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

{% hint style="info" %}
When using Server-Side connection mode you are using a Proxy Integration for Google Ads. This destination runs on Freshpaint's servers, but emulates a native installation of Google Universal Analytics Tag. That means the integration behaves the same as if you did a native installation of Google Universal Analytics Tag, but the data first flows through Freshpaint before it's sent to Google. [See our docs on proxy integrations for more information](https://documentation.freshpaint.io/reference/faqs/what-is-a-proxy-integration).
{% endhint %}

{% hint style="info" %}
If you’d like to send a server-side event to Google Ads (such as one generated from our [HTTP API](https://documentation.freshpaint.io/reference/developer/http-api), or an event from [CallRail](https://documentation.freshpaint.io/integrations/sources/callrail) or [Invoca](https://documentation.freshpaint.io/integrations/sources/invoca)), we recommend using the **Google Ads Conversions API** destination for the best results.

If you’d still prefer to use this Google Ads destination, please reach out to us at **<support@freshpaint.io>**, and we’ll assist you in configuring your server event.
{% endhint %}

## Getting Started

### What You'll Need

1. Your Google Ads Conversion ID
2. [Conversion Actions](https://support.google.com/google-ads/answer/12216226?hl=en) configured in your Google Ads account
3. Conversion Events configured in your Freshpaint account

### To set up Google Ads with Freshpaint, first follow these steps:

1. Get your Google Conversion ID. In your Google Ads account go to [Tools > Conversions](https://ads.google.com/aw/conversions).
2. Click on the relevant conversion action

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2Fgit-blob-f6d364a92df680001bbc9674253265be49d41050%2Fgoogle-ads-conversions-page.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Select Tag Setup

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2Fgit-blob-831cbcb557091b4a7733b3706a19001b8b4e43cc%2Fgoogle-ads-conversion-details.png?alt=media" alt=""><figcaption></figcaption></figure>

4. Select Use Google Tag Manager. This option will only be there for conversion actions created manually in Google Ads - click [here](https://support.google.com/google-ads/answer/12216226?hl=en#zippy=%2Cinstructions) for instructions on how to create this kind of conversion action in Google Ads.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2Fgit-blob-fe81906785ac712bbe07f7491300c7936194b0f8%2Fgoogle-ads-tag-setup.png?alt=media" alt=""><figcaption></figcaption></figure>

5. Get the Conversion ID from the instructions

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2Fgit-blob-4696f74e04a8fa4b62fcdd38e435c35747d75a13%2Fgoogle-ads-tag-instructions.png?alt=media" alt=""><figcaption></figcaption></figure>

6. Go to the [Google Ads configuration page](https://app.freshpaint.io/destinations/apps/google-ads) in Freshpaint.
7. Configure your Tag ID. Paste the value that you copied from the previous step.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2Fgit-blob-7e4d5d83bed503c4a51172410753ba35a4c64a12%2Fgoogle-ads-destination-config.png?alt=media" alt=""><figcaption></figcaption></figure>

8. **Configure your connection mode.** If you are a HIPAA customer, configure connection mode to server-side. If not, you may choose either connection mode. Learn more about Connection Modes [here](https://documentation.freshpaint.io/faqs/what-is-the-difference-between-client-side-and-server-side-connection-mode).
9. If you are NOT a HIPAA customer and have chosen client-side connection mode, you'll need to setup Conversion Labels from Google Adwords for the actions you want to attribute, as shown below. If you are a HIPAA customer, you can skip this step.

   ![Conversion Labels in Google Analytics](https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FXijCc4EJSAcO1SCcdXzy%2Fimage.png?alt=media\&token=c3458207-488a-4a68-834d-0b9e5439aa41)

   #### Add transformations that map your Freshpaint events to Conversion Labels:

   ![](https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FS2FSCjwOPmMJvTRWdA0p%2Fimage.png?alt=media\&token=58eae8d3-d5e5-4875-b1e1-74092edacadb)

### Next, you'll need to link your Freshpaint event to your Google Ads action

Each conversion action in Google Ads uses a conversion label to uniquely identify the conversion action. Follow these steps to link your Freshpaint event to your Google Ads Action:

1. Go to [Tools > Conversions](https://ads.google.com/aw/conversions) and click on the conversion action you want to link&#x20;
2. Select Tag Setup, then select the Use Google Tag Manager option&#x20;

   <figure><img src="https://lh3.googleusercontent.com/cPYV9ZtHJbSEyyRNHCFpRtdyEk_kHItrnVImCOHpGmR_oSs1FAYKIH7_vN8aYJxBn2RGXEEoHuC-3JRtqfRxmh-wrul6HX9KrvAwPoLedShzxzGODlRBgxEVm0iAmip-lSlre9Z1ErwsUOccO3q9Zmecag=s2048" alt=""><figcaption></figcaption></figure>
3. Copy the Conversion label under the instructions&#x20;

   <figure><img src="https://lh5.googleusercontent.com/ufPMd9VYAa3r8Bi-bwsG2J0Wl5TE6H1s0GV0CfoIC7pToHm0RDBOo7Paritntj-WysBcZ-j9u0yVWk9hmUKa2RtU-1rxwHjmxkpyZcU7m7a-_uqMozeiuj8v8SfrZ3eXcSuMkZNGEizOgnmQUJCHiHBz6w=s2048" alt=""><figcaption></figcaption></figure>
4. Attach the conversion label to the related event in Freshpaint by creating a Transformation in Freshpaint:
   1. Click on "Create New" in [Transformations](https://app.freshpaint.io/transformations)
   2. Click "Modify Data"
   3. Select your Freshpaint conversion event, select the Google Ads destination, then click Save & Add Transformations&#x20;

      <figure><img src="https://lh3.googleusercontent.com/4GAuD8jzPwE1minumD68XpqQnpz2aKQwTsRZbYyifg6czyoxPjOdOx6SjCN7EgG_spP_jO65PBUB4-NeFlWt26jqCkMIQM3XJ3OLSNZxOJVqCb059uWO33JP-Cwc9_F_1B-nTCPFw5F4wRE9t92Btdn2GA=s2048" alt=""><figcaption></figcaption></figure>
   4. Select the Send Constant Property transformation option, copy the Conversion label value, and send it as the conversion\_label property value&#x20;

      <figure><img src="https://lh4.googleusercontent.com/CNW7WAEz9cyVOahHp1Ff2EzMXP3iBuKeZPbTQsJwpPP_4Z15aWlk1ly0YGqxF-Xfnc5Geq5MSDOnAjfB8lKLK7yVROvLtgMMtTaeqIqdHJFtflwvnFjBF3daYSun5yBwCwqVHqFREtXqPvcXduzLVJFwbw=s2048" alt=""><figcaption></figcaption></figure>

### If you are a HIPAA account, you will need to add event properties to the allowlist. If you are not a HIPAA account, you can skip this step.

1. Configure the [HIPAA allowlist](https://app.freshpaint.io/destinations/apps/google-ads/phiallowlist)
2. Edit the Event Properties allowlist and add the following properties:

   1. conversion\_label
   2. $gclid

   <figure><img src="https://lh3.googleusercontent.com/mAb7tJPlmE5cTF1vVYvhKyQ44IRCZYl0vi2SqL96el8gJjZ-5yFdhbLZFG38hvZiWs97o_KkXP1wQd7RwOA_RNdAvH_OJUOJszgiIfQyF7bJAGH2iy2To6fBD6gui9WrIpEZ7RF_Baeby9oHTACra3FX2Q=s2048" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Freshpaint will only deliver events to Google Ads when a user arrives on your site by clicking on your Google ad, and the Google Click ID value ([$gclid](https://support.google.com/google-ads/answer/9744275?hl=en)) is captured from the clickthrough url. Without a $gclid value, Google will not be able to attribute events to your ad campaigns.
{% endhint %}

### That's it! Now all you need to do to send an event to Google Ads is enable the destination in the Freshpaint event definition:

Navigate to your Freshpaint event, and toggle the destination on to enable the event to be sent to the Google Ads destination.<br>

<figure><img src="https://lh3.googleusercontent.com/VVSSyzLpR2VFTkzWEjqFbz09bTzYUzCtFRowCr9VeAx2L8OpgLi9n3gS1Oj8bBlXccGkC0Qh1tSZdyWWJwnWhff5DahwVdshzecSo5tt17tpbfsf1zgRqYSa2XuIcUB6MuYesgGWXz6qKwy5cPKixlVgSA=s2048" alt=""><figcaption></figcaption></figure>

If you've configured multiple Google Ads Conversion IDs, you'll need to toggle each Conversion ID individually for each Freshpaint event.&#x20;

If you're using Google Tag Manager to send data to Google Ads, and you have multiple Conversion IDs enabled, you'll need to specify which Conversion ID(s) you'd like to enable the event for in the event tag.

### Confirm and Validate Conversions in Google Ads

<figure><img src="https://lh3.googleusercontent.com/hKKqRTB-9mTPYJG6psiqdQRxeyGQip44zrkr2gLBjIEnTkNGH3NppgqUkDwV12mlZBb1KVWdtKBoSYhtqQ3syY7T4-i2tkLLTOFQUi2sRXh_GJSGK9Es4a4HToyr3GQrBR2T-P8bN8i6NWOJqjn3pcP2Bw=s2048" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Data from the previous day may not be ingested and displayed by Google in your  until 3:30pm ET the following day and can even take up to 24 hours to appear in your Google Ads conversion goals.
{% endhint %}

Congratulations! Once you have confirmed conversion in Google Ads, you have finished setting up this integration.

You can find more detailed documentation on this integration in the [reference guide document.](https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/google-ads/google-ads-reference)


---

# Agent Instructions: 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:

```
GET https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/google-ads/google-ads-quick-start-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.