IntegracionesEnviando eventos

Cómo enviar los eventos

Después de conectar Finteza JavaScript Client, podrá enviar eventos sobre las acciones de los usuarios en el sitio en Finteza. Para ello, añada a la página del sitio web un código Java del siguiente tipo:

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

En lugar de {EVENT_NAME}, indique el nombre del evento, por ejemplo "Registration".

Compruebe el funcionamiento del código ejecutándolo a través de la consola del navegador. En caso de éxito, verá la entrada correspondiente en el informe "Eventos" de su sitio web en el panel de Finteza.

Evento registrado con éxito en el panel de Finteza

Datos adicionales sobre los parámetros de los eventos #

En los eventos enviados a Finteza, podemos indicar información adicional en forma de parámetros. Por ejemplo, el tipo de mercancía adquirida, el importe de la compra, la divisa, etc.

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

Como {EVENT_NAME}, indique el nombre del evento. A continuación, se indican los parámetros:

Parámetro

Tipo

Descripción

unit

string

Unidades de medición del parámetro. Por ejemplo, USD, unidades, etc. La longitud máxima es de 32 símbolos.

value

number

Valor del parámetro. La longitud máxima es de 64 símbolos.

Ejemplo:

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

Opciones de envío de eventos desde la página #

Dependiendo del evento que usted monitorea, el código de seguimiento se debe pegar en determinados tags de la página.

Envío de evento al rellenar un formulario:

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

Envío de evento al pulsar un botón:

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

Envío de evento al clicar un enlace:

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

Envío de evento al descargar una página:

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

Procesamiento automático de clics en enlaces #

Añada atributos data-fz-event a los enlaces a su sitio web e indique en ellos los nombres de los eventos que deben enviarse a Finteza al darse la pulsación. Finteza JavaScript Client encontrará y procesará automáticamente los pasos por todos los enlaces semejantes en la página.

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

Esta variante se puede usar en lugar de añadir a los enlaces atributos onclick con una descripción completa de la llamada fz().  resulta más cómodo y sencillo.

Para las páginas instantáneas de Google AMP, donde se usa un servicio propio de código de seguimiento, existe un requisito adicional para el nombre de los atributos: estos deberán comenzar por el prefijo "data-vars". Por eso, para procesar automáticamente los clics sobre los enlaces en estas páginas, deberá añadir en ellas los atributos data-vars-fz:

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

Para no confundirse con los nombres, usted podrá usar en cualquier sitio los atributos data-vars-fz. Estos reciben soporte no solo en las páginas de Google AMP, sino también en las habituales, donde se instala un código de seguimiento normal.


Llamada de retorno #

Si necesita procesar el evento de envío, indique en el código de evento la función de llamada de retorno. Cambie el segundo argumento de la llamada de la forma siguiente:

fz( "event", {
  name:  "Your Event Name",
  unit:  "USD",
  value: 100,
  callback: function() {
...
    // event sending completed
  }
} );

Supondrá un objeto en el que se indican el nombre del evento y el enlace a la función-manejador.