Who is this for? Marketers running paid acquisition on Google Ads who want to feed conversion data back to the platform for campaign optimisation and ROAS reporting.
What You Need
- The Immutable Tracking Pixel or Web SDK installed on your marketing site, so Google click IDs (
gclid) are captured. Agclidis required for every Google conversion. Without it, the postback cannot be sent. - The Unity SDK, Web SDK, or REST API sending events from your game
- At least one active Conversion Goal for the game
- A Google Ads account with at least one Conversion Action created in Tools then Conversions. You’ll need the Conversion Action resource name for each Goal you want to track.
- Admin access to the game in Audience Hub
Step 1: Create Conversion Actions in Google Ads
Before connecting, create a Conversion Action in Google Ads for each Immutable Goal you want to track:- In Google Ads, go to Tools then Conversions.
- Click New conversion action, select Import, then choose Track conversions from clicks.
- Give the Conversion Action a name that matches your Goal (for example, “First Purchase”).
- Complete the setup. Note the Conversion Action ID. You’ll need it to form the resource name.
customers/{customer_id}/conversionActions/{conversion_action_id}
You can find {customer_id} in the top-right of your Google Ads account (without hyphens). You can find {conversion_action_id} in the URL when you open a Conversion Action’s detail page.
Step 2: Connect Google Ads
- In Audience Hub, navigate to Settings then Integrations then Google Ads.
- In the Conversion Postbacks section, click Connect.
- A Google authorization popup opens. Sign in and grant the requested permissions.
- Once authorized, Hub shows an account picker. Select the Google Ads account that contains the Conversion Actions you created.
- Click Connect. Hub creates the postback configuration and the popup closes.
Step 3: Map Goals to Conversion Actions
After connecting, you need to map each active Conversion Goal to a Google Ads Conversion Action resource name. Without a mapping, conversions for that Goal will not be sent to Google.- On the Google Ads integration page, scroll to the Conversion action mapping section.
- For each active Goal, enter the Conversion Action resource name in the format
customers/{customer_id}/conversionActions/{conversion_action_id}. - Click Save mapping.
Hub attempts to fetch your available Conversion Actions automatically and show them in a dropdown. If that lookup fails, you can type the resource name directly. Both paths produce the same result.
How Google Conversions Work
Google Ads conversion tracking uses a different delivery model than the other networks. Rather than sending each conversion immediately, Immutable stages conversions in a queue and uploads them to Google in batches via the Google Ads API. This is the standard Google Ads offline conversion import pattern. Every postback requires agclid (Google click ID). If an attributed event does not have a gclid in the touchpoint data, Immutable will not send a postback to Google for that event. Make sure your Tracking Pixel is correctly installed on any pages you’re running Google Ads campaigns against.
For purchase conversions, the conversion value and currency are included in the upload when both are present, so Google can optimise for revenue (ROAS).
Consent Mode
Immutable forwards consent signals to Google using Consent Mode v2. For events collected atfull consent, both ad_user_data and ad_personalization are set to GRANTED. For events at anonymous consent, both are set to UNSPECIFIED. This lets Google apply appropriate data restrictions without dropping the conversion.
Verify Delivery
Once conversions start arriving, they appear in the Delivery logs section on the Google Ads integration page. Because Google processes conversions in batches, there may be a short delay before they appear in your Google Ads reporting. Because Google Ads postbacks are currently in testing mode, conversions sent from this integration are only visible in test accounts. They do not appear in live Google Ads campaign reports. For a description of log columns and status values, see Monitoring Postback Delivery.Reconnecting
If your Google authorization expires or is revoked, Hub shows a credential warning on the postback config. Open the config menu and click Reconnect to re-authorize. Your Conversion Action mappings are preserved when you reconnect.Next Steps
Conversion Goals
Define which player actions count as a conversion and control what triggers postbacks
Tracking Pixel
Make sure Google click IDs (
gclid) are being captured on your marketing siteConversion Postbacks
Overview of all supported networks and event mapping
Attribution
How tracking data powers player attribution and Hub reports