Gestionar la configuración del consentimiento (aplicaciones)

Esta página está dirigida a desarrolladores que usan el SDK de Google Analytics for Firebase en su aplicación y quieren integrar el modo de consentimiento. Si quieres ver una introducción al modo de consentimiento, consulta el resumen del modo de consentimiento.

Google Analytics ofrece el modo de consentimiento para ajustar el comportamiento del SDK según el estado del consentimiento de los usuarios. Consulta los tipos de consentimiento para todos los parámetros disponibles.

Antes de empezar

Antes de empezar a gestionar el consentimiento de los usuarios, necesitas implementar lo siguiente:

  • SDK de Google Analytics for Firebase

  • Un banner de configuración del consentimiento para registrar el consentimiento de los usuarios.

Para configurar el modo de consentimiento, necesitas hacer lo siguiente:

  1. Definir el consentimiento predeterminado.
  2. Actualizar el estado del consentimiento en función de las interacciones del usuario con tu configuración del consentimiento.

De forma predeterminada, el modo de consentimiento no tiene ningún valor asignado. Para definir el estado predeterminado del consentimiento de tu aplicación, haz lo siguiente:

  1. Abre el archivo info.plist de tu aplicación.

  2. Añade los pares clave-valor del modo de consentimiento. La clave describe el tipo de consentimiento y el valor indica el estado del consentimiento. Los valores pueden ser o bien true —que significa que se ha dado el consentimiento—, o bien false, que significa que se ha denegado. Configura lo siguiente:

    • 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. Guarda los cambios. A continuación, implementa el mecanismo para actualizar los valores del consentimiento.

Por ejemplo, para que se dé consentimiento a todos los parámetros de forma predeterminada, haz lo siguiente:

<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 actualizar los valores del consentimiento después de que se haya iniciado la aplicación, llama al método setConsent.

El valor que asigna el método setConsent anula el ajuste predeterminado y se mantiene en todas las ejecuciones de la aplicación. El valor se mantiene en ese estado hasta que se vuelve a llamar a setConsent, aunque un usuario cierre la aplicación y la vuelva a abrir. setConsent solo actualiza los parámetros que especifiques.

Si el usuario deniega el consentimiento que había dado para el almacenamiento de analíticas o de anuncios, Google Analytics elimina todas las propiedades del usuario, incluido el consentimiento de ad personalization. Para mantener la opción del consentimiento para la personalización de anuncios que ha elegido el usuario, restaura el valor anterior del ajuste de personalización de anuncios usando setConsent (Swift | Obj-C) .

El siguiente ejemplo muestra el método setConsent actualizando los distintos valores del consentimiento a granted:

Swift

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

Objective‑C

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

Como parte de nuestro compromiso continuo con un ecosistema de publicidad digital con protección de la privacidad, en Google estamos reforzando la implementación de nuestra Política de Consentimiento de Usuarios de la Unión Europea.

Los usuarios que utilicen el modo de consentimiento tienen que enviar dos parámetros nuevos aparte del almacenamiento de anuncios y de analíticas:

  1. Actualiza el archivo info.plist de tu aplicación para que incluya lo siguiente:

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

  2. Actualiza tus llamadas de consentimiento para que incluyan los parámetros de datos de usuario de anuncios y de personalización de anuncios:

    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 que la configuración del consentimiento funciona correctamente, accede a la consola de depuración de Xcode de tu aplicación.

Sigue estos pasos:

  1. Habilita el registro detallado en tu dispositivo.

  2. En la consola de depuración de Xcode, busca lo siguiente:

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    Por ejemplo, si el almacenamiento de anuncios está habilitado, verás el siguiente mensaje:

    ad_storage is granted.