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 à la section Premiers pas, qui explique comment exécuter votre application avec le SDK UMP et configurer votre message. Les conseils suivants sont spécifiques au message concernant les réglementations dans les États américains.

Prérequis

Avant de continuer, assurez-vous de suivre les étapes suivantes:

  • Installez la dernière version du SDK UMP. Pour la prise en charge des messages conformément aux réglementations des États américains, nous vous recommandons d'utiliser la version 2.1.0 ou ultérieure.
  • Terminez la section 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 dans les États américains auprès de vos utilisateurs.
  • Créez un message lié aux réglementations dans les États américains pour vos applications.
  • Si vous utilisez le message lié aux réglementations dans les États américains avec d'autres messages, consultez la section Types de messages destinés aux utilisateurs disponibles pour comprendre 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 que le consentement n'est pas demandé. Il vous incombe de définir ce paramètre si nécessaire pour respecter la loi COPPA et les autres réglementations applicables.

L'exemple suivant définit TFUA sur "true" dans une requête d'autorisation 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 conformément aux spécifications de la Global Privacy Platform (GPP). Pour en savoir plus, consultez la section 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 dans les États américains

Pour tester vos 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 se trouvait dans un État américain réglementé. Vous pouvez également utiliser UMPDebugGeographyOther pour forcer la suppression des messages concernant les réglementations dans les États américains. Pour en savoir plus sur debugGeography, consultez la section Forcer une zone géographique.