Google Ads Setup Guide
Prerequisites
- Google account with access to Google Ads
Setup Guide
- Authenticate your Google account with OAuth by clicking on Sign In With Google. Make sure your are signed into a user account that has permissions to both view all of your accounts, as well as submit data to them (readonly accounts will not work)
- Enter a Name for the connector.
- (Optional) Enter a Description for the connector.
- Select the Owner of the connector.
- (Optional) Verify that your Google account is successfully connected by clicking on Test Connection.
- Click Connect.
Settings configuration
Select account
To begin, select the account you want to sync data to. If an account appears at the top level, it means you have direct access to that ad account or manager account. Selecting either account at the top level syncs directly to those accounts without logging in via another manager account. Selecting a nested account requires Matia to login via the root manager account.
Syncing customer match user lists
Google's Customer Match tool lets you use the online and offline data your customers have shared with you to deliver targeted ads.
Matia supports both creating a list and updating an existing customer match list's content via the Google Ads API. It can take 6 to 48 hours for a list to be populated with members once Matia has sent the data to Google.
User list type
To begin, select the upload key type for the customer match list. It can be one of these values:
- CONTACT_INFO
- MOBILE_ADVERTISING_ID
- CRM_ID
Select an existing list or create a new one
You can create a new Customer match user list or use an existing one.
User identifiers
To identify which users to add or update in an audience, select model columns and the corresponding Google Ads fields. You must map at least one identifier.
NOTES:
Starting April 7th, 2025, the maximum membership duration for a Google Ads customer list is 540 days. From this date, existing lists configured to have no membership expiration set or membership expiration greater than 540 days will be updated to use the maximum membership duration of 540 days, and a membership duration of 540 days will be retroactively applied to all those existing members that have a longer duration. See Google's announcement for more information.
Syncing click conversions
User identifiers
Select which columns to sync from your source to Google Ads' fields. When syncing click conversions, at least one identifier is required:
- GCLID
- GBRAID
- WBRAID
Avoid storing your GCLID, GBRAID, and WBRAID data in the same model column since this can cause issues when syncing your data. Google Ads' limitations determine which values can and cannot be synced together. If this data is in the same model column and you try mapping this column to multiple Google Ads fields (such as GCLID and WBRAID), you might receive a VALUE_MUST_BE_UNSET or GBRAID_WBRAID_BOTH_SET error. Check out the common errors section to learn more about these errors.
Supported Objects
| Sync Object | Supported Sync Modes |
|---|---|
| Customer Match Lists (Audiences) | Upsert, Mirroring |
| Click Conversion | Upsert |