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. Siga estas instruções em conjunto com o Começar, 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úncio, o SDK da UMP não vai coletar nenhuma informação que permita ao Google determinar se os usuários com menos de idade de consentimento usam ou não o app. Para mais informações sobre as restrições de processamento de dados para esses usuários, consulte Marcar uma solicitação de anúncio de um app com tratamento para direcionamento a crianças.

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

Java

ConsentRequestParameters params = new ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build();

consentInformation = UserMessagingPlatform.getConsentInformation(this);
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    (OnConsentInfoUpdateSuccessListener) () -> {
      // ...
    },
    (OnConsentInfoUpdateFailureListener) requestConsentError -> {
      // ...
    });

Kotlin

val params = ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build()

consentInformation = UserMessagingPlatform.getConsentInformation(this)
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    ConsentInformation.OnConsentInfoUpdateSuccessListener {
      // ...
    },
    ConsentInformation.OnConsentInfoUpdateFailureListener {
      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 3.1.0 ou mais recente do UMP.