[GA4] À propos de l'importation de données

Importer des données à partir de sources externes et les associer à vos données Analytics

Pourquoi utiliser l'importation de données ?

Chaque système de gestion que vous utilisez génère ses propres données. Votre CRM peut contenir des informations comme le niveau de fidélité des clients, les valeurs vie client et les préférences concernant les produits. Si vous êtes un éditeur Web, votre système de gestion de contenu stocke peut-être des dimensions comme l'auteur et la catégorie de l'article. Si vous gérez un site d'e-commerce, vous stockez des attributs liés aux produits, comme le prix, le style et la taille.

De plus, vous utilisez Analytics pour mesurer le trafic et les performances sur votre site Web et dans votre application.

Généralement, chaque ensemble de données est compartimenté, indépendamment des autres données. L'importation de données vous permet d'associer toutes ces données dans Analytics selon un calendrier défini, afin de les décloisonner, d'obtenir de nouveaux insights et de démocratiser vos données.

Comment fonctionne l'importation de données ?

Importer des données

Vous importez des fichiers CSV contenant des données externes dans une propriété Analytics. Vous pouvez exporter ces fichiers depuis un outil de gestion hors connexion, comme votre système CRM ou CMS. Pour des données moins volumineuses, vous pouvez aussi créer les fichiers manuellement dans un éditeur de texte ou une feuille de calcul.

La fonctionnalité d'importation de données associe les données hors ligne que vous importez aux données d'événement collectées par Analytics. Les données importées améliorent vos rapports, vos comparaisons et vos audiences. Vous obtenez ainsi un aperçu plus complet des activités en ligne et hors connexion.

Associer des données

Les données sont associées de deux façons différentes selon le type de données importées :

  • Au moment de la collecte/du traitement : vos données importées sont associées aux données Analytics lorsque celles-ci sont collectées et traitées, comme si elles avaient été recueillies avec l'événement. Les données associées sont reproduites dans les tableaux cumulés Analytics. Les données importées ne sont pas associées aux données historiques (déjà traitées) d'Analytics. Si vous supprimez le fichier de données importé, aucune autre association n'est effectuée, mais celles qui ont déjà eu lieu continuent d'être utilisées.

    Les données utilisateur et les données d'événement hors connexion sont associées au moment de la collecte/du traitement.
  • Au moment de la requête/du reporting : vos données importées sont associées aux données Analytics lorsque vous ouvrez un rapport et lorsqu'Analytics émet une requête pour les données de rapport. Ce type d'association est temporaire : si vous supprimez le fichier de données importé, aucune autre association n'est effectuée et les données associées ne seront plus accessibles dans Analytics.

    Les données sur les coûts, les articles et les événements personnalisés sont associées au moment du rapport/de la requête.

    Les données sur le moment du rapport/de la requête ne sont pas disponibles lorsque vous créez des audiences dans Analytics ou des segments dans Explorations.

Lorsque vous importez des données, les données précédemment importées sont conservées, tandis que les nouvelles données sont ajoutées. Notez que si les données importées ont le même ensemble de clés que les données importées précédemment, les données seront écrasées.

Types de métadonnées pouvant être importées

Métadonnées

Les métadonnées importées s'ajoutent aux données déjà collectées et traitées par une propriété. En règle générale, les métadonnées sont stockées dans une dimension ou une métrique personnalisées. Toutefois, dans certains cas, vous pouvez choisir de remplacer les informations par défaut déjà collectées (par exemple, en important un catalogue de produits avec des catégories modifiées).

Vous pouvez importer les types de données suivants :

  • Données de coût : données concernant les clics, impressions et coûts générés sur des réseaux publicitaires tiers (n'appartenant pas à Google)
  • Données sur les articles : métadonnées sur les produits, comme la taille, la couleur, le style ou d'autres dimensions associées
  • Données utilisateur : métadonnées sur les utilisateurs, par exemple leur taux de fidélité ou leur valeur vie client, permettant de créer des segments et des listes de remarketing
  • Événements hors connexion : événements hors connexion provenant de sources qui ne sont pas connectées à Internet ou qui ne sont pas compatibles avec la collecte d'événements en temps réel.
  • Données d'événements personnalisés : métadonnées d'événement à l'aide de champs standards ou de dimensions personnalisées

Limites

Taille de la source de données 1 Go
Importations quotidiennes

120 importations par propriété et par jour

 

Type de données à importer Limite de sources de données par propriété Limite de stockage par type de données
Données de coût Jusqu'à 5 1 Go pour toutes les sources d'importation
Données sur les articles Jusqu'à 5 1 Go pour toutes les sources d'importation
Données utilisateur Jusqu'à 10 Non applicable
Événements hors connexion Jusqu'à 10 Non applicable
Données d'événements personnalisés Jusqu'à 5 1 Go pour toutes les sources d'importation

Vous pouvez consulter l'utilisation actuelle des quotas dans le produit à l'aide du bouton "Informations sur les quotas".

Importer des données

Lorsque vous importez des données, vous créez une source de données. Une source de données est la combinaison du fichier CSV que vous souhaitez importer et d'un mappage des champs Analytics existants avec les champs de votre fichier CSV. Exemple :

N'importez pas de fichier qui comporte des clés en double (par exemple, deux champs nommés "user_id").

Consultez cet article pour en savoir plus sur les sources de données.

Conditions préalables à l'utilisation de SFTP pour importer des données

Si vous envisagez d'utiliser l'option SFTP à l'étape 5, assurez-vous que votre serveur SFTP accepte les algorithmes de clé hôte ssh-rsa et ssh-dss. En savoir plus sur la vérification des algorithmes de clé hôte que vous utilisez et sur le formatage de l'URL du serveur SFTP

Lancer le processus d'importation

  1. Dans  Admin, sous Collecte et modification des données, cliquez sur Importation de données.
    Le lien précédent ouvre la dernière propriété Analytics à laquelle vous avez accédé. Vous pouvez modifier la propriété à l'aide du sélecteur de propriété. Vous devez être éditeur (ou avoir un rôle supérieur) au niveau de la propriété pour lancer le processus d'importation avec succès.
  2. Sélectionnez une source de données existante ou créez-en une (consultez les sections suivantes).

Créer une source de données

  1. Cliquez sur Créer la source de données.
  2. Saisissez le nom de votre source de données.
  3. Sélectionnez le type de données :
    • Données de coût (importation au moment de la requête uniquement)
    • Données sur les articles (importation au moment de la requête/du reporting)
    • Données sur l'utilisateur par ID utilisateur (importation au moment de la collecte/du traitement)
    • Données sur l'utilisateur par ID client (importation au moment de la collecte/du traitement)
    • Données sur les événements hors connexion (importation au moment de la collecte/du traitement)
    • Données d'événements personnalisés (importation au moment de la requête/du reporting)
  4. Cliquez sur Lire les conditions d'utilisation si vous y êtes invité. Cette invite s'affiche si vous importez des données utilisateur ou d'appareil.
  5. Utilisez l'une des méthodes suivantes :
    • Sélectionnez Importation manuelle de fichiers CSV, sélectionnez le fichier CSV sur votre ordinateur, puis cliquez sur Ouvrir.
    ou
    • Sélectionnez SFTP.
    • Nom d'utilisateur du serveur SFTP : saisissez le nom d'utilisateur de votre serveur SFTP.
    • URL du serveur SFTP : saisissez l'URL de votre serveur SFTP.
    • Fréquence : sélectionnez la fréquence d'importation (quotidienne, hebdomadaire ou mensuelle).
    • Heure de début : sélectionnez l'heure à laquelle vous souhaitez lancer l'importation.
    • La clé publique de votre serveur SFTP sera visible dans l'interface où vous créez la source de données. Elle sera disponible dans les détails de la source de données une fois celle-ci créée (voir ci-dessous).
  6. Cliquez sur Suivant pour passer à l'étape de mappage.
  7. Sélectionnez les champs Analytics et les champs importés que vous souhaitez mapper. Modifiez les noms des champs si nécessaire.
  8. Cliquez sur Importer.

Importer des données dans une source de données existante

  1. Sur la ligne d'une source de données existante, cliquez sur Importer maintenant.
  2. Si la source de données est configurée pour importer des fichiers CSV, sélectionnez le fichier CSV à importer, puis cliquez sur Ouvrir.

Le fichier CSV doit inclure les mêmes champs ou sous-ensembles de champs que l'original. Si vous souhaitez importer différents champs pour le même type de données, vous devez supprimer la source de données existante et en créer une autre.

L'importation de données effectuée dans la propriété source sera automatiquement exportée vers la propriété de consolidation et les sous-propriétés.

Vérifier les algorithmes de clé hôte SFTP ; formater l'URL du serveur SFTP

Vérifier les algorithmes

Il existe différentes méthodes pour vérifier si votre serveur SFTP utilise l'algorithme de clé hôte ssh-rsa ou ssh-dss. Par exemple, vous pouvez utiliser le client de connexion à distance OpenSSH pour vérifier les journaux de votre serveur à l'aide de la commande suivante :

ssh -vv <nom de votre serveur SFTP>

Si votre serveur est compatible avec l'un de ces algorithmes, une ligne semblable à la suivante doit s'afficher dans le journal du serveur :

debug2: host key algorithms: rsa-sha2-512, rsa-sha2-256, ssh-rsa

Formater l'URL du serveur SFTP

Si le format de l'URL du serveur SFTP est incorrect, votre configuration de l'importation échouera et un message d'erreur interne s'affichera.

Une URL de serveur SFTP se compose généralement de trois parties dont vous devez tenir compte pour importer des fichiers d'importation de données. Exemple :

sftp://example.com//home/jon/upload.csv se compose des éléments suivants :

  • Le domaine : example.com
  • Le répertoire d'accueil : //home/jon
  • Le chemin d'accès du fichier : /upload.csv

Dans l'exemple ci-dessus, le fichier d'importation se trouve dans le répertoire d'accueil.

Vous pouvez mettre en forme la partie domaine de l'URL de différentes manières, en utilisant le nom de domaine, ou l'adresse IPv4 ou IPv6 du serveur, avec ou sans numéro de port :

  • Nom de domaine : sftp://example.com
  • IPv4 (avec numéro de port) : sftp://142.250.189.4:1234
  • IPv4 (sans numéro de port) : sftp://142.250.189.4
  • IPv6 (avec numéro de port) : sftp://[2607:f8b0:4007:817::2004]:1234
  • IPv6 (sans numéro de port) : sftp://[2607:f8b0:4007:817::2004]

Si vous n'incluez pas le numéro de port, le port par défaut est 22.

Vous pouvez mettre correctement en forme l'URL pour inclure ou exclure le répertoire d'accueil. Les exemples suivants d'URL mises en forme correctement utilisent différents formats pour identifier le domaine. Les exemples incluent les numéros de port, mais vous pouvez choisir de ne pas les utiliser.

  • Inclure le répertoire d'accueil :
    • sftp://example.com//home/jon/upload.csv (nom de domaine)
    • sftp://142.250.189.4:1234//home/jon/upload.csv (IPv4 avec numéro de port)
  • Exclure le répertoire d'accueil :
    • sftp://example.com/upload.csv (nom de domaine)
    • sftp://[2607:f8b0:4007:817::2004]:1234/upload.csv (IPv6 avec numéro de port)

Si votre fichier d'importation se trouve dans un sous-répertoire de votre répertoire d'accueil, votre URL ressemblera à ceci :

sftp://example.com//home/jon/data/upload.csv

Dans ce cas, vous pouvez utiliser les types de formats suivants :

  • Inclure le répertoire d'accueil :
    • sftp://example.com//home/jon/data/upload.csv
    • sftp://142.250.189.4:1234//home/jon/data/upload.csv (IPv4 avec numéro de port)
  • Exclure le répertoire d'accueil :
    • sftp://example.com/data/upload.csv
    • sftp://[2607:f8b0:4007:817::2004]:1234/data/upload.csv (IPv6 avec numéro de port)

Si le fichier d'importation n'est pas stocké dans votre répertoire d'accueil (//home/jon) ou dans un sous-répertoire de votre répertoire d'accueil (//home/jon), mais qu'il est stocké à la place dans le répertoire /foo/bar, l'URL correctement mise en forme de votre fichier d'importation ressemblera alors à ceci :

sftp://example.com//foo/bar/upload.csv (sftp://example.com//foo/bar/upload.csv remplace le répertoire d'accueil)

Afficher les détails de la source de données, obtenir votre clé publique SFTP, importer de nouvelles données, supprimer une source de données

  1. Dans  Admin, sous Collecte et modification des données, cliquez sur Importation de données.
    Le lien précédent ouvre la dernière propriété Analytics à laquelle vous avez accédé. Vous pouvez modifier la propriété à l'aide du sélecteur de propriété.

    Vous devez être lecteur (ou avoir un rôle supérieur)au niveau de la propriété pour afficher les détails de la source de données.

  2. Sur la ligne correspondant à la source de données, cliquez sur puis.

Vous pouvez afficher le nom, le type de données, la clé publique et l'historique de chaque importation.

  • Clé publique : clé publique de serveur SFTP correspondant à une clé privée qu'Analytics stocke (et ne partage jamais). Elle permet de garantir une connexion privée sécurisée entre votre serveur et les serveurs d'importation de données Analytics. Vous devez impérativement autoriser cette clé publique sur votre serveur pour importer les données en toute sécurité.
  • % importé : nombre de lignes importées, divisé par le nombre de lignes dans le fichier d'importation. Une valeur de 100 % signifie que toutes les lignes ont bien été importées.
  • Taux de correspondance : ratio entre les clés du fichier d'importation qui sont disponibles dans votre propriété au cours des 90 derniers jours. Une valeur de 100 % signifie que les données sont pleinement utiles et pertinentes pour votre propriété au cours des 90 derniers jours.

Pour importer de nouvelles données :

Cliquez sur Importer maintenant et sélectionnez le fichier CSV approprié sur votre ordinateur.

Pour supprimer la source de données :

  1. Cliquez sur Plus > Supprimer la source de données.
  2. Lisez l'avis de suppression, puis cliquez sur Supprimer la source de données.

Vous pouvez supprimer les données importées au moment de la collecte/du traitement. Toutefois, si vous souhaitez supprimer les données précédemment importées à partir de tous les événements traités par Analytics, vous devrez peut-être supprimer aussi un utilisateur ou une propriété utilisateur. Supprimer un fichier déjà importé n'entraîne pas la suppression des données traitées qui ont été associées aux événements collectés depuis la fin de l'importation. Consultez cet article pour en savoir plus sur les demandes de suppression de données.

Noms et préfixes réservés

Les noms d'événements, noms de paramètres d'événement, noms de propriétés utilisateur et préfixes suivants sont réservés à Analytics. Vous ne pourrez pas importer de données incluant l'un de ces noms ou préfixes réservés.

Exemple :

  • Si vous essayez d'importer un événement avec un nom réservé, cet événement et ses paramètres ne seront pas importés.
  • Si vous tentez d'importer un événement avec un nom valide, mais que l'un des paramètres utilise un nom réservé, l'événement sera importé, mais pas le paramètre associé au nom réservé.

Noms d'événements réservés

  • ad_activeview
  • ad_activeview
  • ad_exposure
  • ad_impression
  • ad_query
  • adunit_exposure
  • app_clear_data
  • app_install
  • app_remove
  • app_update
  • error
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • os_update
  • screen_view
  • session_start
  • user_engagement

Noms de paramètres d'événement réservés

  • firebase_conversion

Noms de propriétés utilisateur réservés

  • first_open_after_install
  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id

Préfixes réservés (s'applique aux paramètres d'événement et aux propriétés utilisateur)

  • ga_
  • google_
  • firebase_

Ces informations vous-ont elles été utiles ?

Comment pouvons-nous l'améliorer ?
Recherche
Effacer la recherche
Fermer le champ de recherche
Applications Google
Menu principal