Google UMP

Beginning January 16, 2024, publishers and developers using Google AdSense, Ad Manager, or AdMob will be required to use a Consent Management Platform (CMP) that has been certified by Google and has integrated with the IAB's Transparency and Consent Framework (TCF) when serving ads to users in the European Economic Area or the UK.

1. Enabling Google UMP

1.1 Enabling Google UMP on AdMob Dashboard

You first must create and publish the Google GDPR message on the AdMob dashboard. To do so:

1. Sign in to your AdMob account at apps.admob.com.

• Add your apps to the AdMob dashboard, if you have not done so already.

2. Click Privacy & messaging.

3. Click GDPR.

4. Click Create message. The GDPR message page opens.

5. Select the apps that you want to display your message:

•  Click Select apps.
• Select the desired apps.
•  Click Save.

6. Select the languages in which you want to display your message.

7. In the User consent options section, select Consent or Manage options.

⚠️Note: Do not check the Close (do not consent) option.

8. In the Targeting section, select Countries subject to GDPR (EEA and UK).

9. Click Continue. The Edit message page opens.

10. In the Message name field, enter a descriptive message name to help you identify the message later. This name appears only on the Privacy & messaging page and is not visible to users.

11. Select the Styling tab.

• Under the Global section, set the Secondary color to white (#ffffff).
• Under the Buttons section, set the Secondary color to gray (#6e6e6e).

12. Click Publish.

 

1.2 Customize Ad Partners List

⚠️Note

• In its default GDPR message, Google might not show all of your ad network partners. If you fail to include these networks, this could adversely affect your ad revenue. Follow the steps in this section to ensure all of your ad partners appear in the GDPR message.

To Customize which ad partners show in the GDPR message:

1. Open the GDPR settings page.

2. Click the edit icon () under the Review your ad partners section.

3. Select the Custom ad partners toggle and then select all of the networks you integrated in your app.

Google Name	TopOn SDK Network
Facebook	Meta
AppLovin Corp	Applovin
ironSource Mobile	IronSource
InMobi Choice	InMobi
BIGOAds	Bigo
Chartboost	Chartboost
UnityAds	Unity Ads
Ogury Ltd	Ogury
Google	Admob
StartApp	Start.io
Verve Group	Verve
Tapjoy	Tapjoy
Liftoff	Vungle
F@N communications	Nend
Fyber	Digital Turbine(Fyber)
Kidoz	Kidoz
Mobvista/Mintegral	Mintegral

⚠️Note

• Other advertising platforms that are not in this table, such as Pangle, Huawei, Maio, Appnext, MyTarget, Yandex, etc., are not in the Admob GDPR advertising partner list. TopOn will use pop-up consent results internally to set the GDPR reporting level of these ad Network platforms.

5. Click Save at the bottom of the GDPR settings page.

 

1.3 Enabling Google UMP in project

1. Add the dependency for the Google User Messaging Platform SDK to your build.gradle file (usually app/build.gradle)

dependencies {
    implementation("com.google.android.ump:user-messaging-platform:2.1.0")
}

2. Add gms.ads.APPLICATION_ID in AndroidManifest.xml.

<manifest>
    <application>
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

3. Add rules in proguard-android.txt.

-keep public class com.google.android.ump.*

4. Call ATSDK#showGDPRConsentDialog() and perform SDK initialization within the onDismiss() callback.

ATSDK.showGDPRConsentDialog(context, new ATGDPRConsentDismissListener() {
    @Override
    public void onDismiss(ConsentDismissInfo consentDismissInfo) {
        ATSDK.init(context, "your app id", "your app key");
    }
});

5. During the testing phase, you can simulate the UMP GDPR consent dialog popup in the European Union region with the following code:

❕Warning: This test code needs to be removed before going online

// deviceId can be filtered in logcat by calling ATSDK.showGDPRConsentDialog()
ATSDK.setDebuggerConfig(this, "", new ATDebuggerConfig.Builder().setUMPTestDeviceId("deviceid").build());

 

1.4 Add a consent revocation link to your app

⚠️Note

• Consent revocation is the process by which users in the EEA (European Economic Area), the UK, and Switzerland who consented to personalized ads can revoke that consent. 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.

Learn more by visiting here.

Please refer to the Google AdMob Ads SDK Documentation for privacy options.