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 setTagForUnderAgeOfConsent (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:

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

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 sobre regulamentações dos estados dos EUA, use 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 geografia.