Suporte do IAB nos EUA

Este guia descreve as etapas necessárias para oferecer suporte à mensagem das regulamentações estaduais dos EUA como parte do SDK da UMP. Combine estas instruções com o guia Começar, que detalha como executar seu app com o SDK da UMP e configurar sua 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ções estaduais dos EUA, recomendamos usar a versão 2.1.0 ou mais recente.
• Conclua Começar. Implemente um ponto de entrada para as opções de privacidade e renderize-o se necessário. Ao concluir este guia, você terá um ponto de entrada para veicular a mensagem sobre as regulamentações estaduais dos EUA aos seus usuários.
• Crie 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 aos usuários disponíveis para entender quando diferentes mensagens são mostradas aos usuários.

Definir a tag para usuários abaixo da idade de consentimento

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

O exemplo a seguir define TFUA como "true" em uma solicitação de consentimento da UMP:

// 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 }

  // ...
}

// 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) {
          // ...
        }];

Ler opções de consentimento

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 das regulamentações dos estados dos EUA, use o UMPDebugGeographyRegulatedUSState debugGeography para forçar o SDK da UMP a tratar seu dispositivo de teste como se ele estivesse localizado em um estado regulamentado dos EUA. Você também pode usar UMPDebugGeographyOther para forçar a supressão das mensagens sobre regulamentações estaduais dos EUA. Para mais detalhes sobre debugGeography, consulte Forçar uma região geográfica.