Google Ads Conversions Connector Setup Guide | Server-Side Connectors

Connector actions

Action Name	AudienceStream	EventStream
Upload Call Conversion	✓	✓
Upload Click Conversion	✓	✓
Conversion Restatement	✓	✓
Conversion Retraction	✓	✓

API information

This connector uses the following vendor API:

API Name: Google Ads API
API Version: v15
API Endpoint: https://googleads.googleapis.com/
Documentation: Google Ads API

Batch limits

This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

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

Delayed actions

Actions are delayed for 30 minutes to accommodate uploading offline conversions, as per Google’s best practices. For more information about delayed actions using the Google Campaign Manager 360 Floodlight connector, see Google’s Best practices for uploading offline conversions documentation.

Actions are not delayed when using trace in EventStream or AudienceStream.

The connector sends the value of GRANTED for adUserData and adPersonalization consent by default. To override the default, map a relevant EventStream attribute to Ad User Data Consent and/or Ad Personalization Consent with a value of DENIED.

Configure settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

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	Select existing conversion action. For more information, see Google Ads Conversion Tracking.
Caller ID	Required The called ID from which this call was placed. Caller ID is expected 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`
Ad User Data Consent	Consent for ad user data. The default value is `GRANTED`. Valid values are `GRANTED` and `DENIED`.

Action - Upload Click Conversion

Parameters

Parameter	Description
Customer ID	Select customer account ID. Available options reflect accessible customer accounts for authenticated user.
Conversion Action	Select existing conversion action. For more information, see: Google Ads Conversion Tracking.
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	Specified the attribution model name. For more information, see Google Ads API Click Conversion.
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.
Ad User Data Consent	Consent for ad user data. The default value is `GRANTED`. Valid values are `GRANTED` and `DENIED`.

Action — Conversion Restatement

Wait 24 hours after a conversion is reported before adjusting it to avoid a CONVERSION_NOT_FOUND or TOO_RECENT_CONVERSION error.

Parameters

Parameter	Description
Conversion Action	Select existing conversion action. For more information, see: Google Ads Conversion Adjustments.
Restatement Value	(Required) The value of the conversion after restatement.
Restatement Date Time	(Required) The date time at which the adjustment occurred. The format is yyyy-mm-dd hh:mm:ss+\|-hh:mm. Date attributes will be converted to the format Google expects.
Order ID	Either Order ID or Google Click ID with Conversion Date Time must be provided. If the conversion was reported with an order ID specified, that order ID must be used.
Google Click ID	Either Order ID or Google Click ID with Conversion Date Time must be provided. If the conversion was reported with an order ID specified, that order ID must be used.
Conversion Date Time	If used, should be in the format yyyy-mm-dd hh:mm:ss+\|-hh:mm. Date attributes will be converted to the format Google expects.
Currency Code	The currency of the restated value. If not provided, then the default currency from the conversion action is used.

Action — Conversion Retraction

Wait 24 hours after a conversion is reported before adjusting it to avoid a CONVERSION_NOT_FOUND or TOO_RECENT_CONVERSION error.

Parameters

Parameter	Description
Conversion Action	Select existing conversion action. For more information, see: Google Ads Conversion Adjustments.
Retraction Date Time	(Required) The date time at which the retraction occurred. The format is yyyy-mm-dd hh:mm:ss+\|-hh:mm. Date attributes will be converted to the format Google expects.
Order ID	Either Order ID or Google Click ID with Conversion Date Time must be provided. If the conversion was reported with an order ID specified, that order ID must be used.
Google Click ID	Either Order ID or Google Click ID with Conversion Date Time must be provided. If the conversion was reported with an order ID specified, that order ID must be used.
Conversion Date Time	If used, should be in the format yyyy-mm-dd hh:mm:ss+\|-hh:mm. Date attributes will be converted to the format Google expects.

Considerations for Real-Time Web Traffic

A click-through associated with a Google Click ID must have occurred at least 6 hours prior to activating the connector, otherwise Google will reject the request. We recommend 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 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.