Configurer le mode Consentement pour les applis

Cette page s'adresse aux développeurs qui utilisent le SDK Google Analytics pour Firebase dans leur application et souhaitent intégrer le mode Consentement. Pour en savoir plus sur le mode Consentement, consultez Présentation du mode Consentement.

Google Analytics propose le mode Consentement pour ajuster le comportement de votre SDK en fonction de l'état de consentement de vos utilisateurs. Vous pouvez implémenter le mode Consentement de manière basique ou avancée. Si vous ne savez pas si vous devez implémenter le mode Consentement de base ou avancé, découvrez le mode Consentement de base ou avancé et consultez les consignes de votre entreprise.

Important: Si le paramètre de consentement ad_storage ou analytics_storage est défini sur "denied", via un état de consentement par défaut ou la méthode setConsent, les données d'analyse associées à une instance d'application particulière sont désormais définitivement réinitialisées. Par exemple, si les données d'analyse sont réinitialisées pour toutes les instances d'application, le nombre d'utilisateurs peut être surévalué.

Si vous utilisez le SDK Google Analytics pour Firebase pour iOS, vous pouvez éviter ce problème en passant à la version 10.23.0. Si vous utilisez le SDK Android, vous pouvez éviter ce problème en procédant comme suit:

1. Ne définissez pas de valeurs par défaut pour ad_storage et analytics_storage dans le fichier manifeste de votre application.
2. Désactivez la collecte Analytics avant de définir l'état du consentement ad_storage et analytics_storage de l'instance d'application.
3. Une fois que vous avez reçu votre autorisation expresse, réactivez la collecte Analytics. Cela ne réinitialise pas les données Analytics.

Si vous souhaitez réinitialiser les données analytiques d'une instance d'application, utilisez l'API sur mesure. Pour voir un exemple Android, cliquez ici.

Nous publierons une mise à jour du SDK Android Google Analytics pour Firebase dans les semaines à venir afin d'ajuster ce comportement. Vous pourrez ensuite mettre à jour votre SDK et déterminer si d'autres modifications du mode Consentement sont adaptées à votre application.

Mode Consentement avancé Mode Consentement de base

iOS Android

Important: Le mode Consentement pour les applications a été mis à jour le 30 octobre 2023 et contient désormais deux paramètres supplémentaires. Si vous utilisez déjà le mode Consentement, passez à la v2 du mode Consentement. En savoir plus sur les modifications apportées au mode Consentement pour le trafic dans l'Espace économique européen (EEE)

Avant de commencer

Avant de pouvoir gérer le consentement des utilisateurs, vous devez implémenter:

• SDK Google Analytics pour Firebase

• Bannière des paramètres de consentement pour recueillir le consentement de l'utilisateur

  Conseil :Si vous ne souhaitez pas implémenter vous-même les paramètres de consentement, envisagez d'utiliser une plate-forme de gestion du consentement (CMP).

Configurer le mode Consentement

Pour configurer le mode Consentement:

1. Définir l'état du consentement par défaut

Définir l'état du consentement par défaut

Par défaut, aucune valeur n'est définie pour le mode Consentement. Pour définir l'état du consentement par défaut pour votre application, procédez comme suit:

1. Ouvrez le fichier AndroidManifest.xml de votre application.

2. Ajoutez les paires clé/valeur du mode Consentement. La clé décrit le type de consentement, et la valeur indique l'état du consentement. Les valeurs peuvent être true (le consentement a été accordé) ou false (le consentement a été refusé). Renseignez les champs suivants :

   • 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. Enregistrez les modifications. Implémentez ensuite le mécanisme permettant de mettre à jour les valeurs de consentement.

Par exemple, pour définir toutes les autorisations d'accès pour tous les paramètres par défaut:

<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" />

Modifier le consentement

Pour mettre à jour les valeurs de consentement après le lancement d'une application, appelez la méthode setConsent.

La valeur définie par la méthode setConsent remplace le paramètre par défaut et est conservée pour toutes les exécutions de l'application. La valeur reste dans cet état jusqu'à ce que setConsent soit appelé à nouveau, même si un utilisateur ferme et rouvre l'application. setConsent ne met à jour que les paramètres que vous spécifiez.

Si un utilisateur révoque le consentement qu'il a précédemment donné pour Analytics ou le stockage des annonces, Google Analytics supprime toutes les propriétés utilisateur, y compris le consentement pour ad_personalization. Pour conserver le choix de l'utilisateur concernant le consentement pour la personnalisation des annonces, restaurez la valeur précédente pour la personnalisation des annonces à l'aide de setConsent (Kotlin+KTX | Java) .

L'exemple suivant montre comment la méthode setConsent met à jour les différentes valeurs de consentement sur 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)
}