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

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 associe les données hors connexion importées 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 de l'historique Analytics (données déjà traitées). 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 et les articles sont associées au moment de la requête/du reporting.
  
  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.

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ée. 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 mises à jour).

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 telles que 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.

Limites

Espace de stockage total	10 Go (propriétés standards) 1 To (propriétés 360)
Taille de la source de données	1 Go
Importations quotidiennes	120 importations par propriété et par jour

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 (ex., deux champs nommés "user_id").

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 Google Analytics, cliquez sur Administration.
2. Vérifiez que le bon compte et la bonne propriété sont sélectionnés.

3. Dans la colonne Propriété, cliquez sur Importation de données.
4. 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)
4. Cliquez sur Lire les conditions 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 est 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.

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 :

• 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 au bon format utilisent différents formats pour identifier le domaine. Les exemples incluent des 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/data), 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 (//foo/bar remplace le répertoire d'accueil)

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

1. Dans Google Analytics, cliquez sur Administration.
2. Vérifiez que le bon compte et la bonne propriété sont sélectionnés.

3. Dans la colonne Propriété, cliquez sur Importation de données.
4. Sur la ligne correspondant à la source de données, cliquez sur .

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 > 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 (en savoir plus). 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.

 

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_