Google Ads Conversion icon

Google Ads Conversion

Send conversion events to Google Ads for campaign optimization

Upload Click Conversion

AI-generated

Overview

This node uploads click conversion events to Google Ads to help optimize advertising campaigns. It supports both regular Google Ads accounts and manager accounts (MCC) managing multiple client accounts. Users can specify conversion details such as conversion action, date/time, value, currency, order ID, and user identification methods including GCLID, GBRAID, WBRAID, or enhanced conversions with hashed user data. The node supports batch processing for multiple conversions, validation-only mode, and detailed debug logging. It is useful for advertisers who want to track and report conversions from their ads to Google Ads for better campaign performance.

Use Case Examples

  1. Uploading a single click conversion with GCLID identification for a regular Google Ads account.
  2. Uploading multiple conversions in batches with partial failure handling for a manager account managing multiple clients.
  3. Using enhanced conversions with hashed user data (email, phone, address) for improved conversion tracking.
  4. Validating conversion data without uploading to check for errors before actual submission.

Properties

Name Meaning
Account Type Select whether the Google Ads account is a regular account or a manager account (MCC) managing multiple client accounts.
Managed Account Select the managed account to upload conversions to when using a manager account.
Conversion Action The conversion action from the Google Ads account to which the conversion event relates.
Conversion Date Time The date and time of the conversion event. Accepts DateTime objects or strings in YYYY-MM-DD HH:MM:SS+TZ format.
Conversion Value The monetary value of the conversion (optional).
Currency Code Three-letter ISO 4217 currency code for the conversion value.
Order ID Unique transaction or order identifier for the conversion (optional but recommended).
Identification Method Method used to identify the user who converted, such as GCLID, GBRAID, WBRAID, or enhanced conversions with hashed user data.
GCLID The Google Click ID from the ad click, required if using GCLID identification.
GBRAID The GBRAID for iOS app install conversions, required if using GBRAID identification.
WBRAID The WBRAID for iOS web-to-app conversions, required if using WBRAID identification.
Enhanced Conversion Data User data fields (email, phone number, first name, last name, street address, city, state, postal code, country code) that will be automatically hashed for enhanced conversions.
Ad User Data Consent User consent status for ad user data usage, required for compliance in the European Economic Area (EEA).
Ad Personalization Consent User consent status for ad personalization, required for compliance in the EEA.
Validate Only If true, only validate the conversion data without actually uploading it.
Debug Mode Enable detailed logging and response data for debugging purposes.
Enable Batch Processing Enable processing multiple conversions in batches for better performance.
Batch Size Number of conversions to process in each batch (maximum 2000).
Batch Processing Mode How to handle errors during batch processing: fail on first error, continue on errors, or use Google Ads partial failure policy.
Show Progress Log batch processing progress.

Output

JSON

  • success - Indicates whether the conversion upload or validation was successful.
  • message - A message describing the result of the operation, e.g., success or validation message.
  • operation - The operation performed, e.g., 'uploadClickConversion'.
  • conversion - The conversion data payload that was uploaded.
  • response - The response from the Google Ads API after uploading the conversion.
  • itemIndex - The index of the item in the input data that this output corresponds to.
  • error - Error message if the conversion upload or validation failed.
  • errorType - Type or class of the error encountered.
  • httpCode - HTTP status code returned by the Google Ads API in case of error.
  • apiErrorCode - Specific API error code returned by Google Ads API.
  • batchIndex - Index of the batch if batch processing is enabled.
  • batchPosition - Position of the conversion within the batch.
  • debugInfo - Additional debug information including request and response details if debug mode is enabled.

Dependencies

  • Google Ads OAuth2 credentials with developer token and customer ID

Troubleshooting

  • Authentication errors may occur if OAuth2 token is expired or revoked. Re-authenticate the Google Ads credentials.
  • Validation errors occur if required fields like conversion action, conversion date/time, or user identification are missing or invalid.
  • Ensure the customer ID is correctly formatted with digits only; otherwise, URL construction for API calls will fail.
  • Batch processing errors can be handled by selecting appropriate batch processing mode: fail fast, continue on errors, or partial failure.
  • Rate limit errors (HTTP 429) indicate too many requests; slow down the request rate or implement retries.
  • Permission errors (HTTP 403) may indicate insufficient access rights or incorrect account type selection (regular vs manager).
  • Conversion date/time must not be in the future and should preferably not be older than 90 days to avoid rejection.
  • Enhanced conversions require at least one user identifier (email, phone, or address info) to be provided and will be hashed automatically.

Links

Discussion