Cette page est destinée aux développeurs qui utilisent le SDK Google Analytics pour Firebase dans leur application et qui souhaitent intégrer le mode Consentement. Pour une présentation du 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-en plus sur les différences entre les deuxet consultez les consignes de votre entreprise .
Avant de commencer
Pour pouvoir gérer le consentement des utilisateurs, vous devez implémenter les éléments suivants :
- SDK Google Analytics pour Firebase
Une bannière de paramètres de consentement pour recueillir le consentement utilisateur
Configurer le mode Consentement
Pour configurer le mode Consentement :
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 :
- Ouvrez le fichier info.plist de votre application.
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(consentement accordé) oufalse(consentement refusé).Conformément aux modifications apportées au mode Consentement pour le trafic dans l'Espace économique européen (EEE), la valeur
eu_consent_policypeut être définie pourad_user_dataetad_personalization, ce qui signifie que le consentement n'est refusé que pour les utilisateurs des régions soumises aux Règles relatives au consentement de l'utilisateur dans l'UE.Renseignez les champs suivants :
GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGEGOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGEGOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATAGOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
Enregistrez les modifications. Ensuite, implémentez le mécanisme permettant de mettre à jour les valeurs du consentement.
Par exemple, pour définir par défaut le consentement pour tous les paramètres :
<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/>
Modifier le consentement
Pour mettre à jour les valeurs du consentement après le lancement d'une application, appelez la
setConsent méthode.
La valeur définie par la méthode setConsent remplace le paramètre par défaut et est conservée lors des 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 retire son consentement précédemment accordé pour le stockage Analytics ou publicitaire, Google Analytics supprime toutes les propriétés utilisateur, y compris le consentement pour
ad_personalization. Pour conserver le choix de l'utilisateur concernant la personnalisation des annonces, restaurez la valeur précédente pour la personnalisation des annonces à l'aide desetConsent(Swift | Obj-C) .
L'exemple suivant montre la méthode setConsent qui met à jour les différentes valeurs de consentement sur 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 utilisateur décide de révoquer son consentement, assurez-vous de mettre à jour les états de consentement en conséquence et de désactiver à nouveau la collecte Analytics à l'aide de setAnalyticsCollectionEnabled().
Passer au mode Consentement v2
Google s'engage de façon continue en faveur d'un écosystème de publicité digitale respectueux de la confidentialité . Dans cette optique, nous renforçons l'application de nos Règles relatives au consentement de l'utilisateur dans l'UE.
En savoir plus sur les Modifications apportées par Google au mode Consentement pour le trafic dans l'Espace économique européen (EEE).
Les utilisateurs du mode Consentement doivent envoyer deux nouveaux paramètres en plus du stockage publicitaire et du stockage Analytics :
Modifiez le fichier info.plist de votre application pour inclure les éléments suivants :
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>Modifiez vos appels de consentement pour inclure les paramètres des données utilisateur publicitaires et de la personnalisation des annonces :
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])Objective-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
Vérifier les paramètres de consentement
Vous pouvez vérifier que vos paramètres de consentement fonctionnent comme prévu en consultant la console de débogage Xcode de votre application.
Procédez comme suit :
- Activez la journalisation détaillée sur votre appareil.
Dans la console de débogage Xcode, recherchez les éléments suivants :
ad_storageanalytics_storagead_user_dataad_personalization
Par exemple, si le stockage publicitaire est activé, le message suivant s'affiche :
ad_storage is granted.