La integración mediante API es la opción de integración personalizada con Connectif que permite un control total sobre los datos enviados, pero solo permite sincronizar Contactos, Productos, Compras y Cupones. El resto de eventos deberán ser integrados mediante alguna de las otras opciones, etiquetas HTML o eventos JavaScript.
Para realizar este tipo de integraciones, necesitarás de un experto con conocimientos de programación, para poder obtener datos de tu eCommerce y realizar llamadas HTTP a una API REST.
Antes de empezar: ventajas y limitaciones de una integración por API
Respecto a las ventajas:
- No depende del cliente, ya que será una llamada HTTP donde podrás controlar la respuesta recibida para asegurar que el evento llegó y se procesó correctamente.
- Se pueden realizar importaciones masivas. Mientras que con las otras opciones se actualizan siempre uno a uno.
Las posibles limitaciones de una integración vía API son las siguientes:
- Requiere un departamento IT capaz de realizar las llamadas necesarias a la API de Connectif.
- Existe un número máximo de llamadas a la API permitido por minuto, de modo que para realizar operaciones masivas se recomienda utilizar la API de importaciones, donde una sola llamada es capaz de sincronizar múltiples elementos.
- No es posible integrar todos los eventos mediante la API, hay que combinar esta opción con alguna de las otras formas de integrar.
Aprende cómo funciona la API de Connectif en este artículo.
¿Cómo integrar Connectif vía API?
1. Añadir el JavaScript de Connectif
Configura el JavaScript de Connectif la web para que cargue en todas las páginas y poder integrar mediante eventos.
2. Sincronizar vía API
Configura la sincronización de información sobre:
- Contactos: para registrar los datos de los visitantes del eCommerce.
- Productos: para sincronizar el catálogo.
- Compras: para describir las compra realizadas por los clientes.
- Cupones: para sincronizar los códigos de cupón y sus usos.
3. Sincronizar el resto de eventos mediante otro método
3.1. Etiquetas HTML renderizadas en el servidor o en el cliente:
- Etiqueta de "Estado actual del carrito de la compra": para describir el carrito de la compra que tiene el contacto en un momento determinado.
- Etiqueta de "Etiqueta de página": para asignar una etiqueta a una página.
- Etiqueta de "Categoría de página": para asignar una categoría de producto a una página.
- Etiqueta de "Contacto ha visitado un producto": para avisar de que el contacto ha visitado un producto en concreto durante su navegación por la web.
La sincronización del catálogo de productos va a ser realizada vía API, por lo que será necesario desactivar la sincronización y verificación automáticas. Para enviar el evento de "Contacto ha visitado producto" no es necesario que el HTML se renderice en el servidor.
- Etiqueta de "Contacto ha buscado un producto": para identificar una visita a un producto como resultado directo de una búsqueda del mismo.
- Etiqueta de "Contacto ha hecho login": para indicar que el contacto ha iniciado sesión.
- Etiqueta de "Contacto se ha registrado": para indicar un nuevo registro.
- Etiqueta de "Suscripción a la newsletter": para indicar que un contacto se ha suscrito al boletín.
3.2. Eventos enviados mediante JavaScript:
- Notificación de página visitada: para avisar de que el contacto ha visitado una página durante su navegación por la web.
- Notificación de producto visitado: para avisar de que el contacto ha visitado un producto en concreto durante su navegación por la web.
- Notificación de información del carrito: para describir el carrito de la compra que tiene el contacto en un momento determinado.
- Notificación de búsqueda realizada: para indicar que se ha realizado una búsqueda e identificar qué términos se han usado.
- Notificación de login: para indicar que el contacto ha iniciado sesión.
- Notificación de registro: para indicar un nuevo registro.
- Notificación de suscripción a la newsletter: para indicar que un contacto se ha suscrito al boletín.
5. Configurar las Web Push
Para completar la integración también deberás configurar el Service Worker para poder recibir suscripciones a Web Push y enviar notificaciones a tus contactos.
- Comienza a administrar las notificaciones Web Push.
6. Validar la integración
Una vez implementado el envío de información a Connectif, el siguiente paso será validar que la integración se ha realizado correctamente.
¡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:
-
Onboarding, para adquirir destreza con nuestra interfaz.
-
Workflows iniciales, para implementar tus primeras estrategias en la cuenta.
-
Integraciones con sistemas externos, para integrarte con Facebook, formularios y webhooks de tu web.
-
Eventos que consumen Actividades, para comprender mejor el consumo de tu cuenta.