El evento AJAX de envío de formulario sirve para sincronizar en Connectif formularios integrados y enviar la notificación de "submit" a la herramienta mediante AJAX.
Este artículo forma parte de la guía para crear una integración a medida.
Si tu integración es mediante módulo, este evento será insertado en tu eCommerce de forma automática.
Cómo se usa
El evento AJAX de "submit" utiliza el JavaScript de Connectif para enviar los datos del envío del formulario mediante el método sendEvents, realizando la siguiente llamada a Connectif:
connectif.managed.sendEvents(events, options)
Obtener el identificador del formulario
La propiedad formID identifica al formulario integrado.
Accede al formulario integrado y localiza el formID en su URL.
(captura provisional)
Ejemplo evento onsubmit
El evento onsubmit capta el envío del formulario y ejecuta la función sendForm, la cual envía los datos vía AJAX.
El evento tendrá este aspecto:
<form onsubmit = "sendForm()">
Email: <input type = "email" value = "" id= "email" /><br/>
Name: <input type = "text" value = "" id= "last_name" /><br/>
<input type = "submit" value = "Submit" />
</form>
Ejemplo notificación de envío
La notificación tendrá este aspecto:
function sendForm() {
connectif.managed.sendEvents(
[
{
type: ' form-submitted',
eventId: 'ID_DEL_FORMULARIO_INTEGRADO_DE_CONNECTIF',
primaryKeyField: 'email',
payload: {
'email': document.getElementById('email).value,
'name': document.getElementById('name').value,
}
}
]
) }
(OLD)
connectif.managed.sendEvents( [ { type: 'form-submitted', formId: 'ID_DEL_FORMULARIO_INTEGRADO_DE_CONNECTIF', primaryKeyField: 'email', payload: { email: 'test@example.org', name: 'Test',
custom_field_1: 1234, custom_field_2: 'Esto es una prueba' } } ] )
Si se trata de un formulario de alta (que solicita el email), es necesario incluir el campo "primaryKeyField", y su valor será el nombre del campo en el payload, que contendrá el email que está enviando el formulario. Si el formulario no es de tipo alta, no es necesario indicar en el campo "primaryKeyField".
Verificación del evento
¡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.
RESOLUCIÓN DE INCIDENCIAS
¿Qué ocurre si el formulario no es detectado por Connectif? Existen algunos casos donde la herramienta de Formularios Integrados de Connectif no puede detectar formularios en tu web, por ejemplo:
- El formulario está en una página que requiere autenticación.
- El formulario se construye de forma dinámica vía JavaScript.
En estos supuestos, la opción recomendada es crear un evento de integración personalizada para recibir datos en Connectif.
- Crea tu integración personalizada siguiendo los pasos de este artículo.
- Una vez esté creada, dirígete a la pestaña Recibir Datos y haz clic en Crear nuevo evento de recepción.
- Asígnale un nombre y establece los campos que se van a enviar haciendo clic en Añadir nuevo campo.
- Haz clic en Guardar y vuelve al listado de eventos de tu integración personalizada, donde se encuentra el identificador del evento recién creado:
- Copia dicho identificador para usarlo en el campo "eventId" del siguiente ejemplo de código, para realizar la notificación de este evento a Connectif:
connectif.managed.sendEvents(
[
{
type: 'custom',
eventId: 'ID_DEL_EVENTO_PERSONALIZADO_DE_RECEPCIÓN',
payload: {
mi_campo_email: 'test@example.org',
mi_campo1: 1234,
nombre: 'Test',
campo2: 'Esto es una prueba'
}
}
]
)
En este caso no es necesario indicar un "primaryKeyField" dentro del evento, puesto que el campo de la clave primaria se establece en el campo "mi_campo_email" del evento personalizado.
¡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.