Mesure des événements

Ce guide explique comment mesurer des événements à l'aide d'analytics.js.

Présentation

Les événements correspondent aux interactions des utilisateurs avec votre contenu. Ils sont mesurables indépendamment du chargement d'une page Web ou d'un écran. Les téléchargements, clics sur les annonces pour mobile, gadgets, éléments Flash, éléments AJAX intégrés et lectures de vidéo sont autant d'exemples d'actions que vous pouvez comptabiliser en tant qu'événements.

Si vous ne connaissez pas bien les événements dans Google Analytics, commencez par lire l'article À propos des événements dans le Centre d'aide Analytics.

Implémentation

Les appels avec événement peuvent être envoyés à l'aide de la commande send et en spécifiant un hitType de event. La commande send a la signature suivante pour le type d'appel event:

ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

Champs d'événement

Le tableau suivant récapitule les champs d'événement:

Nom du champ	Type de valeur	Obligatoire	Description
eventCategory	text	oui	Il s'agit généralement de l'objet avec lequel vous avez interagi (par exemple, 'Video').
eventAction	text	oui	Type d'interaction (par exemple, 'play')
eventLabel	text	no	Utile pour classer des événements (ex. : 'Fall Campaign')
eventValue	integer	no	Valeur numérique associée à l'événement (par exemple, 42)

Pour une description plus détaillée de chacun de ces champs, consultez l'article Anatomie d'un événement dans le centre d'aide Analytics.

Exemples :

La commande suivante envoie un événement à Google Analytics indiquant que la vidéo promotionnelle de la campagne d'automne a été lue:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

Notez que, comme pour toutes les commandes send, les champs transmis dans les paramètres de commodité peuvent également être spécifiés dans fieldsObject. La commande ci-dessus peut être réécrite comme suit:

ga('send', {
  hitType: 'event',
  eventCategory: 'Videos',
  eventAction: 'play',
  eventLabel: 'Fall Campaign'
});

Pour plus d'informations, d'exemples et de bonnes pratiques concernant l'envoi d'appels, consultez le guide Envoyer des données à Google Analytics. Pour plus d'informations sur la signature d'appel de la commande send, consultez la documentation de référence sur la file d'attente de commandes.

Mesurer les liens sortants et les formulaires

Lorsqu'un utilisateur clique sur un lien qui renvoie vers une autre page de votre site, cette page envoie généralement un appel de page vue lorsque l'utilisateur arrive. Étant donné qu'il y a une série de pages vues, Google Analytics peut déterminer le backend vers lequel l'utilisateur a accédé (et depuis lequel). Toutefois, si un utilisateur clique sur un lien ou envoie un formulaire à un domaine externe, cette action n'est pas enregistrée, sauf si vous lui signalez spécifiquement ce qui s'est passé.

Vous pouvez mesurer les événements de formulaire et de liens sortants en envoyant des événements et en spécifiant l'URL de destination dans l'un des champs d'événement. La fonction de gestionnaire d'événements suivante peut être utilisée pour envoyer des événements de clic sur un lien sortant à Google Analytics:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href
  });
}

Il peut être difficile de mesurer les liens sortants et les formulaires, car la plupart des navigateurs cessent d'exécuter JavaScript sur la page active lorsqu'une nouvelle page commence à se charger. Une solution à ce problème consiste à définir le champ transport sur beacon:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href,
    transport: 'beacon'
  });
}

Pour les navigateurs qui n'acceptent pas la méthode de transport par balise, vous devez attendre la fin de l'envoi de l'événement avant de passer à la page suivante. La section Savoir quand un appel a été envoyé du guide Envoyer des données à Google Analytics explique en détail la procédure à suivre.

Remarque:Les développeurs qui souhaitent mesurer les liens et formulaires sortants peuvent utiliser autotrack, qui inclut les plug-ins outboundLinkTracker et outboundFormTracker, qui gèrent ces complexités à votre place. Consultez la documentation sur le suivi automatique pour obtenir des instructions d'utilisation et d'installation.

Événements indépendants de toute interaction

Dans certains cas, vous pouvez envoyer un événement en tant qu'événement indépendant de toute interaction. Pour ce faire, spécifiez le champ nonInteraction comme true dans le fieldsObject de la commande send:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign', {
  nonInteraction: true
});

Pour en savoir plus sur les appels indépendants de toute interaction et savoir quand les utiliser, consultez l'article sur les événements indépendants de toute interaction dans le centre d'aide Analytics.