IntégrationsEnvoyer des évènements

Comment envoyer des évènements

Après avoir inséré le Client JavaScript Finteza, vous pouvez envoyer les événements des actions utilisateurs du site Web à Finteza. Pour ce faire, ajoutez le code JavaScript suivant dans la page du site Web :

fz( "event""{EVENT_NAME}" );

{EVENT_NAME} correspond au nom d'un événement, par exemple "Inscription".

Vérifiez l'opération du code en l'exécutant via la console du navigateur. En cas de succès, vous verrez l'entrée correspondante dans le rapport du site Web Evénements du panneau Finteza.

Evénement enregistré avec succès dans le panneau Finteza

Données supplémentaires dans les paramètres d'événement #

Dans les événements envoyés à Finteza, vous pouvez spécifier des données supplémentaires en tant que paramètres, par exemple le type d'un bien acheté, le prix, la devise, etc.

fz( "event", {
  name:  "{EVENT_NAME}",
  unit:  "{UNIT}",
  value: {VALUE}
});

Mettez le nom de l'événement dans {EVENT_NAME}. Les paramètres suivants sont spécifiés ensuite :

Paramètre

Type

Description

unit

chaîne de caractères

Unités de mesure des paramètres, par exemple, USD, articles, etc. La longueur maximale est de 32 symboles.

valeur

nombre

Valeur du paramètre. La longueur maximale est de 64 symboles.

Exemple :

fz( "event", {
  name:  "Purchase",
  unit:  "USD",
  value: 100
});

Options d'envoi des événements depuis la page web #

Le code de suivi doit être inséré dans certaines balises de page Web en fonction d'un événement suivi.

Envoi d'un événement en remplissant le formulaire :

<form action="" method="get" onsubmit="fz('event', 'Form+Order+Submit'); return true;">
    ...
</form>

Envoi d'un événement en cliquant sur un bouton :

<form action="">
    ...
    <input type="button" onclick="fz('event', 'Form+Order+Submit'); return true;" value="Order" />
</form>

Envoi d'un événement en cliquant sur un lien :

<a href="https://www.example.com/" onclick="fz('event', 'Click+Link'); return true;">www.example.com</a>

Envoi d'un événement lors du chargement d'une page Web :

<body>
...
<script type="text/javascript">
  fz("event","Page+Order+Load");
</script>
...
</body>

Traitement automatique des clics par liens #

Ajoutez les attributs data-fz-event aux liens de votre site Web et spécifiez-y le nom des événements à envoyer à Finteza lorsque vous cliquez dessus. Le client JavaScript Finteza trouve et gère automatiquement les clics sur tous les liens de la page Web.

<a data-fz-event="Click+Link" href="https://www.example.com/">www.example.com</a>

Cette option peut être utilisée au lieu d'ajouter les attributs onclick avec la description complète de l'appel fz(). C'est plus simple et plus pratique.

Pour les Articles Instantanés Google AMP, pour lesquels une version individuelle du code de suivi est utilisée, un besoin supplémentaire de nommmage des attributs s'applique : ils doivent commencer avec le préfixe "data-vars". Vous devez donc leur ajouter les attributs data-vars-fz pour permettre le traitement automatique des clics sur ces liens :

<a data-vars-fz="Click+Link" href="https://www.example.com/">www.example.com</a>

Pour éviter un confusion de noms, vous pouvez utiliser les attributs data-vars-fz partout. Ils sont pris en charge non seulement sur les pages Google AMP, mais également sur les pages classiques avec le code de suivi standard.


Callback #

Si vous devez gérer un événement d'envoi, définissez la fonction de rappel dans le code de l'événement. Changer le second argument de la manière suivante :

fz( "event", {
  name:  "Your Event Name",
  unit:  "USD",
  value: 100,
  callback: function() {
...
   // envoi de l'événement terminé
  }
} );

Ce sera un objet contenant un nom d'événement et un lien vers la fonction de gestionnaire.