GDPR IAB support

This guide outlines the steps required to support the GDPR IAB TCF v2 message as part of the UMP SDK. It is intended to be paired with Get started which gives an overview of how to get your app running with the UMP SDK and the basics of setting up your message. The guidance below is specific to the GDPR IAB TCF v2 message.

Prerequisites

Delay app measurement

By default, the Google Mobile Ads SDK initializes app measurement and begins sending user-level event data to Google immediately when the app starts. This initialization behavior ensures that you can enable AdMob user metrics without making additional code changes.

However, if your app requires user consent before these events can be sent, you can delay app measurement until you explicitly initialize the Mobile Ads SDK or load an ad.

To delay app measurement for both Android and iOS in your Unity project, follow the steps for both platforms.

In the Unity editor, select Assets > Google Mobile Ads > Settings from the menu.

Click Delay app measurement checkbox under Google AdMob section.

Consent revocability is a requirement of the Privacy & messaging user consent program. You must provide a link in your app's menu that allows users who want to revoke consent to do so, then present the consent message to those users again.

To accomplish this:

  1. Load a form every time the user launches your app, so that the form is ready to display in case the user wishes to change their consent setting.
  2. Present the form when the user selects the link in your app's menu.

    void ShowForm()
    {
        _consentForm.Show(OnShowForm);
    }
    
    void OnShowForm(FormError error)
    {
        if (error != null)
        {
            // Handle the error.
            UnityEngine.Debug.LogError(error);
            return;
        }
    
        // Handle dismissal by reloading form.
        LoadForm();
    }
    

Mediation

Follow the steps in Add ad partners to published GDPR messages to add your mediation partners to the ad partners list. Failure to do so can lead to partners failing to serve ads on your app.

Mediation partners might also have additional tools to help with GDPR compliance. See a specific partner's integration guide for more details.

Troubleshooting

Error 3.3: The TC string last updated date was more than 13 months ago
Consent must be reobtained from the user. You should call Update() at the start of every app session. If the TC string is expired, the UMP SDK indicates that consent must be reobtained by setting ConsentStatus to ConsentStatus.Required. If you haven't already, implement a request to load and present a new UMP form in your app.