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.
Avant de commencer
Avant de pouvoir gérer le consentement des utilisateurs, vous devez implémenter les éléments suivants:
- SDK Google Analytics pour Firebase
Bannière de paramètres de consentement pour recueillir le consentement de l'utilisateur
Configurer le mode Consentement
Pour configurer le mode Consentement, vous devez:
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
, ce qui signifie que le consentement a été accordé, oufalse
, ce qui signifie que le consentement a été refusé.Conformément aux modifications apportées au mode Consentement pour le trafic dans l'Espace économique européen (EEE), une valeur de
eu_consent_policy
peut être définie pourad_user_data
etad_personalization
, ce qui signifie que le consentement n'est refusé que pour les utilisateurs situés dans les régions soumises aux règles relatives au consentement de l'utilisateur dans l'UE.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
Enregistrez les modifications. Ensuite, implémentez le mécanisme permettant de mettre à jour les valeurs du consentement.
Par exemple, pour définir le consentement pour tous les paramètres par défaut:
<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 méthode setConsent
.
La valeur définie par la méthode setConsent
remplace le paramètre par défaut et persiste entre les exécutions de l'application. La valeur reste dans cet état jusqu'à ce que setConsent
soit rappelé, même si un utilisateur ferme, puis rouvre l'application. setConsent
ne met à jour que les paramètres que vous spécifiez.
Si un utilisateur retire le consentement qu'il avait 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 consentement de l'utilisateur pour 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 comment la méthode setConsent
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, veillez à mettre à jour les états de consentement en conséquence
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 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 des annonces et des données analytiques:
Mettez à jour 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/>
Mettez à jour vos appels de consentement pour inclure les paramètres des données utilisateur 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_storage
analytics_storage
ad_user_data
ad_personalization
Par exemple, si le stockage des annonces est activé, le message suivant s'affiche:
ad_storage is granted.