Esta página está destinada a los desarrolladores que usan el SDK de Google Analytics para Firebase en su app y desean integrar el modo de consentimiento. Para obtener una introducción al modo de consentimiento, consulta Descripción general del modo de consentimiento.
Google Analytics ofrece el modo de consentimiento para ajustar el comportamiento de tu SDK según el estado de consentimiento de tus usuarios. Puedes implementar el modo de consentimiento de manera básica o avanzada. Si no estás seguro de implementar el modo de consentimiento básico o avanzado, obtén más información sobre el modo de consentimiento básico y el avanzado y consulta los lineamientos de tu empresa.
Antes de comenzar
Para poder administrar el consentimiento de los usuarios, debes implementar lo siguiente:
- SDK de Google Analytics para Firebase
Un banner de configuración de consentimiento para obtener el consentimiento de los usuarios
Cómo configurar el modo de consentimiento
Para configurar el modo de consentimiento, debes hacer lo siguiente:
Establece el estado de consentimiento predeterminado
De forma predeterminada, no se establecen valores del modo de consentimiento. Para establecer el estado de consentimiento predeterminado de tu app, haz lo siguiente:
- Abre el archivo info.plist de tu app.
Agrega los pares clave-valor del modo de consentimiento. La clave describe el tipo de consentimiento y el valor indica el estado de consentimiento. Los valores pueden ser
true
, que significa que se otorgó el consentimiento, ofalse
, que significa que se rechazó el consentimiento. Establezca 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
Guarda los cambios. A continuación, implementa el mecanismo para actualizar los valores de consentimiento.
Por ejemplo, para establecer la opción de otorgar el consentimiento para 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/>
Actualizar consentimiento
Para actualizar los valores de consentimiento después de que se inicie una app, llama al método setConsent
.
El valor establecido por el método setConsent
anula la configuración predeterminada y persiste entre las ejecuciones de la app. El valor permanece en ese estado hasta que se vuelve a llamar a setConsent
, incluso si un usuario cierra y vuelve a abrir la app. setConsent
solo actualiza los parámetros que especificas.
Si un usuario retira su consentimiento previo para usar Analytics o el almacenamiento de anuncios, Google Analytics borrará todas las propiedades del usuario, incluido el consentimiento para
ad_personalization
. Para conservar la elección de consentimiento del usuario para la personalización de anuncios, restablece el valor anterior de la personalización de anuncios consetConsent
(Swift | Obj-C) .
En el siguiente ejemplo, se muestra el método setConsent
que actualiza los diferentes valores de 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,
}];
Si un usuario decide revocar su consentimiento, asegúrate de actualizar los estados de consentimiento según corresponda
Actualizar a la versión 2 del modo de consentimiento
Como parte del compromiso permanente de Google con un ecosistema de publicidad digital que resguarde la privacidad, fortaleceremos la aplicación de nuestra Política de Consentimiento de Usuarios de la UE.
Obtén más información sobre las actualizaciones del modo de consentimiento para el tráfico en el Espacio Económico Europeo (EEE) de Google.
Los usuarios del modo de consentimiento deben enviar dos parámetros nuevos, además del almacenamiento de anuncios y el de estadísticas:
Actualiza el archivo info.plist de tu app 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/>
Actualiza tus llamadas de consentimiento para incluir los parámetros de los datos del usuario del anuncio y la personalización del anuncio:
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])
Objective‑C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
Cómo verificar la configuración de consentimiento
Para verificar que tu configuración de consentimiento funcione según lo previsto, consulta la consola de depuración de Xcode para tu app.
Lleve a cabo los pasos siguientes:
- Habilita el registro detallado en tu dispositivo.
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á el siguiente mensaje:
ad_storage is granted.