Skip to content

Audience Sync to Google

The Braze Audience Sync to Google integration enables brands to extend the reach of their cross-channel customer journeys to Google Search, Google Shopping, Gmail, YouTube, and Google Display. Using your first-party customer data, you can securely deliver ads based on dynamic behavioral triggers, segmentation, and more. Any criteria you’d typically use to trigger a message (for example, push, email, or SMS) as part of a Braze Canvas can be used to trigger an ad to that user via Google’s Customer Match.

Common use cases for syncing Custom Audiences include:

  • Targeting high-value users via multiple channels to drive purchases or engagement.
  • Retargeting users who are less responsive to other marketing channels.
  • Creating suppression audiences to prevent users from receiving advertisements when they’re already loyal consumers of your brand.

Prerequisites

You must ensure the following items are created and completed before setting up your Google Audience step in Canvas.

Requirement Origin Description
Google Ads Account Google An active Google ads account for your brand.

If you are looking to share an audience across multiple managed accounts, you can upload your audiences into your manager account.
Google Ads Terms and Google Ads Policies Google You must accept and ensure you comply with Google’s Ad Terms and Google’s Ad Policies, which include the EU User Consent Policy, as applicable to you, in your use of Braze Audience Sync.

Consult with your Legal Team on Google’s new EU User Consent Policy to ensure you are collecting appropriate consent in order to use Google Ads’ services for your EEA/UK end users.
Google Customer Match Google Customer Match is not available for all advertisers.

To use Customer Match, your account must have:
• A good history of policy compliance
• A good payment history
• At least 90 days history in Google Ads
• More than USD 50,000 total lifetime spend. For advertisers whose accounts are managed in currencies other than USD, your spend amount will be converted to USD using the average monthly conversion rate for that currency.

If your account does not meet these criteria, then your account is currently ineligible to use Customer Match.

Connect with your Google Ads representative for more guidance on Customer Match availability for your account.
Google Consent Signals Google If you want to serve ads to EEA/UK end users using Google’s Customer Match service, you’ll need to pass Braze the following custom attributes (boolean) as part of Google’s EU User Consent Policy. More details can be found under Collecting consent for EEA and UK end users:
- $google_ad_user_data
- $google_ad_personalization

When using Braze SDKs to collect consent signals, ensure you meet the following minimum versions:

Google’s EU User Consent Policy requires advertisers to disclose the following to their EEA or UK end users, as well as obtain their consent for such:

  • the use of cookies or other local storage where legally required; and
  • the collection, sharing, and use of their personal data for personalization of ads.

According to Google, this applies only to end users located in the European Economic Area (EEA) or the UK and is in effect as of March 6, 2024. This does not affect US end users or any other end users located outside of the EEA or the UK. Consult with your legal team on Google’s new EU User Consent Policy to ensure you are collecting appropriate consent in order to use Google Ads’ services for your EEA and UK end users.

As part of this upcoming change, you can collect both consent signals in Braze as the following custom attributes. Braze will sync the data from these custom attributes to the appropriate consent fields in Google.

As part of Google’s EU User Consent Policy, the following boolean custom attributes need to be logged to user profiles:

  • $google_ad_user_data
  • $google_ad_personalization

For more information, refer to Google Tag Manager.

Custom Attribute Name Data Type Values Definition
$google_ad_user_data Boolean In Braze, this can be set to true or false.

- true in Braze maps to Google’s GRANTED consent status (this will be synced to Google)
- false in Braze maps to Google’s DENIED consent status
- null in Braze maps to Google’s UNSPECIFIED consent status
- Any value that is not true or false will be UNSPECIFIED
Sets consent for sending user data to Google for advertising purposes.
$google_ad_personalization Boolean In Braze, this can be set to true or false.

- true in Braze maps to Google’s GRANTED consent status (this will be synced to Google)
- false in Braze maps to Google’s DENIED consent status
- null in Braze maps to Google’s UNSPECIFIED consent status
- Any value that is not true or false in Braze is mapped to Google’s UNSPECIFIED consent status
Sets consent for personalized advertising.

Braze will sync UNSPECIFIED for any user that does not have either consent attribute set to Google. This consent will be determine by Google on whether this user will be served ads.

Braze will only suppress the user if either consent attribute to set to DENIED and you are attempting to add them to an audience. Per Google, if the user’s consent status is DENIED for either attribute, Google will return an error. These users with DENIED consent will be counted toward the Users Not Synced metric. Consent statuses does not impact removing users from an audience.

To keep your audience lists up-to-date in the event an EEA or UK end user has been added to the audience list, and then has subsequently retracted any of the two consents ($google_ad_user_data or $google_ad_personalization), you must set up a Canvas to remove users from the existing audience lists using an Audience Sync step.

Tips

  • Send the value as a boolean type, not a string type.
  • Prefix the dollar sign ($) for the attribute name. Braze uses a dollar sign at the start of an attribute name to dictate this is a special and reserved key.
  • Enter the attribute name in lower case.
  • While you can’t explicitly set a user as unspecified, if you send a null or nil value or any value that isn’t true or false, Braze will pass this user to Google as UNSPECIFIED.
  • New users added or updated without specifying either consent attribute will be synced to Google with those consent attributes marked as unspecified.

If you attempt to sync an EEA or UK user without the necessary consent fields and granted status, Google will reject this and not serve ads to this end user. In addition, if an ad is served to an EEA or UK user without their explicit consent, you may be liable and could be at financial risk. For more details regarding the EU User Consent Policy for Customer Match upload partners, see Google’s FAQs.

Integration

Step 1: Connect Google account

To get started, go to Partner Integrations > Technology Partners > Google Ads and select Connect Google Ads. You’ll then be prompted with a modal to select the email associated with your Google Ads account and then grant Braze access to your Google Ads account.

Once you have successfully connected your Google Ads account, you will be taken back to your Google Ads partner page. You’ll then be prompted to select which ad accounts you would like to be accessed within the Braze workspace.

Step 2: Add a Google Audience step in Canvas Flow

Add a component in your Canvas and select Audience Sync.

Step 3: Sync setup

Click on the Custom Audience button to open the component editor.

Select Google as the desired Audience Sync partner.

Select the desired Google ad account. Under the Choose a New or Existing Audience dropdown, type in the name of a new or existing audience.

Create a New Audience
Enter a name for the new custom audience, select Add Users to Audience, and select which fields you would like to sync with Google. You can select the following fields to match to sync with Google:

  • Email
  • Phone
  • First/Last name
  • City
  • Country
  • Date of birth
  • Gender
  • Mobile Ad IDs
    • You must opt into either IDFA or GAID collection through the Braze SDKs.

Enter a name for the new custom audience, select Add Users to Audience, and select the first-party user field data to send to with your audience. You can choose either:

  • Customer Contact Info: Contains your users’ email or phone numbers, or both if they exist in Braze
  • Mobile Advertiser ID: Select either iOS IDFA or Android GAID

Next, save your audience by clicking the Create Audience button at the bottom of the step editor.

Expanded view of the Custom Audience Canvas component. Here, the desired Ad account is selected, a new audience is created, and the "customer contact info" checkbox is selected.

Users will be notified at the top of the step editor if the audience is created successfully or if errors arise during this process. Users can reference this audience for user removal later in the Canvas journey because the audience was created in draft mode.

An alert that appears once a new audience is created in the Canvas component.

When you launch a Canvas with a new audience, Braze will create a new custom audience upon launching the Canvas and subsequently sync users in near real-time as they enter the Google Audience component.

Sync with an Existing Audience
Braze also offers the ability to add or remove users from existing Google customer lists to ensure that these audiences are up-to-date. To sync with an existing audience, select an existing custom audience to sync to and then choose whether you want to Add to the audience or Remove from the audience. Braze will add or remove users in near real-time as they enter the Google Audience Step.

Once you’ve configured your Google Audience step, select Done. Your Google Audience step will include details about the new audience.

Expanded view of the Custom Audience Canvas component. Here, the desired Ad account and existing audience are selected, as well as the "Add user to Audience" radio button.

Step 4: Launch Canvas

Complete the remainder of your user journey within Canvas and then launch! If you have opted to create a new audience, Braze will create the audience within Google and then add users as they reach this step in your Canvas. If you have selected to add or remove users from an existing audience, Braze will either add or remove users when they reach this step in their user journey.

Users will then advance to the next component of the Canvas if there is one or exit the Canvas if it is the last step of the user journey.

User syncing and rate limit considerations

As users reach the Audience Sync component, Braze will sync these users in near real-time while respecting Google Ads API rate limits. What this means in practice is that Braze will try to batch and process as many users every 5 seconds before sending these users to Google.

Once a customer is close to reaching the Google Ads API rate limit, Google will provide feedback back to Braze around retry recommendations. If a Braze customer reaches their rate limit, Braze the Canvas will retry the sync for up to ~13 hours. If the sync is not possible, these users are listed under the Users Errored metric.

Understanding analytics

The following table includes metrics and descriptions to help you better understand analytics from your Audience Sync step.

Metric Description
Entered Number of users who entered this step to be synced to Google.
Proceeded to Next Step How many users advanced to the next component, if there is one. All users will auto-advance. If this is the last step in the Canvas branch, this metric will be 0.
Users Synced Number of users who have successfully been synced to Google.
User Not Synced Number of users that have not been synced due to missing fields to match or either consent attribute was set to false.
Users Errored Number of users who were not synced to Google due to an error, after ~13 hours of retries. For specific errors, like Google Ads API service disruptions, Canvas will retry the sync for up to ~13 hours. If the sync is still not possible at that point, the User Not Synced will be populated.
Users Pending Number of users currently being processed by Braze to sync to Google.
Exited Canvas Number of users who have exited the Canvas. This occurs when the last step in a Canvas is a Google step.

Troubleshooting

Why can I not select multiple fields to match in my Google Audience Step configuration?

Google Customer Match has strict requirements around how these audiences are formatted and what customer information is included. Specifically, mobile advertiser IDs need to be uploaded separately from customer contact information (such as email and phone number). For more details, refer to Google’s Customer Match documentation.

How long will it take for my audiences to sync in Google?

It can take anywhere between 6 to 12 hours for an audience to be synced into Google.

I’ve synced an audience, but the audience size in Google is zero.

For privacy purposes, the user list size will show zero until the list has at least 1,000 members. After that, the size will be rounded to the two most significant digits.

I’ve synced an audience into Google, but my ads are not serving.

Check that your audiences contain at least 5,000 users to ensure that ads start serving.

How do I resolve the “Mobile App IDs Deleted” error?

If you are syncing audiences to Google, this error will trigger if you have selected to sync mobile identifiers as part of your syncs but deleted your mobile app IDs from the Google partner page. To resolve this issue, ensure you have added the appropriate mobile app IDs for iOS and Android to the Google partner page.

HOW HELPFUL WAS THIS PAGE?
New Stuff!