Freshpaint
HomeLogin
  • Documentation
    • What is Freshpaint?
    • ⚕️HIPAA Mode
    • 🏗️Building Out Your Account
    • 🌐Overview of Features
    • Guides
      • 📡Add Autotrack to your website to collect data from your users
        • Installing the Freshpaint Javascript SDK
        • Installing the Freshpaint SDK with a Content Security Policy (CSP)
        • Installing the Freshpaint Javascript SDK with Server-Side Rendering (SSR) + React
        • Autocapture + React
        • Configuring a Destination
        • Labeling User Actions
        • How do I install Freshpaint with Typescript?
      • 🔁Send historical data to any destination with Time Machine
      • Next.js Quickstart Guide
      • Android Quickstart Guide
        • Installing the Freshpaint Android SDK
        • Configuring a Destination
        • Instrumenting Your App
      • iOS Quickstart Guide
        • Installing the Freshpaint iOS SDK
        • Configuring a Destination
        • Instrumenting Your App
      • React Native Quickstart Guide
        • Installing the Freshpaint React Native SDK
        • Configuring a Destination
        • Labeling User Actions
        • Configuring Property Capture
    • Setting up Properties
    • Setting up Your Destinations
      • Enabling and Disabling a Destination
      • Deleting a Destination
    • Setting up Your Events
    • User Identification
      • Designated Identify Properties
    • Maps
    • Analytics (Beta)
      • Web Analytics Dashboard
      • Campaigns
      • Service Lines
      • Data Glossary
    • Translations
    • Web Tracker Monitoring
      • Tracker Resolution Types
      • Historical Scans
  • Integrations
    • Destinations
      • Demand Side Platforms (DSPs)
        • Basis
          • Basis Quick Start Guide
          • Basis Reference
        • Google Campaign Manager 360
        • StackAdapt
          • StackAdapt Quick Start Guide
          • StackAdapt Reference
        • theTradeDesk
          • theTradeDesk Quick Start Guide
          • theTradeDesk Reference
          • theTradeDesk with CM360 Configuration Guide
        • Viant
          • Viant Quick Start Guide
          • Viant Reference
      • Direct Response Ads
        • Facebook Conversions API
          • Facebook Conversions API Quick Start Guide
          • Facebook Conversions API Reference
        • Google Ads Conversion API
          • Google Ads Conversion API Quick Start Guide
          • Google Ads Conversions API Reference
        • Google Ads
          • Google Ads Quick Start Guide
          • Google Ads Reference
        • LinkedIn Ads
          • LinkedIn Ads Quick Start Guide
          • LinkedIn Ads Reference
        • Microsoft Ads (formerly Bing Ads)
          • Microsoft Ads Quick Start Guide
          • Microsoft Ads Reference
          • Microsoft Ads Multi-Config Reference
        • Pinterest Ads (Beta)
          • Pinterest Ads Quick Start Guide
          • Pinterest Ads Reference
        • Pinterest Tag
        • Reddit Ads
          • Reddit Ads Quick Start Guide
          • Reddit Ads Reference
        • TikTok Ads
        • Twitter Ads
      • Data Activation
        • ActiveCampaign
          • ActiveCampaign Quick Start Guide
          • ActiveCampaign Reference
        • Amplitude
          • Amplitude Quick Start Guide
          • Amplitude Reference
        • Braze (formerly Appboy)
          • Braze Quick Start Guide
          • Braze Reference
        • Customer.io
          • Customer.io Quick Start Guide
          • Customer.io Reference
        • Freshsales
        • Google Analytics 4 Proxy
          • Google Analytics 4 Proxy Quick Start Guide
          • Google Analytics 4 Proxy Reference
          • Google Analytics 4 Proxy Advanced Tracking Configurations
        • Google Analytics 4 Server-Side
          • Google Analytics 4 Server-Side Quick Start Guide
          • Google Analytics 4 Server-Side Reference
        • Heap
        • Hotjar
        • HubSpot Cloud
        • HubSpot Web
        • impact.com
          • Impact.com Quick Start Guide
          • Impact.com Reference
        • Intercom
          • Intercom Quick Start Guide
          • Intercom Reference
        • Iterable
          • Iterable Quick Start Guide
          • Iterable Reference
        • June
        • Klaviyo
        • Mixpanel
          • Mixpanel Quick Start Guide
          • Mixpanel Reference
        • OneSignal
          • OneSignal Quick Start Guide
          • OneSignal Reference
        • Sendinblue
        • Sentry
        • Vero Cloud
        • Webengage
        • Webhooks
        • Woopra
        • Zendesk
      • Data Warehouses
        • Azure Warehouse Setup
        • BigQuery Warehouse Setup
        • Databricks Warehouse Setup
        • Postgres Warehouse Setup
        • Redshift Warehouse Setup
        • S3 Warehouse Setup
        • Snowflake Warehouse Setup
      • Consent Management
        • Osano
        • OneTrust
        • Custom Consent Manager
    • Sources
      • Web
        • Autotrack
        • Precision Tracking
      • CallRail
      • Invoca
      • Customer.io
      • Intercom
      • Mailchimp
      • React Native
      • SendGrid
      • Sendinblue
      • Server-Side
      • iOS
    • 🔷Google Tag Manager integration
      • Google Tag Manager migration
      • Quick Start Guide
    • 📺Freshpaint Video Platform
    • 🖼️Impression Pixel
  • Admin Panel
    • Event Library
      • Event Library Bulk Actions
      • Event Definition Filters
      • Event Tester
      • 🔁Time Machine
      • Visual Tagger
      • Advanced Options
        • Tag Manager
        • Disabling Target Text Capture
        • Cross Domain Tracking
    • Projects & Environments
    • Teams
      • Role-Based Access Control (RBAC)
    • Transformations
      • Standard Events
      • Modify Data
      • Modify User Data
      • SQL Transformations
    • 📈Destination Monitoring
    • 🔎Investigate: Testing and Debugging
      • Live View
      • Event Verification
  • Reference
    • Developer Docs
      • Freshpaint Web SDK Reference
      • Freshpaint Web SDK Options
      • Freshpaint React Native SDK Reference
      • Freshpaint iOS SDK Reference
      • Freshpaint Android SDK Reference
      • HTTP API
    • Frequently Asked Questions
      • How do I circumvent ad blockers?
      • Can Freshpaint track users across domains?
      • Can I install Freshpaint on a Chrome extension?
      • What properties are captured with my events?
      • How Do I Switchover From Segment?
      • How Do I Switch From Native Google Analytics to the Freshpaint Google Analytics Destination?
      • Where do I find my Environment ID?
      • Is Freshpaint GDPR & CCPA Compliant?
      • Can I use transformations to anonymize data for client-side destinations?
      • How do I QA or debug my data?
      • Why Do My Numbers Differ Across Different Tools?
      • Billing: How Does Freshpaint Determine MTUs?
      • Can I Use Freshpaint on Multiple Sites?
      • How Can I Export Data From Freshpaint?
      • How Does Freshpaint Identify Users?
      • How Many Events Should I Create?
      • What Should I Name My Events?
      • How do I track scroll depth?
      • What Data Does Freshpaint Collect?
        • Data Collected on Web
        • Data Collected on React Native
      • Does Freshpaint's Autotrack slow my site down?
      • Running Freshpaint with a Proxy
      • Should my Environment ID be treated as a sensitive key?
      • How Does Freshpaint Determine Session Count?
      • What is the difference between client-side and server-side connection mode?
      • What is a Proxy Integration?
      • Where can I view Freshpaint’s Status?
      • Does Freshpaint provide HIPAA audit logs?
      • Freshpaint Cookie Too Large
      • How does Freshpaint compare to server-side Google Tag Manager?
      • If a user re-installs my app, will Freshpaint generate a new device ID?
      • Why doesn't Freshpaint need a BAA before sending data to Google Ads and Facebook Ads?
      • What Implementation Services Does Freshpaint Offer?
      • Single Sign On (SSO) Setup
Powered by GitBook
On this page
  • Destination Info
  • Events
  • Track Events
  • Server-side
  • Setup Conversion Actions
  • Misc. Considerations
  • Conversion Event Imports Between Google Analytics and Google Ads
  • Authentication
  • View-Through Conversions and Retargeting

Was this helpful?

  1. Integrations
  2. Destinations
  3. Direct Response Ads
  4. Google Ads Conversion API

Google Ads Conversions API Reference

PreviousGoogle Ads Conversion API Quick Start GuideNextGoogle Ads

Last updated 5 months ago

Was this helpful?

The Google Ads Conversion API requires setting up new Conversion Actions within Google Ads. If you want to re-use your existing Google Ads configuration, take a look at the .

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

Destination Info

  • Supports calls

  • Supports

  • Refer to this destination as Google Ads Conversion API in the

  • Connection Modes:

Client-side
Server-side

Web

Mobile

Server

This is a reference document for the Google Ads Conversions API destination. For information on how to set up this integration, see the.

Events

Freshpaint .track() events map to any Click Conversions you've already created in Google Ads.

Track Events

When you send an event to Google Ads, you can track conversions from your ad campaigns based on those events.

Server-side

You may provide the following additional event properties:

Freshpaint property

Google Ads parameter

Type

Required?

Description

$gclid or $gbraid or $wbraid

gclid or wbraid or gbraid

string

Required

gclid (Google Click ID) is generated at ad click time and appended to the landing page URL. Freshpaint will automatically capture gclid for events from your website. If you wish, you may provide $gclid as an event property to override the automatically captured value. wbraid or gbraid can be used instead of gclid.

ctname or ctid

ctid

string

Required

The Conversion Name or Conversion Id of the conversion action in Google Ads. When using the Conversion Name, the Freshpaint integration will lookup the conversion id before sending the event to google. When using the Conversion Id, the name of the Freshpaint Event must exactly match the name of the Google Ads Conversion name.

time

conversionDateTime

number

Optional

The time the event occurred as a unix epoch. The time needs to be after the ad is clicked or it won't be accepted by google.

cart_data

cartData

object

Optional

external_attribution_data

externalAttributionData

list

Optional

custom_variables

customVariables

list

Optional

conversion_environment

conversionEnvironment

enum

Optional

value or total or revenue

value

number

Optional

currency

currency_code

string

Optional

email

email

string

Optional

The email address of the user

phone or phone_number

phone

string

Optional

The phone number of the user

mobile_id

mobileID

string

Optional

Mobile device ID (advertising ID/IDFA). Accepted only for Customer Match.

third_party_user_id

thirdPartyUserID

string

Optional

Advertiser-assigned user ID for Customer Match upload, or third-party-assigned user ID for Store Sales. Accepted only for Customer Match and Store Sales.

address_info

offlineAddressInfo

object

Optional

Freshpaint will only deliver events to Google when a user arrives on your site by clicking on a Google Ad, thus generating an gclid. Without gclid, Google will not be able to attribute conversions.

Setup Conversion Actions

Misc. Considerations

  • Conversions may take up to 24 hours to appear in your Google Ads Conversion Goals.

Conversion Event Imports Between Google Analytics and Google Ads

The workflow of importing GA4 events as conversion actions in Google Ads is considered non-compliant, primarily related to the handling of user identifiers like the GCLID (Google Click Identifier).

To remain compliant for both GA4 and Google Ads, Freshpaint recommends:

  • Not allowlisting the Google Click Identifier (GCLID) property for your Google Analytics destination.

  • Creation of net-new Website Conversion Actions in Google Ads: Instead of passing the GCLID directly to GA4, create specific Website conversion actions. The conversion action name can be used as the "ctname" property, along with a "conversion label" property which allows Freshpaint to map an event to a specific conversion action in Google Ads.

Authentication

Freshpaint supports using either a User Account or Service Account for accessing the Google Ads Conversion API.

User Account

A user who has access to both Freshpaint and Google Campaign Manager 360 may delegate access to Freshpaint using the user account. Freshpaint will be granted the limited permissions necessary to send conversion events to google CM360 and be directly tied to the account of the user who delegated access. If that user account is removed or reset, google may revoke the authentication credentials that have been delegated to Freshpaint under that user account.

The user delegating access to their User Account needs to have the "Insert offline conversions" permission as part of their role within Campaign Manager 360.

Navigate to the destination configuration page and click either Connect or Reconnect in the Access Permission row of the destination configuration page. In the popup dialog select User Account and then Connect with Google CM360 which will redirect you to Google to complete setting up authentication between Freshpaint and Google services.

Service Account

An account within google can be created only for Freshpaint that will provide Freshpaint with a set of credentials for Freshpaint to use when sending conversion events to Google. The creation of this account will require necessary permissions to the underlying google account.

Once the service account has been created within Google, the credentials file can be uploaded to the Freshpaint application.

Navigate to the destination configuration page and click either Connect or Reconnect in the Access Permission row. In the popup dialog select Service Account and upload the json file that google provided with the credentials for Freshpaint.

View-Through Conversions and Retargeting

View-through conversions and retargeting are possible for users when an identifier such as email or phone number is shared with Google.

Note that retargeting of anonymous users is not possible, due to the absence of an identifier that can be used to retarget that user.

The cart data associated with this conversion.

Additional data about externally attributed conversions. This field is required for conversions with an externally attributed conversion action, but should not be set otherwise.

The custom variables associated with this conversion.

The environment this conversion was recorded on, for example, App or Web.

Value of the conversion. See for more information

Currency of the conversion value, "USD" by default. See the list of .

Address information. Accepted only for Customer Match, Store Sales, and ConversionAdjustmentUploadService.

Please refer to the for instructions on how to set up conversion actions.

to indicate whether users within the European Economic Area have consented to the event being shared with Google. If the event is enabled and consented to within Freshpaint using the Freshpaint consent management features, Freshpaint will automatically mark the event as consented to when sending the event to Google's servers. See for more information.

Unlinking your Google Analytics 4 property from your Google Ads account: The process for how these 2 tools are unlinked is documented , under the "Unlinking Google Ads accounts from Analytics" section of the article.

Please follow the Google documentation on the creation and configuration of a service account available at:

The service account should be provided with the scope which will allow access to send conversion events to Google.

Google Ads Proxy Destination
Track
HIPAA mode
Integrations object
Quick Start guide
Google Ads API v15 introduces a consent object
Consent Management
here
https://developers.google.com/google-ads/api/docs/oauth/service-accounts
https://www.googleapis.com/auth/adwords
Google Docs
Google Docs
Google Docs
Google Docs
About conversion values
supported currency codes
Google Docs
Quick Start Guide