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.

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

Pour configurer le mode Consentement:

  1. Définir l'état du consentement par défaut
  2. Mettez à jour l'état du consentement en fonction de l'interaction de l'utilisateur avec vos paramètres de consentement.

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 info.plist 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:

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

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 (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, assurez-vous de mettre à jour les états de consentement en conséquence

Google s'engage de façon continue en faveur d'un écosystème de publicité numérique 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.

Découvrez 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 du stockage des analyses:

  1. 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/>
    
  2. Mettez à jour vos appels de consentement pour inclure les paramètres liés aux données utilisateur et à 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,
    }];
    

Vous pouvez vérifier que vos paramètres de consentement fonctionnent comme prévu en affichant la console de débogage Xcode de votre application.

Procédez comme suit :

  1. Activez la journalisation détaillée sur votre appareil.
  2. 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.