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.

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:

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

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.