Cómo configurar el modo de consentimiento para aplicaciones

Esta página está dirigida a 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 forma básica o avanzada. Si no sabes si implementar el modo de consentimiento básico o avanzado, obtén más información sobre el modo de consentimiento básico o 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 del usuario

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

  1. Establece el estado de consentimiento predeterminado.

De forma predeterminada, no se establece ningún valor para el modo de consentimiento. Para establecer el estado de consentimiento predeterminado de tu app, haz lo siguiente:

  1. Abre el archivo AndroidManifest.xml de tu app.

  2. 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, o false, que significa que se rechazó el consentimiento. Establece 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 de consentimiento.

Por ejemplo, para establecer todos los consentimientos otorgados para todos los parámetros de forma predeterminada, haz lo siguiente:

<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />

Para actualizar los valores de consentimiento después de iniciar una app, llama al método setConsent.

El valor que establece el método setConsent anula la configuración predeterminada y se mantiene 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 especifiques.

Si un usuario retira el consentimiento otorgado anteriormente para el almacenamiento de Analytics o anuncios, Google Analytics borra 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 para la personalización de anuncios con setConsent (Kotlin+KTX | Java) .

En el siguiente ejemplo, se muestra que el método setConsent actualiza los diferentes valores de consentimiento a granted:

Java

// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);

mFirebaseAnalytics.setConsent(consentMap);

Kotlin

Firebase.analytics.setConsent {
  analyticsStorage(ConsentStatus.GRANTED)
  adStorage(ConsentStatus.GRANTED)
  adUserData(ConsentStatus.GRANTED)
  adPersonalization(ConsentStatus.GRANTED)
}