Événements et objectifs

Événements automatiques#

Sans rien ajouter, le traceur envoie déjà :

Pour Formulaire envoyé, la propriété formulaire vaut l’attribut id du formulaire, sinon son name, sinon le chemin de son action (jamais sa requête), sinon « sans nom ». Les champs saisis ne sont jamais lus.

Sans JavaScript : un attribut#

Ajoutez data-kreomnis-event="Nom" sur un lien, un bouton ou n’importe quel élément cliquable : chaque clic envoie l’événement. Sur un <form>, l’événement part à l’envoi du formulaire. Chaque attribut data-kreomnis-prop-cle="valeur" devient une propriété.

<!-- Sans JavaScript : un attribut suffit (clic, ou envoi pour un formulaire) -->
<button data-kreomnis-event="Demande de devis" data-kreomnis-prop-offre="pro">Demander un devis</button>
<form data-kreomnis-event="Contact">…</form>

<!-- En JavaScript (la file d'attente permet d'appeler avant le chargement du traceur) -->
<script>window.kreomnis = window.kreomnis || function () { (window.kreomnis.q = window.kreomnis.q || []).push(arguments) };</script>
<script>kreomnis('Inscription', { props: { offre: 'pro' } });</script>

En JavaScript#

La fonction kreomnis(nom, options) envoie un événement depuis votre code :

kreomnis('Inscription', { props: { offre: 'pro', origine: 'page tarifs' } });

// Attendre l'envoi avant de quitter la page :
kreomnis('Demande de devis', { callback: () => { window.location.href = '/merci'; } });

• props : propriétés de l’événement (voir les règles ci-dessous).
• callback : fonction appelée juste après l’envoi, y compris quand la mesure est désactivée (Do Not Track, localhost) : votre site n’est jamais bloqué.
• items et revenue : réservés à l’e-commerce.

Si votre code peut s’exécuter avant le chargement de k.js (balise defer), déclarez d’abord la file d’attente montrée plus haut : les appels faits avant le chargement sont envoyés dès que le traceur est prêt.

Noms et propriétés#

• Nom : 1 à 64 caractères, lettres (accents compris), chiffres, espaces et _ . : ' ’ -. Un événement dont le nom contient d’autres caractères est ignoré.
• Propriétés : 25 au plus, clés de 64 caractères au plus, valeurs texte (300 caractères au plus), nombres, booléens ou null. Les objets et tableaux imbriqués sont ignorés.
• Noms réservés : pageview et engagement sont utilisés par le traceur ; les noms e-commerce (view_item, add_to_cart, purchase…) alimentent les rapports e-commerce.

Dans Statistiques, cliquez sur un événement pour filtrer tout le tableau de bord sur les visites qui l’ont déclenché : la ventilation de ses propriétés s’affiche (par exemple offre = pro).

Objectifs#

Un objectif transforme un événement ou une page en conversion suivie. Créez-le dans Objectifs et entonnoirs(propriétaires et administrateurs) :

• Événement : son nom exact, par exemple Inscription ou purchase.
• Page visitée : un chemin qui commence par /, comme /merci. Terminez par * pour tout ce qui commence par ce chemin : /blog/*.

Pour chaque objectif, la console affiche les visiteurs qui l’ont atteint, le nombre de conversions, le taux de conversion (visiteurs convertis / visiteurs de la période) et le chiffre d’affaires associé. Un objectif s’applique aussi aux données passées : inutile d’attendre pour voir ses chiffres.

Entonnoirs#

Un entonnoir suit un parcours de 2 à 8 étapes. Il compte les visites qui franchissent les étapes dans l’ordre, au cours d’une même visite, et montre où elles décrochent. Une étape par ligne :

/produits/*
événement add_to_cart
événement begin_checkout
événement purchase

• une ligne qui commence par / est une page (avec * final pour un préfixe) ;
• événement Nom (ou event Nom, e: Nom) désigne un événement.

Pour chaque étape : le nombre de visites, le taux depuis la première étape et la part perdue depuis l’étape précédente.