Google Chrome abandonne les cookies tiers. Pour en savoir plus, consultez la page goo.gle/3pcd.

Cette page a été traduite par l'API Cloud Translation.

Événements

Cet article explique comment migrer des événements Universal Analytics (UA) vers des événements Google Analytics 4 (GA4).

Étant donné que les modèles de mesure pour UA et GA4 sont différents, nous vous recommandons de repenser votre collecte de données en fonction du modèle GA4 plutôt que de transférer votre structure d'événements UA existante vers GA4.

Pour en savoir plus sur les événements GA4, consultez À propos des événements.

Comparaison des événements UA et GA4

Universal Analytics

Pour Universal Analytics (UA), les mesures s'effectuent en envoyant des appels. La plupart des types d'appels sont utilisés pour mesurer des interactions spécifiques (par exemple, pageview), mais le type d'appel event est disponible pour les mesures personnalisées/générales. Les données envoyées avec un appel event incluent la catégorie, l'action et le libellé.

Vous trouverez ci-dessous des exemples d'événements Universal Analytics pour les bibliothèques analytics.js et gtag.js:

analytics.js (UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google Analytics 4

Pour Google Analytics 4 (GA4), la mesure s'effectue en envoyant des événements. Des événements sont collectés automatiquement, des événements prédéfinis et recommandés qu'il est conseillé d'envoyer le cas échéant, et des événements personnalisés que vous pouvez envoyer dans les cas où les événements automatiques ou recommandés ne correspondent pas à votre cas d'utilisation.

Voici un exemple d'événement personnalisé dans GA4:

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

Mapper un événement UA avec GA4

Pour migrer un événement UA vers GA4, vous devez déterminer s'il existe un événement GA4 équivalent. Pour mapper un événement UA à GA4, procédez comme suit:

Consultez la liste des événements collectés automatiquement. Si un événement collecté automatiquement dans GA4 correspond à l'événement UA, supprimez-le et utilisez-le.
Si vous n'avez trouvé aucune correspondance à l'étape précédente, examinez les événements collectés via les mesures améliorées. Si un événement de mesures améliorées GA4 correspond étroitement à l'objectif de l'événement UA, ne migrez pas l'événement UA et utilisez plutôt les mesures améliorées pour l'envoyer. Assurez-vous que les mesures améliorées sont correctement configurées pour que votre propriété GA4 collecte l'événement.
Si vous n'avez trouvé aucune correspondance à l'étape précédente, consultez la liste des événements recommandés. Si un événement recommandé de GA4 correspond étroitement à l'objectif de l'événement UA, utilisez-le et définissez tous les paramètres d'événement applicables lors de l'envoi de l'événement.
Si vous n'avez trouvé aucune correspondance à l'étape précédente, envoyez un événement personnalisé.

Scénarios et exemples de migration

Événements collectés automatiquement

Les événements collectés automatiquement sont toujours envoyés et ne peuvent généralement pas être désactivés, sauf s'ils peuvent être configurés via les mesures améliorées. En général, vous ne devez pas migrer les événements UA pour lesquels il existe un événement collecté automatiquement suffisamment équivalent.

Par exemple, un événement UA envoyé pour mesurer une interaction de téléchargement de fichier n'aura probablement pas besoin d'être migré vers GA4, car l'événement file_download dans GA4 est automatiquement collecté.

Mesures améliorées

En général, vous n'avez pas besoin de migrer les événements UA vers GA4 lorsqu'un événement GA4 suffisamment équivalent est collecté via les mesures améliorées. Par exemple, les événements UA suivants n'auront probablement pas besoin d'être migrés vers GA4, car ils sont déjà mesurés dans GA4 via les mesures améliorées:

Un événement UA pour mesurer les clics sortants équivaudrait à un événement click dans GA4.
Un événement UA pour mesurer les téléchargements de fichiers équivaudrait à un événement file_download dans GA4.

Remplacement par les mesures améliorées

Si l'objectif d'un événement de mesures améliorées est équivalent à celui de votre événement UA, mais qu'il ne capture pas toutes les données dont vous avez besoin, vous pouvez envoyer manuellement l'événement avec des paramètres personnalisés supplémentaires. Pour cela, vous devez configurer/désactiver les mesures améliorées pour l'événement correspondant et envoyer manuellement l'événement GA4.

Par exemple, l'événement file_download collecté via les mesures améliorées correspond étroitement à votre événement UA, mais il manque des informations sur la taille du fichier. Pour ignorer l'événement de mesures améliorées et inclure les informations sur la taille du fichier, procédez comme suit:

Désactivez les téléchargements de fichiers dans les mesures améliorées.
Le cas échéant, envoyez manuellement l'événement file_download avec des paramètres personnalisés.
- Étant donné que l'événement collecté automatiquement est désactivé via la mesure améliorée, vous devez définir manuellement les paramètres qui seraient normalement collectés avec l'événement (par exemple, file_extension, file_name, etc.).
Créez une dimension/métrique personnalisée pour afficher les valeurs de paramètres personnalisés dans les rapports.

L'exemple gtag.js suivant envoie un événement file_download GA4 avec un paramètre personnalisé file_size.

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

Événement recommandé

Si votre événement UA comporte un événement recommandé GA4 suffisamment équivalent , migrez-le vers l'événement recommandé.

L'exemple suivant est un événement UA analytics.js permettant de mesurer une connexion:

ga('send', 'event', 'login', 'google-sso');

Vous pouvez utiliser l'événement login de GA4 pour migrer l'événement UA vers GA4. L'équivalent gtag.js GA4 est le suivant:

gtag('event', 'login', {
  method: 'google-sso'
});

Événement personnalisé

Si votre événement UA n'est associé à aucun événement collecté automatiquement, mesure améliorée ou événement recommandé, migrez-le vers un événement personnalisé, et créez des dimensions et métriques personnalisées selon vos besoins.

L'exemple suivant montre un événement UA analytics.js qui mesure les modifications apportées aux options d'orientation de l'interface utilisateur:

ga('send', 'event', 'orientation', 'layout', 'wide');

Il n'existe aucun événement GA4 prédéfini pour mesurer l'événement UA ci-dessus. Au lieu de cela, l'exemple gtag.js suivant montre comment un événement personnalisé permet de mesurer la même interaction dans GA4:

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

Pour inclure ui_element et configuration dans vos rapports, vous devez créer les dimensions correspondantes à partir de ces paramètres d'événement. Pour en savoir plus, consultez Dimensions et métriques personnalisées.