Google UMP SDK Gudelines

1. Background

Starting January 16, 2024, publishers and developers using Google AdSense, Ad Manager, or AdMob when serving ads to users in the European Economic Area or the United Kingdom must use Google-certified transparency and user input that has been approved by the IAB Consultation Management Platform (CMP) integrated with the Consultation Framework (TCF)

Starting from 6.2.87, TopOn SDK provides a compatible Google UMP SDK method to configure the GDPR level. TopOn SDK internally sets the GDPR reporting level of the third-party advertising platform based on this level.

2. How to Setup UMP

2.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:

1.  Click Select apps.
2.  Select the desired apps.
3.  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.

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.

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

12. Click Publish.

2.2 Customize Ad Partners List

Note: By default, Google might not show all of your ad partners in your GDPR message. 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.

Meta

Applovin

Chartboost

Chartboost

IronSource

Bigo

UnityAds

AdColony

AdColony

Admob

StartApp

Start.io【StartApp】

PubNative【Verve】

Tapjoy

Tapjoy

Vungle

F@N communications

Kidoz

Kidoz

Mintegral

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

2.3 Enabling Google UMP

Android

Start by adding the dependency for the Google User Messaging Platform SDK to your module's app-level Gradle file (usually app/build.gradle)

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

iOS

Start by adding the dependency for the Google User Messaging Platform SDK to your podfile)

pod 'GoogleUserMessagingPlatform'

Show UMP Page

Call the ATSDKAPI.showGDPRConsentDialog API and perform SDK initialization within the onDismiss callback. ATSDKAPI.showGDPRConsentDialog will internally determine whether the UMP SDK is integrated. If it is integrated, it will use the UMP SDK Api to pop up a GDPR information pop-up window. If there is no integration, it will use the TopOn GDPR information pop-up window in the European Union to let the user select the GDPR level.Note: You need to initiate an ad request after the SDK is initialized.

public void showGDPRConsentDialog(){
    Debug.Log ("Developer showGDPRConsentDialog");

    ATSDKAPI.showGDPRConsentDialog(new ConsentDismissListener());
}


private class ConsentDismissListener : ATConsentDismissListener
{
    public void onConsentDismiss()
    {
        Debug.Log("Developer callback onConsentDismiss(): call initSDK() to init sdk in this callback");
    }
}

2.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.