Skip to content

The Google Ads Conversions modules allow you to upload and adjust your Google Ads conversions.

Getting Started with Google Ads Conversions

Prerequisites

  • A Google Ads account

In order to use Google Ads Conversions with Ibexa Connect, you must have a Google Ads account. If you do not have one, you can create a Google account at ads.google.com.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Note

Some adblocking browser plugins could block the Google Ads Conversions modules. It is recommended to disable the plugins if you encounter a problem loading a module.

Connecting Google Ads Conversions to Ibexa Connect

To connect your Google Ads account to Ibexa Connect you must obtain your Customer ID and insert it in the Create a connection module dialog box.

  1. Log in to your Google Ads account.

  2. Click on your profile image at the top-right corner of the page.

  3. Copy the Customer ID number. For example: 123-456-7890.

  4. Go to Ibexa Connect and open the Google Ads Conversions module you want to use.

  5. Click Add. In the Connection name field, enter a name for your connection.

  6. In Customer ID field, enter the number copied in step 3 and click Save.

Upload a Call Conversion

Uploads a Google Ads Call Conversion.

Upload a Call Conversion

Select which call conversion to upload. You can manually search or select from the list.

Account/Customer ID

Select the account or customer ID associated with the conversion.

Conversion Action ID

Select the resource name of the conversion action associated with this conversion.

Although this resource name consists of a customer id and a conversion action id, validation will ignore the customer id and use the conversion action id as the sole identifier of the conversion action.

Customer Phone Number

Enter the phone number from which this call was placed. The number must be in E.164 format with preceding '+' sign. e.g. "+16502531234".

Call Start Date Time

Enter the date time at which the call occurred. You must specify the timezone. The format is yyyy-mm-dd hh:mm:ss+|-hh:mm, e.g. 2022-01-01 12:32:45-08:00.

Conversion Date Time

Enter the date time at which the conversion occurred. Must be after the call time. You must specify the timezone. The format is "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. "2022-01-01 12:32:45-08:00".

Conversion Value

Enter the value of the conversion for the advertiser.

If you don't assign value to your call conversions, enter 0.

Currency Code

Enter the currency associated with the conversion value. You must follow the ISO 4217 3-character currency code. For example: USD, EUR.

For more information, see Upload call converion requirements.

Upload a Click Conversion

Uploads a click conversion.

Upload a Click Conversion

Select which click conversion to upload. You can manually search or select from the list.

Account/Customer ID

Select the account or customer ID associated with the conversion.

Conversion Action ID

Select the resource name of the conversion action associated with this conversion.

Although this resource name consists of a customer id and a conversion action id, validation will ignore the customer id and use the conversion action id as the sole identifier of the conversion action.

Note

You only see import conversion actions which are suitable for click conversion uploads. If your list is empty, you first need to create a new import conversion action in the Google Ads UI by going to Conversions > New Conversion Action > Import > Other data sources or CRMs > Track conversions from clicks. After you set up the conversion action, it shows up on the list here. You must wait around 6 hours before Google Ads starts accepting conversion uploads for your new action.

Conversion Date Time

Enter the date time at which the conversion occurred. Must be after the call time. You must specify the timezone. The format is yyyy-mm-dd hh:mm:ss+|-hh:mm, e.g. 2022-01-01 12:32:45-08:00.

Google Click ID

Enter the Google Click ID (GCLID) associated with this conversion.

Order ID

Enter the order ID associated with the conversion.

Note

You can only use an order id for one conversion per conversion action.

If you plan to upload first-party data adjustments for enhanced conversions later, you must provide an order ID for each uploaded GCLID.

Conversion Value

Enter the value of the conversion for the advertiser.

If you don't assign value to your call conversions, enter 0.

Currency Code

Enter the currency associated with the conversion value. You must follow the ISO 4217 3-character currency code. For example: USD, EUR.

External Attribution Data

Additional data about externally attributed conversions.

Note

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

External Attribution Credit Represents the fraction of the conversion that is attributed to the Google Ads click.
External Attribution Model Specifies the attribution model name.

For more information, see Click (GCLID) based conversion requirements.

Upload a Conversion Adjustment

Uploads a conversion adjustment.

Note

You can upload conversion adjustments after 24 hours from the original conversion.

Google's API requires you to provide the date time of the original conversion if you upload the adjustments by GCLID. There is no way to get the exact date time if you did not save it to your own database when the original conversion was pushed to Google Ads. Without the correct date time, the conversion adjustment upload will fail.

When your original conversion was uploaded with a GCLID and a Transaction ID, you can only adjust it by supplying the transaction ID. If your original conversion was uploaded with a GCLID only, you can only adjust it by supplying the GCLID.

Select a Method

Select the method with which you want to upload this conversion adjustment.

Upload by Google Click ID (GCLID)

Upload by Order ID

Account/Customer ID

Select the account or customer ID associated with this conversion.

Adjustment type

Select the adjustment type.

Retraction

  • Negates a conversion so that its total value and count are both zero.

Restatement

  • Changes the value of a conversion.

Adjustment Date Time

Enter the date and time at which the adjustment occurred. Must be after the conversion date time. You must specify the timezone. The format is yyyy-mm-dd hh:mm:ss+|-hh:mm, e.g. 2022-01-01 12:32:45-08:00.

For more information, see conversion adjustments.

Experimental

Upload a Conversion Enhancement

Uploads a conversion enhancement.

Account/Customer ID

Select the account or customer ID associated with the conversion.

Order ID

Enter the order ID of the conversion to be adjusted.

If the conversion was reported with an order ID specified, you must use that order ID as the identifier here.

Use Identifiers

Enter the user identifiers to enhance the original conversion. The maximum number of user identifiers for each enhancement is 5.

Source

  • First Party (Advertiser): Indicates that the user identifier was provided by the first party (advertiser).

  • Third Party (Partner): Indicates that the user identifier was provided by the third party (partner).

Additional fields

  • Email: Hashed email address using SHA-256 hash function after normalization.

  • Phone Number: Hashed phone number using SHA-256 hash function after normalization (E164 standard).

  • Mobile ID: Mobile device ID (advertising ID/IDFA).

  • Address Info

Restatement Value

Enter the information needed to restate the conversion's value. Required for restatements. Should not be supplied for retractions. An error is returned if provided for a retraction.

Note

If you want to upload a second restatement with a different adjusted value, it must have a new, more recent, adjustment occurrence time. Otherwise, it will be treated as a duplicate of the previous restatement and ignored.

  • Conversion Adjusted Value

    The restated conversion value. This is the value of the conversion after restatement. For example, to change the value of a conversion from 100 to 70, an adjusted value of 70 should be reported.

  • Currency Code

    The currency of the restated value. If not provided, then the default currency from the conversion action is used, and if that is not set then the account currency is used. This is the ISO 4217 3-character currency code e.g. USD or EUR.

Google Click ID

Enter the Google Click ID (GCLID) associated with this conversion.

Adjustment Date Time

Enter the date and time at which the adjustment occurred. Must be after the conversion date time. You must specify the timezone. The format is yyyy-mm-dd hh:mm:ss+|-hh:mm, e.g. 2019-01-01 12:32:45-08:00.

User Agent

Enter the user agent to enhance the original conversion. You can find this in your user's HTTP request header when they convert on your web page.

Example: "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)".

Note

User agent can only be specified in enhancements with user identifiers. This should match the user agent of the request that sent the original conversion so the conversion and its enhancement are either both attributed as same-device or both attributed as cross-device.

For more information, see Enhanced conversions.

Upload an Enhanced Conversion for Leads

Uploads an enhanced conversion for leads.

Account/Customer ID

Select the account or customer ID associated with the conversion.

Order ID

Enter the order ID associated with the conversion. An order id can only be used for one conversion per conversion action.

Use Identifiers

Enter the user identifiers associated with this conversion. Only hashed_email and hashed_phone_number are supported for conversion uploads. The maximum number of user identifiers for each conversion is 5.

  • Email: Hashed email address using SHA-256 hash function after normalization.

  • Phone Number: Hashed phone number using SHA-256 hash function after normalization (E164 standard).

  • Address Info

Conversion Date Time

Enter the date and time at which the conversion occurred. Must be after the conversion date time. You must specify the timezone. The format is yyyy-mm-dd hh:mm:ss+|-hh:mm, e.g. 2019-01-01 12:32:45-08:00.

Conversion Value

Enter the value of the conversion for the advertiser.

Currency Code

Enter t currency associated with the conversion value. This is the ISO 4217 3-character currency code. For example: USD, EUR.

For more information, see Enhanced conversions.