Suporte do IAB nos EUA

Este guia descreve as etapas necessárias para oferecer suporte à mensagem de regulamentação dos estados dos EUA como parte do SDK do UMP. Combine essas instruções com o Guia de início, que detalha como fazer o app funcionar com o SDK da UMP e configurar a mensagem. As orientações a seguir são específicas para a mensagem das regulamentações estaduais dos EUA.

Pré-requisitos

Antes de continuar, faça o seguinte:

  • Atualize para a versão mais recente do SDK da UMP. Para suporte a mensagens de regulamentação de estados dos EUA, recomendamos usar a versão 2.1.0 ou mais recente.
  • Conclua Começar. Implemente um ponto de entrada de opções de privacidade e renderize-o, se necessário. Ao concluir este guia, você terá um ponto de entrada para veicular a mensagem das regulamentações estaduais dos EUA aos seus usuários.
  • Criar uma mensagem sobre as regulamentações estaduais dos EUA para apps.
  • Se você estiver usando a mensagem das regulamentações estaduais dos EUA com outras mensagens, consulte Tipos de mensagens disponíveis para os usuários para entender quando diferentes mensagens são exibidas aos usuários.

Para indicar se um usuário está abaixo da idade de consentimento, defina tagForUnderAgeOfConsent (TFUA). Quando você define o TFUA como true, o SDK do UMP não solicita o consentimento do usuário. Se o app tiver um público misto, defina esse parâmetro para usuários menores de idade para garantir que o consentimento não seja solicitado. É sua responsabilidade definir esse parâmetro quando necessário para obedecer à COPPA e a outras regulamentações relevantes.

O exemplo a seguir define TFUA como "true" em uma solicitação de consentimento do 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) {
          // ...
        }];

Depois que o usuário tomar uma decisão sobre as regulamentações estaduais dos EUA, você poderá ler a escolha dele no armazenamento local seguindo a especificação da Plataforma de Privacidade Global (GPP). Para mais detalhes, consulte Detalhes no app. O SDK da UMP preenche apenas as chaves IABGPP_GppSID e IABGPP_HDR_GppString.

Testar suas mensagens sobre as regulamentações estaduais dos EUA

Para testar as mensagens de regulamentação dos estados dos EUA, use o UMPDebugGeographyRegulatedUSState debugGeography para forçar o SDK da UMP a tratar o dispositivo de teste como se ele estivesse localizado em um estado regulamentado dos EUA. Também é possível usar UMPDebugGeographyOther para forçar a supressão das mensagens de regulamentações dos estados dos EUA. Para mais detalhes sobre debugGeography, consulte Forçar uma região.