Compatibilidad de la IAB de EE.UU.

En esta guía, se describen los pasos necesarios para admitir el mensaje de las reglamentaciones estatales de EE.UU. como parte del SDK de UMP. Combina estas instrucciones con la sección Cómo comenzar, en la que se detalla cómo hacer que tu app se ejecute con el SDK de UMP y configurar tu mensaje. La siguiente guía es específica del mensaje de las reglamentaciones estatales de EE.UU.

Requisitos previos

Antes de continuar, asegúrate de hacer lo siguiente:

  • Actualiza el SDK de UMP a la versión más reciente. Para la compatibilidad con los mensajes de las reglamentaciones estatales de EE.UU., te recomendamos que uses la versión 2.1.0 o una posterior.
  • Completa la sección Comenzar. Asegúrate de implementar un punto de entrada de opciones de privacidad y renderizarlo si es necesario. Si completas esta guía, tendrás un punto de entrada para entregar el mensaje de las reglamentaciones de los estados de EE.UU. a tus usuarios.
  • Crea un mensaje de las reglamentaciones estatales de EE.UU. para las apps.
  • Si usas el mensaje sobre las reglamentaciones estatales de EE.UU. junto con otros, consulta Tipos de mensajes para los usuarios disponibles para comprender cuándo se muestran diferentes mensajes a los usuarios.

Para indicar si un usuario no tiene la edad de consentimiento, establece tagForUnderAgeOfConsent (TFUA). Cuando estableces TFUA en true, el SDK de UMP no solicita el consentimiento del usuario. Si tu app tiene un público mixto, configura este parámetro para los usuarios menores de edad para asegurarte de que no se solicite el consentimiento. Es tu responsabilidad configurar este parámetro cuando sea necesario para cumplir con la COPPA y otras reglamentaciones relevantes.

En el siguiente ejemplo, se configura TFUA como verdadero en una solicitud de consentimiento de UMP:

Swift

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

// Request an update for the consent information.
UMPConsentInformation.sharedInstance.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) {
          // ...
        }];

Después de que el usuario tome una decisión sobre las reglamentaciones estatales de EE.UU., puedes leer su elección desde el almacenamiento local de acuerdo con la especificación de Global Privacy Platform (GPP). Para obtener más información, consulta Detalles en la app. Ten en cuenta que el SDK de UMP solo propaga las claves IABGPP_GppSID y IABGPP_HDR_GppString.

Prueba tus mensajes sobre las reglamentaciones estatales de EE.UU.

Para probar los mensajes de las reglamentaciones estatales de EE.UU., usa UMPDebugGeographyRegulatedUSState debugGeography para forzar al SDK de UMP a tratar el dispositivo de prueba como si estuviera ubicado en un estado regulado de EE.UU. También puedes usar UMPDebugGeographyOther para forzar la supresión de los mensajes de las reglamentaciones estatales de EE.UU. Para obtener más detalles sobre debugGeography, consulta Cómo forzar una geografía.