[GA4] Importer des événements hors connexion

À propos des données d'événement hors connexion

Vous pouvez importer les événements hors connexion à partir des sources qui ne disposent pas d'une connexion Internet, ou qui ne sont pas compatibles avec la collecte d'événements en temps réel via les SDK ou le protocole de mesure. Une fois importés, ces événements sont traités comme s'ils avaient été recueillis via nos SDK et utilisent le code temporel que vous avez fourni ou, à défaut, celui de l'importation.

Vous pouvez importer tous les événements correspondant à ceux qu'Analytics collecte automatiquement ou à ceux que nous recommandons en fonction de votre secteur, ou tout événement, paramètre ou propriété utilisateur personnalisés dont le format est correct. En savoir plus

Pour supprimer ces données, vous devez faire une demande de suppression de données ou supprimer un utilisateur.

Comment fonctionne l'importation des données d'événement hors connexion ?

Pour importer des événements hors connexion, vous créez un fichier CSV correspondant au schéma d'événement Analytics. Consultez les exemples de modèles ci-dessous.

Créer les dimensions personnalisées

Si vous importez des valeurs pour des dimensions qui n'existent pas encore dans Analytics et souhaitez afficher ces données dans des rapports, vous devez créer ces dimensions avant d'importer vos données. En savoir plus

Une fois les dimensions personnalisées créées, jusqu'à quatre heures peuvent être nécessaires pour qu'Analytics reconnaisse les données que vous importez. Vous pouvez vérifier si les dimensions personnalisées ont été traitées en ouvrant une exploration et en regardant si les dimensions sont disponibles dans l'outil de sélection des dimensions.

Créer un fichier CSV

Créez un fichier CSV contenant vos données d'événement à l'aide du modèle ci-dessous.

Importer des données

La procédure générale d'importation est décrite dans À propos de l'importation de données.

Lorsque vous créez la source de données, sélectionnez Données d'événement hors connexion.

Pour les événements hors connexion, les champs importés sont automatiquement mis en correspondance avec les champs Analytics.

Lorsque vous importez vos données, un délai maximal de 24 heures peut être nécessaire pour qu'Analytics les affiche dans les rapports, les audiences et les explorations.

Si vous supprimez une source de données du service d'importation des données, les données déjà importées ne sont pas supprimées. Si nécessaire, pour supprimer les données importées via la fonction Importation de données, vous devrez peut-être (comme pour toute autre méthode de collecte) faire une demande de suppression de données.

Détails concernant la source de données

Légende

Portée Événement
Champs obligatoires

[au choix] client_id ou app_instance_id

[au choix] tag_id ou firebase_app_id

(tag_id et client_id) ou (firebase_app_id et app_instance_id)

event_name

Données importées

Vous pouvez importer les données sur les événements, les paramètres, les articles ou les propriétés utilisateur à l'aide des formats d'en-tête suivants :

  • timestamp_micros (facultatif ; doit se situer dans les 72 heures suivant l'événement ; code temporel de l'importation s'il n'est pas fourni)
  • user_id (facultatif, mais recommandé lorsqu'il est disponible)
  • signaux de consentement (facultatifs, mais vivement recommandés lorsqu'ils sont disponibles. En savoir plus)
  • event_param.<xxxxx> (importer tout paramètre, quel qu'en soit le nom)
  • user_property.<yyyyy> (importer toute propriété utilisateur, quel qu'en soit le nom)
  • item<x>.<item_param> (par exemple, item2.item_name)
Remarques Vous ne devez pas importer ni associer d'informations permettant d'identifier personnellement l'utilisateur lors de l'importation d'événements hors connexion. En savoir plus

 

Modèle

Voici un exemple de modèle CSV pour les données d'événement. Si vous devez créer manuellement vos fichiers d'importation, utilisez cet exemple pour vous aider.

measurement_id client_id user_id timestamp_micros ad_personalization ad_user_data event_name event_param.page_location event_param.page_referrer event_param.page_title event_param.screen_resolution user_property.color_score event_param.foo item1.item_id item1.item_name item1.category item1.item_list_id item1.item_list_name item1.index item1.quantity item1.price item2.item_id item2.item_name item2.quantity item2.price event_param.transaction_id event_param.value event_param.tax event_param.shipping event_param.currency
G-12345ABCDE 1234567890.0987654321 1000001 1609488000000000 accordée refusé page_view /home referrer.com Page d'accueil 1600x900 bleu 1-2                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488060000000 refusé refusé page_view /video_detail   Visionneuse de vidéos 1600x900 bleu 1-4                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488120000000 refusé accordée video_play /video_detail   Visionneuse de vidéos 1600x900 bleu                                    
G-67890ABCDE 2345678901.9876543210 1000002 1609574400000000 refusé accordée page_view /home referrer.com Page d'accueil 2560x1440 vert 2-2                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574460000000 refusé accordée page_view /product_detail   Informations détaillées sur le produit 2560x1440 vert 2-16                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574520000000 accordée accordée page_view /product_detail   Informations détaillées sur le produit 2560x1440 vert                                    
G-67890ABCDE 121212.3434 1000003 1609574520000000 accordée accordée page_view /camp_lp_1 referrer.com Promotions estivales 2560x1440 bleu 3-1                                  
G-67890ABCDE 121212.3434 1000003 1609660801000000 accordée refusé view_item_list /camp_lp_1   Promotions estivales 2560x1440 bleu   123abc red_shoe chaussure list_123 colorful_shoes 1 1   234bcd blue_shoe 1 30.00          
G-67890ABCDE 121212.3434 1000003 1609660860000000 accordée accordée select_item /camp_lp_1   Promotions estivales 2560x1440 bleu   234bcd blue_shoe chaussure list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660870000000 accordée accordée page_view /product_detail   Informations détaillées sur le produit 2560x1440 bleu 3-5 234bcd blue_shoe chaussure list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660930000000 refusé accordée view_item /product_detail   Informations détaillées sur le produit 2560x1440 bleu 3-17 234bcd blue_shoe chaussure list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660950000000 refusé refusé add_to_cart /product_detail   Informations détaillées sur le produit 2560x1440 bleu   234bcd blue_shoe chaussure list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660970000000 accordée refusé begin_checkout /product_detail   Informations détaillées sur le produit 2560x1440 bleu   234bcd blue_shoe chaussure list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660975000000 accordée refusé page_view /purchase_confirmation   Félicitations ! 2560x1440 bleu 3-21 234bcd blue_shoe chaussure list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660980000000 accordée refusé achat /purchase_confirmation   Félicitations ! 2560x1440 violet 3-21 234bcd blue_shoe chaussure list_123 colorful_shoes 2 1 30.00         t12345 37.49 2.50 4.99 USD

 

 

Limites

Les événements, paramètres et propriétés utilisateur qui utilisent des noms réservés seront refusés.

Les paramètres d'événement liés aux articles (par exemple, item_list_name) sans valeur seront refusés. Les paramètres d'événement liés aux articles sont acceptés pour un sous-ensemble d'événements recommandé (par exemple, e-commerce, emploi, voyages).

Les noms d'événements et de paramètres doivent respecter les règles suivantes :

  • Les événements ne doivent pas inclure plus de 25 paramètres.
  • Les événements ne doivent pas inclure plus de 25 propriétés utilisateur.
  • Les noms de propriétés utilisateur ne doivent pas dépasser 24 caractères.
  • Les valeurs des propriétés utilisateur ne doivent pas dépasser 36 caractères.
  • Les noms d'événements ne doivent pas dépasser 40 caractères. Ils ne doivent contenir que des caractères alphanumériques et des traits de soulignement, et doivent commencer par un caractère alphabétique.
  • Les noms de paramètres (y compris les paramètres d'article) ne doivent pas dépasser 40 caractères. Ils ne doivent contenir que des caractères alphanumériques et des traits de soulignement, et doivent commencer par un caractère alphabétique.
  • Les valeurs de paramètres (y compris les valeurs des paramètres d'article) ne doivent pas dépasser 100 caractères.

Limites de l'importation des données d'événements hors connexion

Vous pouvez créer jusqu'à 10 sources de données pour les données d'événements hors connexion.

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