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