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.

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

Para indicar se um usuário está abaixo da idade de consentimento, defina setTagForUnderAgeOfConsent (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.

Importante: o SDK do UMP não encaminha a tag TFUA definida nas solicitações de consentimento para o SDK dos anúncios para dispositivos móveis do Google. É necessário definir explicitamente o tagForUnderAgeOfConsent ou tagForChildDirectectedTreatment nas solicitações de anúncios. Se você não definir tagForUnderAgeOfConsent ou tagForChildDirectectedTreatment em solicitações de anúncios, o SDK da UMP não vai coletar nenhuma informação que permita ao Google determinar se os usuários com menos de idade usam ou não o app. Para mais informações sobre as restrições de processamento de dados para esses usuários, consulte

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

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 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.

Observação: UMPDebugGeographyRegulatedUSState está disponível apenas na versão 2.7.0 ou mais recente do UMP.