Assistance de l'IAB aux États-Unis

Sélectionnez une plate-forme : Android iOS

Ce guide décrit les étapes nécessaires pour prendre en charge le message lié aux réglementations des É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 lié aux réglementations des États américains.

Prérequis

Avant de continuer, assurez-vous d'effectuer les opérations suivantes :

  • Installez la dernière version du SDK UMP. Pour la prise en charge des messages liés aux réglementations des États américains, nous vous recommandons d'utiliser la version 2.1.0 ou une version ultérieure.
  • Configurez le SDK UMP. Veillez à implémenter un point d'entrée pour les options de confidentialité et à le rendre si nécessaire. En suivant ce guide, vous disposerez d'un point d'entrée pour diffuser votre message lié aux réglementations des États américains auprès de 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 des États américains avec d'autres messages, consultez Types de messages utilisateur disponibles pour savoir quand les différents messages sont présentés à 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 non-adultes 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 d'autres réglementations pertinentes.

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

Swift

// Create a UMPRequestParameters object.
let parameters = RequestParameters()
// Indicate the user is under age of consent.
parameters.isTaggedForUnderAgeOfConsent = true

// Request an update for the consent information.
ConsentInformation.shared.requestConsentInfoUpdate(with: parameters) {
  [weak self] requestConsentError in
  guard let self else { return }

  // ...
}

Objective-C

// Create a UMPRequestParameters object.
UMPRequestParameters *parameters = [[UMPRequestParameters alloc] init];
// Indicate the user is under age of consent.
parameters.tagForUnderAgeOfConsent = YES;

// Request an update for the consent information.
[UMPConsentInformation.sharedInstance
    requestConsentInfoUpdateWithParameters:parameters
        completionHandler:^(NSError *_Nullable 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 remplit que les clés IABGPP_GppSID et IABGPP_HDR_GppString.

Tester votre message lié aux réglementations des États américains

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