Guía práctica
Insertar formularios en tu web
Añade una vez el script de Emailit a tu web, coloca los formularios integrados, abre formularios desde tu propio código y gestiona los tokens, la publicación y las respuestas de los formularios.
Una sola etiqueta script muestra en tu web todos los formularios publicados de tu espacio de trabajo. Esta página explica dónde ponerla, cómo colocar los formularios integrados, cómo abrir un formulario desde tu propio código, cómo compartir un formulario como página alojada y cómo comprobar que llegan las respuestas.
Antes de empezar
- Crea y publica al menos un formulario. Solo los formularios publicados aparecen en tu web. Consulta Crear un formulario.
- Necesitas poder editar el HTML de tu web o añadir una etiqueta HTML personalizada en tu gestor de etiquetas.
Añadir el script
-
Copia el fragmento de código. En Email MarketingForms, selecciona Install. El fragmento también está en la página de cada formulario, en la tarjeta Installation & sharing. Tiene este aspecto, con la clave pública de tu espacio de trabajo en la ruta:
<script async src="https://js.emailit.com/js/<WORKSPACE_PUBLIC_KEY>/emailit.js"></script> -
Añádelo a todas las páginas. Pégalo una vez en el diseño o la plantilla compartida de tu web, idealmente justo antes de la etiqueta de cierre
</body>. Es el mismo fragmento para todos los formularios del espacio de trabajo, así que solo lo instalas una vez. -
Publica tus formularios. Los pop-ups, los flyouts, los formularios de página completa y los banners publicados ya aparecen en tu web sin más código.
El script se carga de forma asíncrona y no bloquea tu página. Si algo falla, como un error de red, no muestra nada y tu página sigue funcionando. También funciona cuando se añade a través de un gestor de etiquetas.
Si tu web usa una Content Security Policy, permite https://js.emailit.com en script-src y https://api.emailit.com en connect-src.
Cómo aparecen los formularios superpuestos
| Tipo | Cuándo se muestra |
|---|---|
| Banner | En cuanto se carga la página. Se muestran todos los banners publicados. |
| Popup, Flyout, Full page | 2,5 segundos después de cargarse la página. Solo se muestra uno de ellos en cada carga de página. |
Para cambiar el retraso, establece display_delay_seconds en los settings del formulario con Actualizar un formulario.
Cuando un visitante cierra un formulario, sigue oculto en ese navegador durante 7 días. Después de enviarlo, sigue oculto durante un año. Emailit lo recuerda en el almacenamiento local del navegador, con la clave emailit_forms_v1, y no usa cookies. Si el almacenamiento local no está disponible, los formularios se muestran en cada carga de página.
Integrar un formulario en tu página
Los formularios integrados se muestran dentro de tu contenido, por ejemplo en un pie de página o en la barra lateral de un blog. Además del script, necesitan un elemento contenedor:
-
Copia el elemento contenedor. Abre la página del formulario integrado. La tarjeta Installation & sharing muestra el elemento contenedor con el token público del formulario:
<div data-emailit-form="FORM_TOKEN"></div> -
Colócalo. Pega el elemento contenedor donde deba aparecer el formulario. Puedes usar el mismo formulario en varios sitios.
-
Comprueba el script. Asegúrate de que el script también está en la página.
El script rellena todos los elementos contenedores data-emailit-form cuyo token coincide con un formulario integrado publicado. También vigila la página, así que los elementos contenedores que se añaden más tarde, por ejemplo en una aplicación de una sola página, se rellenan cuando aparecen. Los formularios integrados se muestran siempre, tanto si el visitante los ha enviado antes como si no.
Abrir un formulario desde tu código
Añade a cualquier botón o enlace el atributo data-emailit-open con el token público del formulario. Al hacer clic, se abre el formulario:
<button type="button" data-emailit-open="FORM_TOKEN">
Join the newsletter
</button>Desde tu propio JavaScript, llama a emailit("show", token) para abrir un formulario y a emailit("close", token) para cerrarlo. Mantén la primera línea. El script se carga de forma asíncrona, y esta línea pone tus llamadas en cola hasta que esté listo. Sin ella, una llamada que se ejecute antes de que el script se haya cargado falla con emailit is not defined.
window.emailit=window.emailit||function(){(window._emailitq=window._emailitq||[]).push(arguments)};
emailit("show", "FORM_TOKEN"); // open the form
emailit("close", "FORM_TOKEN"); // close it- El formulario se abre de inmediato, aunque el visitante lo haya cerrado o enviado antes. La segmentación y los límites de frecuencia no se aplican.
- El formulario debe estar publicado y el script debe estar en la página.
- Un formulario integrado se abre como pop-up. Si la página tiene su elemento contenedor, la página se desplaza hasta él.
emailit("close")sin token cierra todos los pop-ups, flyouts, formularios de página completa y banners abiertos.- Un enlace a una página de tu sitio que termine en
#emailit-FORM_TOKENtambién abre el formulario.
openForm funciona como alias de show.
Compartir una página alojada
Una página alojada muestra un solo formulario en una página propia, en https://forms.emailit.com/<public token>, para que la gente pueda suscribirse sin visitar tu web: desde la bio de una red social, un email, un anuncio o un código QR impreso. Las páginas alojadas están incluidas en Pay as you goProBusinessCustom.
-
Publica el formulario. La página alojada muestra la versión publicada del formulario, igual que tu web.
-
Abre el enlace. En la página del formulario, abre la pestaña Link & QR code de la tarjeta Installation & sharing. Copia el enlace, selecciona Open hosted page para probarlo o selecciona Download QR para obtener el código QR en SVG. El menú Actions del formulario también incluye Open hosted page.
La página muestra el formulario solo, centrado, sin botón de cerrar y sin reglas de visualización: la segmentación, los disparadores y los límites de frecuencia solo se aplican en tu web. Las respuestas funcionan igual que en tu web. En el editor, el mismo enlace está en Share & preview, dentro de la pestaña Settings.
El enlace usa el token público del formulario, así que restablecer el token le da a la página una dirección nueva y el enlace antiguo deja de funcionar. Cuando el formulario se despublica, o el espacio de trabajo pasa a Pay as you go, la página muestra el mensaje «Este formulario no está disponible en este momento.» en el idioma del visitante, en lugar del formulario.
Gestionar un formulario publicado
Actualizar o despublicar
Los cambios que guardas en un formulario publicado, o su despublicación, llegan a tu web en aproximadamente un minuto. Para quitar un formulario de tu web, abre su página y selecciona Unpublish. Vuelve a ser un borrador y puedes publicarlo de nuevo más adelante.
Restablecer el token público
Cada formulario tiene un token público, que aparece como Public token en su página. Lo usan los elementos contenedores de los formularios integrados, las llamadas a emailit("show", ...) y el enlace de la página alojada. Para generar uno nuevo, llama a Restablecer el token público:
curl https://api.emailit.com/v2/forms/frm_8Lq2Wx5nVb3Tk/reset-token \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY"El token antiguo deja de funcionar de inmediato, así que actualiza tus elementos contenedores, tu código y los enlaces que hayas compartido con el nuevo token de la respuesta. Los formularios superpuestos que se muestran automáticamente no se ven afectados.
Comprobar las respuestas
Envía el formulario en tu web con tus propios datos y después abre la página del formulario en el panel. Recent submissions enumera cada respuesta con su hora de Created y su Payload: los valores enviados, indexados por el nombre de propiedad de cada campo. Filtra la lista por fecha de creación.
Junto con los valores, Emailit guarda con cada respuesta la URL de la página, el referente, la dirección IP del visitante y el user agent de su navegador. Menciónalo en tu aviso de privacidad.
Una respuesta con una dirección de email también crea o actualiza el contacto y lo añade a las listas del formulario. Consulta Respuestas.
Solución de problemas
El formulario no aparece
Comprueba que el formulario está Live y que el script está en la página, con la clave de tu espacio de trabajo en su URL. Si cerraste o enviaste el formulario antes, sigue oculto en tu navegador: abre la página en una ventana privada o elimina la entrada emailit_forms_v1 del almacenamiento local. Recuerda que solo se muestra un pop-up, flyout o formulario de página completa por cada carga de página.
Un formulario integrado no se muestra
Comprueba que el tipo del formulario es Embed, que está publicado y que el valor data-emailit-form del elemento contenedor coincide con el token público actual del formulario. Si restableciste el token, actualiza el elemento contenedor.