Assistance de l'IAB aux États-Unis

Ce guide décrit les étapes nécessaires pour prendre en charge le message sur les réglementations dans les États américains dans le SDK UMP. Associez ces instructions à Premiers pas, qui explique comment exécuter votre application avec le SDK UMP et configurer votre message. Les conseils suivants concernent spécifiquement le message lié aux réglementations des États américains.

Prérequis

Avant de continuer, assurez-vous d'avoir effectué les actions suivantes :

  • Passez à la dernière version du SDK UMP. Pour la prise en charge des messages concernant les réglementations des États américains, nous vous recommandons d'utiliser la version 2.1.0 ou ultérieure.
  • Suivez les étapes de Premiers pas. Veillez à implémenter un point d'entrée pour les options de confidentialité et à l'afficher si nécessaire. En suivant ce guide, vous disposez d'un point d'entrée pour diffuser votre message sur les réglementations des États américains à vos utilisateurs.
  • Créez un message lié aux réglementations des États américains pour les applications.
  • Si vous utilisez le message lié aux réglementations dans les États américains en même temps que d'autres messages, consultez Types de messages utilisateur disponibles pour savoir quand les différents messages s'affichent auprès de vos utilisateurs.

Pour indiquer si un utilisateur n'a pas atteint l'âge de consentement, définissez setTagForUnderAgeOfConsent (TFUA). Lorsque vous définissez TFUA sur true, le SDK UMP ne demande pas le consentement de l'utilisateur. Si votre application cible une audience mixte, définissez ce paramètre pour les utilisateurs enfants afin de vous assurer qu'aucun consentement ne leur est demandé. Il vous incombe de définir ce paramètre lorsque cela est nécessaire pour respecter la loi COPPA et les autres réglementations applicables.

L'exemple suivant définit TFUA sur "true" dans une demande de consentement UMP :

Java

ConsentRequestParameters params = new ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build();

consentInformation = UserMessagingPlatform.getConsentInformation(this);
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    (OnConsentInfoUpdateSuccessListener) () -> {
      // ...
    },
    (OnConsentInfoUpdateFailureListener) requestConsentError -> {
      // ...
    });

Kotlin

val params = ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build()

consentInformation = UserMessagingPlatform.getConsentInformation(this)
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    ConsentInformation.OnConsentInfoUpdateSuccessListener {
      // ...
    },
    ConsentInformation.OnConsentInfoUpdateFailureListener {
      requestConsentError ->
      // ...
    })

Une fois que l'utilisateur a pris une décision concernant les réglementations des États américains, vous pouvez lire son choix à partir du stockage local en suivant la spécification de la Global Privacy Platform (GPP). Pour en savoir plus, consultez Détails dans l'application. Notez que le SDK UMP ne renseigne que les clés IABGPP_GppSID et IABGPP_HDR_GppString.

Tester vos messages concernant les réglementations des États américains

Pour tester les messages concernant les réglementations des États américains, utilisez UMPDebugGeographyRegulatedUSState debugGeography pour forcer le SDK UMP à traiter votre appareil de test comme s'il était situé dans un État américain soumis à des réglementations. Vous pouvez également utiliser UMPDebugGeographyOther pour forcer la suppression des messages sur les réglementations des États américains. Pour en savoir plus sur debugGeography, consultez Forcer une zone géographique.