Google Ads Conversions Connector Setup Guide
This article describes how to set up the Google Ads Conversions connector.
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: v12
- 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. Requests are queued until one of the following thresholds is met:
- 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.
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 |
|
Conversion Action |
|
Caller ID |
|
Call Start Datetime |
|
Conversion Datetime |
|
Conversion Value |
|
Currency Code |
|
Action - Upload Click Conversion
Parameters
Parameter | Description |
---|---|
Customer ID |
|
Conversion Action |
|
Google Click ID |
|
Conversion Datetime |
|
Conversion Value |
|
Currency Code |
|
Order ID |
|
External Attribution Credit |
|
External Attribution Model |
|
Merchant ID |
|
Feed Country Code |
|
Feed Language Code |
|
Local Transaction |
|
Product ID |
|
Quantity |
|
Unit Price |
|
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. 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 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.
This page was last updated: October 20, 2022