Configurar o modo de consentimento para apps

Esta página é destinada a desenvolvedores que usam o SDK do Google Analytics para Firebase no app e querem integrar o modo de consentimento. Se quiser uma introdução ao modo de consentimento, acesse Visão geral do modo de consentimento.

O Google Analytics oferece o modo de consentimento para ajustar o comportamento do seu SDK com base na autorização dos usuários. Você pode implementar o modo de consentimento de forma básica ou avançada. Se você não souber se deve implementar o modo de consentimento básico ou avançado, saiba mais sobre a diferença entre eles e consulte as diretrizes da sua empresa.

Antes de começar

Antes de gerenciar o consentimento do usuário, você precisará implementar:

  • SDK do Google Analytics para Firebase

  • Um banner de configurações de consentimento para conseguir o consentimento do usuário

Para configurar o modo de consentimento, você precisará:

  1. Defina o estado de consentimento padrão.

Por padrão, nenhum valor do modo de consentimento é definido. Para definir o estado de consentimento padrão em seu app:

  1. Abra o arquivo info.plist do app.

  2. Adicione os pares de chave-valor do modo de consentimento. A chave descreve o tipo de consentimento, e o valor indica o estado de consentimento. Os valores podem ser true, o que significa que o consentimento foi dado, ou false, o que indica que o consentimento foi negado.

    De acordo com as atualizações no modo de consentimento para tráfego no Espaço Econômico Europeu (EEE), um valor de eu_consent_policy pode ser definido para ad_user_data e ad_personalization. Isso significa que o consentimento é negado apenas para usuários em regiões sujeitas à Política de consentimento de usuários da União Europeia.

    Defina o seguinte:

    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS

  3. Salve as mudanças. Implemente o mecanismo para atualizar os valores de consentimento.

Por exemplo, para dar consentimento a todos os parâmetros por padrão:

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

Para atualizar os valores de consentimento após um app ser lançado, chame o método setConsent.

O valor definido pelo método setConsent substitui a configuração padrão e persiste nas execuções do app. O valor permanece no estado até que setConsent seja chamado novamente, mesmo que um usuário feche e reabra o app. O setConsent apenas atualiza os parâmetros especificados.

Se um usuário desistir do consentimento dado para armazenamento do Analytics ou Google Ads, o Google Analytics vai excluir todas as propriedades do usuário, incluindo o consentimento para ad_personalization. Para preservar a escolha do usuário quanto à personalização de anúncios, restaure o valor anterior para a personalização usando setConsent (Swift | Obj-C) .

O seguinte exemplo mostra o método setConsent atualizando os diferentes valores de consentimento para granted:

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Se um usuário decidir revogar o consentimento, atualize os estados de consentimento de acordo

Para oferecer um ecossistema de publicidade digital seguro, o Google está aumentando as restrições da nossa Política de consentimento de usuários da União Europeia.

Saiba mais sobre as atualizações no modo de consentimento para tráfego no Espaço Econômico Europeu (EEE).

Os usuários do modo de consentimento precisam enviar dois parâmetros além do armazenamento do Google Ads e do Analytics:

  1. Atualize o info.plist do app para incluir:

    <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

  2. Atualize as chamadas de consentimento para incluir os parâmetros para os dados do usuário do anúncio e de personalização de anúncio:

    Swift

    Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])

    Objective-C

    [FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Para verificar se as configurações de consentimento estão funcionando conforme o esperado, confira o console de depuração do Xcode referente ao seu app.

Siga estas etapas:

  1. Ative o registro detalhado no seu dispositivo.

  2. No console de depuração do Xcode, procure por:

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    Por exemplo, se o armazenamento do Google Ads estiver habilitado, será exibida a seguinte mensagem:

    ad_storage is granted.