Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Configurer la collecte et l'utilisation des données Analytics

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Google Analytics offre des fonctionnalités qui vous permettent de contrôler la collecte et l'utilisation des données Analytics.

Désactiver la collecte de données Analytics

Dans certains cas, vous souhaiterez peut-être désactiver temporairement ou définitivement la collecte de données Analytics, par exemple pour recueillir le consentement de l'utilisateur final ou pour remplir des obligations légales. Google Analytics offre plusieurs options pour désactiver et désactiver la collecte Analytics. Utilisés ensemble, ils prennent en charge de nombreux cas d'utilisation typiques.

Désactiver temporairement la collecte

Si vous souhaitez désactiver temporairement la collecte Analytics, par exemple pour obtenir le consentement de l'utilisateur final avant de collecter des données, vous pouvez définir la valeur de FIREBASE_ANALYTICS_COLLECTION_ENABLED sur NO (booléen) dans le fichier Info.plist de votre application. Par exemple, affiché dans le XML source :

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key>
<false/>

Pour réactiver la collecte, par exemple après qu'un utilisateur final a donné son consentement, appelez la méthode d'instance setAnalyticsCollectionEnabled de Analytics . Par exemple:

Rapide

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
Analytics.setAnalyticsCollectionEnabled(true)

Objectif c

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Si vous avez besoin de suspendre à nouveau la collecte pour une raison quelconque, vous pouvez appeler

Rapide

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
Analytics.setAnalyticsCollectionEnabled(false)

Objectif c

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

et la collecte est suspendue jusqu'à ce que vous la réactiviez. La valeur définie par la méthode setAnalyticsCollectionEnabled persiste dans les exécutions d'application et remplace la valeur de FIREBASE_ANALYTICS_COLLECTION_ENABLED dans le fichier Info.plist de votre application. Une fois que vous avez défini une valeur pour setAnalyticsCollectionEnabled , la collection Analytics reste dans cet état jusqu'à ce que setAnalyticsCollectionEnabled soit appelé à nouveau, même si un utilisateur ferme et rouvre votre application.

Désactiver définitivement la collecte

Si vous devez désactiver définitivement la collecte Analytics dans une version de votre application, définissez FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED sur YES (booléen) dans le Info.plist file de votre application. La définition de FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED sur YES (booléen) est prioritaire sur toutes les valeurs de FIREBASE_ANALYTICS_COLLECTION_ENABLED dans le fichier Info.plist de votre application, ainsi que sur toutes les valeurs définies avec setAnalyticsCollectionEnabled .

Pour réactiver la collecte, supprimez FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED de votre Info.plist . Définir FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED sur NO (booléen) n'a aucun effet et entraîne le même comportement que FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED n'est pas défini dans votre fichier Info.plist .

Désactiver la collecte IDFA

Si vous avez installé Firebase via CocoaPods en ajoutant pod 'Firebase/Analytics' au Podfile de votre application et que vous souhaitez désactiver la collecte de l'IDFA (identifiant publicitaire d'un appareil) dans votre application Apple, assurez-vous que le cadre AdSupport n'est pas inclus dans votre application.

Pour installer Firebase sans aucune capacité de collecte d'IDFA, utilisez la sous-spécification suivante à la place du pod 'Firebase/Analytics' :

pod 'Firebase/AnalyticsWithoutAdIdSupport'

En savoir plus sur l'IDFA dans la documentation d'Apple :

Désactiver la collecte IDFV

Si vous souhaitez désactiver la collecte de l'IDFV (Identifier for Vendor) dans votre application Apple, définissez la valeur de GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED sur NO (booléen) dans le fichier Info.plist de votre application.

Configurer l'utilisation des données Analytics

Désactiver les fonctionnalités de publicité personnalisée

Si vous avez lié votre projet Google Analytics à un compte publicitaire ou activé une intégration d'annonces, ou opté pour le partage de données , vos données Analytics peuvent être éligibles pour une utilisation dans la publicité personnalisée. Cela signifie, par exemple, que vous pouvez utiliser des événements collectés tels que first_open pour créer et déployer des listes d'audience pour le remarketing, sauf si vous indiquez que ces données ne sont pas disponibles pour la publicité personnalisée.

Pour contrôler par programmation si les données Analytics d'un utilisateur doivent être utilisées pour la publicité personnalisée, définissez le comportement par défaut approprié dans le fichier AndroidManifest.xml de l'application, puis utilisez les méthodes décrites ci-dessous pour remplacer ce comportement par défaut.

Pour définir le comportement publicitaire personnalisé par défaut, définissez la valeur de GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS sur NO (booléen) dans le fichier Info.plist de votre application.

Vous pouvez également contrôler si les données collectées auprès des utilisateurs finaux peuvent être utilisées pour la personnalisation des annonces via le paramètre de personnalisation des annonces , disponible dans les paramètres de propriété de Google Analytics.

Réactiver les fonctionnalités de publicité personnalisée

Pour réactiver les fonctionnalités de publicité personnalisée pour un utilisateur au moment de l'exécution, par exemple après qu'un utilisateur final a donné son consentement, utilisez la méthode setUserProperty comme indiqué ci-dessous :

Rapide

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objectif c

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Si vous avez choisi de désactiver temporairement la collecte d'analyses (par exemple, jusqu'à ce qu'un utilisateur final donne son consentement) et que vous souhaitez contrôler les fonctionnalités de publicité personnalisée lors de la réactivation de la collecte d'analyses pour un utilisateur, assurez-vous que votre appel pour spécifier ce paramètre précède votre appel pour réactiver la collecte d'analyses. Par exemple:

Rapide

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objectif c

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Confirmez vos paramètres

Lorsque les signaux de personnalisation des annonces ont été désactivés pour un utilisateur via l'un des mécanismes définis ci-dessus, les groupes d'événements suivants enregistrés à partir de l'appareil de cet utilisateur contiendront une propriété utilisateur nommée "non_personalized_ads" avec une valeur de 1 pour indiquer que les événements de ce groupe ne sont pas disponibles. pour la publicité personnalisée. La désactivation de la publicité personnalisée n'affecte pas l'utilisation des données à des fins de mesure, y compris les rapports et l'attribution.

Voir vos modifications de configuration

Une fois que vous avez modifié vos paramètres Google Analytics, le SDK télécharge les modifications. Le processus est rapide et transparent, vous pouvez donc tester rapidement vos modifications. Lorsque vous apportez des modifications dans Analytics, le déploiement dans votre application peut prendre quelques minutes. Si votre application est en ligne, le processus de déploiement complet peut prendre jusqu'à une heure.