Gerenciar configurações de consentimento (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. Confira tipos de consentimento para todos os parâmetros disponíveis.

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. Estabelecer o consentimento padrão.
  2. Atualizar o estado de consentimento com base na interação do usuário com suas definições de consentimento.

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. 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 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,
}];

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.

Os usuários do modo de consentimento precisam enviar dois parâmetros além do armazenamento do Google Ads e 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 definições de consentimento estão funcionando normalmente, acesse 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.