This article describes how to set up the Google Ads Conversions connector.

In this article:

Connector Actions

Action Name AudienceStream EventStream
Upload Call Conversion
Upload Click Conversion

API Information

This connector uses the following vendor API:

Batch Limits

This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three (3) thresholds is met:

  • Max number of requests: 2000
  • Max time since oldest request: 10 minutes
  • Max size of requests: 2 MB

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Action - Upload Call Conversion

Parameters

Parameter Description
Customer ID
  • Select customer account ID.
  • Available options reflect accessible customer accounts for authenticated user.
Conversion Action
Caller ID
  • Required
  • The called ID from which this call was placed.
  • Caller ID is expected to e in E.164 format and preceded by the plus (+) character.
  • Example: +16502531234
Call Start Datetime
  • Required
  • The date time at which the call occurred.
  • The timezone must be specified.
  • The format is yyyy-mm-dd hh:mm:ss
  • Example 2020-01-01 12:32:45-8:00.
Conversion Datetime
  • Required
  • The date time at which the conversion occurred.
  • Must be after the call time.
  • The timezone must be specified.
  • The format is yyyy-mm-dd hh:mm:ss
  • Example 2020-01-01 12:32:45-8:00.
Conversion Value
  • The value of the conversion for the advertiser.
Currency Code
  • Currency associated with the conversion value.
  • This is the ISO 4217 3-character currency code.
  • Examples: USD, EUR

Action - Upload Click Conversion

Parameters

Parameter Description
Customer ID
  • Select customer account ID.
  • Available options reflect accessible customer accounts for authenticated user.
Conversion Action
Google Click ID
  • Required
  • The Google Click ID (gclid) associated with this conversion.
Conversion Datetime
  • Required
  • The date time at which the conversion occurred.
  • Must be after the click time.
  • The timezone must be specified.
  • The format is yyyy-mm-dd hh:mm:ss
  • Example 2020-01-01 12:32:45-8:00.
Conversion Value
  • The value of the conversion for the advertiser.
Currency Code
  • Currency associated with the conversion value.
  • This is the ISO 4217 3-character currency code.
  • Examples: USD, EUR
Order ID
  • Required
  • The Order ID associated with the conversion.
  • An Order ID can only be used for one conversion per conversion action.
External Attribution Credit
  • Represents the fraction of the conversion that is attributed to the Google Ads click.
External Attribution Model
Merchant ID
  • The Merchant Center ID where the items are uploaded.
Feed Country Code
  • The country code associated with the feed where the items are uploaded.
Feed Language Code
  • The language code associated with the feed where the items are uploaded.
Local Transaction
  • Sum of all transaction level discounts, such as free shipping and coupon discounts for the whole cart.
  • The currency code is the same as that in the ClickConversion message.
Product ID
  • The shopping ID of the item.
  • Must be equal to the Merchant Center product identifier.
  • Use an array to add multiple items.
  • Array type attributes must be of equal length.
Quantity
  • Number of items sold.
  • Use an array to add multiple items.
  • Array type attributes must be of equal length.
Unit Price
  • Unit price excluding tax, shipping, and any transaction level discounts.
  • The currency code is the same as that in the ClickConversion message.
  • Use an array to add multiple items.
  • Array type attributes must be of equal length.

Considerations for Real-Time Web Traffic

A click-through associated with a Google Click ID must have occurred at least six (6) hours prior to activating the connector, otherwise Google will reject the request. Tealium recommends additional consideration when using this connector for the activation of real-time web traffic due to the fact that many of the Google Click IDs are associated with clicks that occurred less than six (6) hours before the conversion event.

Consider one of the following strategies to use the connector in this manner:

  • Upload historical conversion data using a file import or the Collect API.

Send the data to a Google Sheet and manually upload the data to Google Ads.

Public