Configura l'SDK UMP

L'SDK Google User Messaging Platform (UMP) è uno strumento per la privacy e i messaggi che ti aiuta a gestire le scelte relative alla privacy. Per ulteriori informazioni, consulta Informazioni su Privacy e messaggi.

Prerequisiti

• Livello API Android 21 o versioni successive

Crea un tipo di messaggio

Crea messaggi per gli utenti con uno dei tipi di messaggi per gli utenti disponibili nella scheda Privacy e messaggi del tuo account AdMob. L'SDK UMP tenta di visualizzare un messaggio sulla privacy creato dall'ID applicazione AdMob impostato nel progetto.

Installazione con Gradle

Aggiungi la dipendenza per l'SDK Google User Messaging Platform al file Gradle a livello di app del modulo, in genere app/build.gradle:

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

Dopo aver apportato le modifiche al build.gradle dell'app, assicurati di sincronizzare il progetto con i file Gradle.

Aggiungi l'ID applicazione

Puoi trovare l'ID applicazione nell'UI di AdMob. Aggiungi l'ID al tuo AndroidManifest.xml con il seguente snippet di codice:

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

Ottenere le informazioni sul consenso dell'utente

Per ottenere le informazioni sul consenso dell'utente:

Dichiara un'istanza di ConsentInformation:

private final ConsentInformation consentInformation;

private lateinit var consentInformation: ConsentInformation

Inizializza l'istanza ConsentInformation:

consentInformation = UserMessagingPlatform.getConsentInformation(context);

consentInformation = UserMessagingPlatform.getConsentInformation(context)

Devi richiedere un aggiornamento delle informazioni sul consenso dell'utente a ogni avvio dell'app, utilizzando requestConsentInfoUpdate(). Questa richiesta controlla quanto segue:

• Se è necessario il consenso. Ad esempio, il consenso è richiesto per la prima volta o la precedente decisione sul consenso è scaduta.
• Se è necessario un punto di accesso alle opzioni sulla privacy. Alcuni messaggi relativi alla privacy richiedono alle app di consentire agli utenti di modificare le proprie opzioni per la privacy in qualsiasi momento.

// Requesting an update to consent information should be called on every app launch.
consentInformation.requestConsentInfoUpdate(
    activity,
    params,
    () -> // Called when consent information is successfully updated.
    requestConsentError -> // Called when there's an error updating consent information.
GoogleMobileAdsConsentManager.java

// Requesting an update to consent information should be called on every app launch.
consentInformation.requestConsentInfoUpdate(
  activity,
  params,
  {
    // Called when consent information is successfully updated.
  },
  { requestConsentError ->
    // Called when there's an error updating consent information.
  },
)
GoogleMobileAdsConsentManager.kt

Carica e presenta il modulo del messaggio sulla privacy

Dopo aver ricevuto lo stato del consenso più aggiornato, chiama loadAndShowConsentFormIfRequired() per caricare i moduli necessari per raccogliere il consenso dell'utente. Dopo il caricamento, i moduli vengono visualizzati immediatamente.

UserMessagingPlatform.loadAndShowConsentFormIfRequired(