La función "connectif.managed.sendEvents" sirve para enviar a Connectif un listado de eventos, junto con el resto de información adicional que pudiera estar presente en la página. Gracias a ella es posible notificar mediante JavaScript todo tipo de eventos sin la necesidad de implementar las etiquetas.
Este artículo forma parte de la guía para crear una integración a medida.
Si tu integración es mediante módulo, esta función será insertada en tu eCommerce de forma automática.
Cómo se usa
La función "connectif.managed.sendEvents" envía automáticamente los siguientes datos:
- La información del carrito de la compra (datos de la Etiqueta de "Estado actual del carrito de la compra").
- La información del contacto actual (datos de la Etiqueta de "Información del contacto").
- La información de la suscripción a notificaciones Web Push (más info en Funciones Web Push).
- Los contenedores disponibles para el emplazamiento de banners (datos de la Etiqueta de "Banner").
Esta función puede recibir, de manera opcional, un array de objetos de tipo "evento". Si no se indica ningún evento, se enviarán a Connectif los datos del listado anterior sin ningún evento concreto. Esto puede resultar útil para volver a sincronizar el carrito de la compra o el email, sin necesidad de realizar una recarga de página completa.
Requisitos
Es importante que el uso de esta función se realice cuando Connectif esté inicializado.
const isConnectifInitialized = window.connectif?.managed?.isInitialized();
En el caso de no estarlo, será necesario esperar el evento "connectif.managed.initialized".
A continuación un ejemplo de como enviar eventos asegurándose que esté Connectif inicializado:
function trackPageVisit() {
window.connectif.managed.sendEvents([{ type: 'page-visit' }]);
}
if (window.connectif &&
window.connectif.managed &&
window.connectif.managed.isInitialized()) {
trackPageVisit();
} else {
document.addEventListener("connectif.managed.initialized", function onConnectifInitialized() {
trackPageVisit();
},
{ once: true });
}
Enviar información del objeto "options"
La función también puede recibir de forma opcional un segundo objeto "options", que puede contener alguno de los siguientes campos:
| Nombre | Obligatoria | Tipo | Descripción |
|---|---|---|---|
| options.onResponded | No | function | Callback que será llamado una vez que los eventos hayan sido enviados a Connectif. |
| options.cart | No | object |
Indica el objeto de tipo Carrito de la Compra que se enviará a Connectif (en lugar de coger el carrito de la Etiqueta de "Estado actual del carrito de la compra"). |
| options.entityInfo | No | object |
Indica el objeto con la información del Contacto que se enviará a Connectif (en lugar de cogerlo de la Etiqueta de "Información del contacto"). |
| options.pageInfo | No | object |
Indica el objeto con la información de la página que enriquece el evento página visitada (en lugar de cogerlo de los metadatos de la página y de las etiquetas de Etiqueta de "Categoría de página" y Etiqueta de "Etiqueta de página"). |
Tras recibir respuesta de Connectif la función se encargará de desencadenar las acciones que pueden haberse dictaminado por los flujos de Workflows, como mostrar un contenido inline, un popup, etc.
Ejemplos
A continuación se puede apreciar como utilizar esta función para realizar el seguimiento de los diferentes eventos:
- Notificar evento de página visitada.
- Notificar evento de producto visitado.
- Notificar evento de compra realizada.
- Notificar información del carrito.
- Notificar información del contacto.
- Notificar evento búsqueda.
- Notificar evento suscripción a newsletter.
- Notificar evento de login.
- Notificar evento de registro.
- Notificar evento personalizado.
¡Enhorabuena!
Has llegado al final de la lección.
¿Te han quedado dudas sin resolver?
Recuerda que tienes a tu disposición a nuestros especialistas en Connectif. Para contactar con ellos, tan solo tendrás que abrir ticket a Soporte haciendo clic en el botón azul de “Ayuda” de tu dashboard.
¡Sigue aprendiendo!
Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:
- Añadir el JavaScript de Connectif en tu web, para insertar el código y comenzar a recopilar información sobre las visitas a tu página.
- Integración mediante etiquetas, para conocer todas las notificaciones que puedes enviar desde tu eCommerce a Connectif y su funcionamiento.
- Integración con Connectif vía API, para sincronizar contactos, productos, compras y cupones.
- Comprobar la integración con el eCommerce, para asegurarte de que todos los datos están sincronizándose de forma correcta en tu cuenta de Connectif.