[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 l'horodatage 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. Référez-vous à l'exemple 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 définitivement 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 ; horodatage 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É REFUSÉ page_view /home referrer.com Page d'accueil 1600x900 blue 1-2                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488060000000 REFUSÉ REFUSÉ page_view /video_detail   Visionneuse de vidéos 1600x900 blue 1-4                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488120000000 REFUSÉ ACCORDÉ video_play /video_detail   Visionneuse de vidéos 1600x900 blue                                    
G-67890ABCDE 2345678901.9876543210 1000002 1609574400000000 REFUSÉ ACCORDÉ page_view /home referrer.com Page d'accueil 2560x1440 green 2-2                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574460000000 REFUSÉ ACCORDÉ page_view /product_detail   Informations détaillées sur le produit 2560x1440 green 2-16                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574520000000 ACCORDÉ ACCORDÉ page_view /product_detail   Informations détaillées sur le produit 2560x1440 green                                    
G-67890ABCDE 121212.3434 1000003 1609574520000000 ACCORDÉ ACCORDÉ page_view /camp_lp_1 referrer.com Promotions estivales 2560x1440 blue 3-1                                  
G-67890ABCDE 121212.3434 1000003 1609660801000000 ACCORDÉ REFUSÉ view_item_list /camp_lp_1   Promotions estivales 2560x1440 blue   123abc red_shoe shoe list_123 colorful_shoes 1 1   234bcd blue_shoe 1 30.00          
G-67890ABCDE 121212.3434 1000003 1609660860000000 ACCORDÉ ACCORDÉ select_item /camp_lp_1   Promotions estivales 2560x1440 blue   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660870000000 ACCORDÉ ACCORDÉ page_view /product_detail   Informations détaillées sur le produit 2560x1440 blue 3-5 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660930000000 REFUSÉ ACCORDÉ view_item /product_detail   Informations détaillées sur le produit 2560x1440 blue 3-17 234bcd blue_shoe shoe 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 blue   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660970000000 ACCORDÉ REFUSÉ begin_checkout /product_detail   Informations détaillées sur le produit 2560x1440 blue   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660975000000 ACCORDÉ REFUSÉ page_view /purchase_confirmation   Félicitations ! 2560x1440 blue 3-21 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660980000000 ACCORDÉ REFUSÉ purchase /purchase_confirmation   Félicitations ! 2560x1440 purple 3-21 234bcd blue_shoe shoe 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.

Ces informations vous-ont elles été utiles ?

Comment pouvons-nous l'améliorer ?
Recherche
Effacer la recherche
Fermer le champ de recherche
Menu principal
15514089815081426414
true
Rechercher dans le centre d'aide
true
true
true
true
true
69256
false
false