SecuTix Gravity Team is thrilled to release the Newsletter Widget as one of our first widgets! The Newsletter Widget is nothing but a simple code snippet which you can easily integrate into a website. In the past, your online customers can only subscribe to your newsletter via SecuTix online sales platform by either creating an account or purchasing as a guest. With this widget, your potential customers could subscribe to your newsletter from any website that has the widget embedded. This flexible, highly customizable and easy to integrate widget could help you increase your newsletter's online exposure to a great extent.
| Note |
|---|
Please note that this article only applies to SecuTix Gravity Newsletter Widget V1 which is released within PizBernina V2. |
How does it work?
To use a newsletter widget, first you would need to integrate a code snippet into your target website. You may either contact your web agency to embed the snippet into your website's HTML code or integrate it via Google Tag Manager. The code snippet will first call SecuTix back-end service to fetch the necessary configurations (e.g. theme and labels) and then render the user interface of the widget based on the configuration. You can put the widget anywhere in your website, e.g., inside a popup, inside the footer or on the secondary column of your website, just to name a few. The user interface of this widget contains a simple form with various fields (e.g. email address, civility, first name and last name) and a submit button. Its default style and theme are the same as the ones from the corresponding online sales platform.
Once your online customers fill in the necessary information inside the widget and click the submit button, the newsletter widget will call SecuTix back-end service to check whether an account already exists with the given email address. If not, a new account will be created inside SecuTix with the provided user information and future newsletters will be sent to the given email address. If the email is already in use, the newsletter widget will display an error message and a link which points to the login page of the corresponding online sales platform.
Example
Below is an example of the newsletter widget integrated as a popup inside the demo site.
El equipo de SecuTix Gravity está encantado de presentar su Newsletter Widget, uno de sus primeros widgets. El Newsletter Widget no es más que un simple fragmento de código que puede insertarse fácilmente en una página web. Hasta ahora, los clientes en línea solo podían suscribirse a su newsletter a través de la plataforma de venta en línea de SecuTix creando una cuenta o comprando como usuario invitado. Con este widget, sus clientes potenciales podrán suscribirse a su newsletter desde cualquier página web que tenga el widget incrustado. Este widget flexible, muy personalizable y fácil de insertar puede ayudarle a aumentar en gran medida la visibilidad en línea de su newsletter.
| Note |
|---|
Es importante que tenga en cuenta que este artículo solo se refiere al SecuTix Gravity Newsletter Widget V1 que se publica dentro de PizBernina V2. |
¿Cómo funciona?
Para usar un Newsletter Widget, lo primero que debe hacer es insertar un fragmento de código en la página web de destino. Para ello, debe ponerse en contacto con su agencia web para que incruste el fragmento en el código HTML de su página web o insertarlo a través de Google Tag Manager. El fragmento de código primero llama al servicio back-end de SecuTix para recuperar las configuraciones necesarias (por ejemplo, el tema y las etiquetas) y luego genera la interfaz de usuario del widget basándose en dicha configuración. Puede colocar el widget en cualquier lugar de su página web, por ejemplo, en una ventana emergente, en un pie de página o en la columna secundaria de su página web, entre otros. La interfaz de usuario de este widget contiene un simple formulario con varios campos (por ejemplo, dirección de correo electrónico, tratamiento, nombre y apellido(s)) y un botón de enviar. Su estilo y su tema por defecto son los mismos de la plataforma de venta en línea correspondiente.
Cuando sus clientes en línea han introducido la información necesaria que les pide el widget y hacen clic en el botón de enviar, el Newsletter Widget llama al servicio back-end de SecuTix para comprobar si ya existe una cuenta para esa dirección de e-mail. Si no existe una cuenta, se crea una nueva en SecuTix con la información de usuario proporcionada y se enviarán futuras newsletters a esa dirección de correo electrónico. Si la dirección de correo electrónico ya está en uso, el Newsletter Widget mostrará un mensaje de error y un enlace que dirige a la página de acceso de la plataforma de venta en línea correspondiente.
Ejemplo
A continuación, verá un ejemplo de un Newsletter Widget insertado como ventana emergente en una página web de demostración.
Fragmento de código de muestra
| Code Block | ||||
|---|---|---|---|---|
| ||||
<div id="stx-newsletter"></div>
<script type="text/javascript" src="https://s3.eu-central-1.amazonaws.com/pub.tnwi.p16-s3.secutix.com/stx-widgets/Newsletter/v1/Newsletter.js"></script>
<script type="text/javascript">
STX.config({apiKey:"8bafa660-8bc1-4982-83da-f15fce01f4ec", hostname:"hostname of your online sales platform"});
STX.widgets.Newsletter.render({props:{activeFields: ['civility', 'firstName', 'lastName']}, locale: "fr", root:"#stx-newsletter"});
</script> |
Parámetros
apiKey - the secret token generated in your point of sales configuration screen. You may find this parameter in the Sales Channels > Point of sales > Characteristics > Internet Parameters tab.
hostname - the hostname of the point of sales URL for your online sales platform.
Note Please note that the newsletter widget will fetch the configurations (e.g. theme and labels) from the corresponding point of sales.
activeFields - (Optional) an array where you can specify which fields you want to display in your newsletter widget. Supported fields are "civility", "firstName" and "lastName".
Note Please note that an email field is always displayed regardless of the activeFields values.
- locale - (Optional) the language code which defines the language of the newsletter widget. When not set, the widget will use the main institution language by default.
Legal mention
If you would like to display legal mention inside the newsletter widget, you can do so by using the label overriding mechanism from the light customization screen of the corresponding online sales platform's point of sales.
Clave API - el testigo (o token) secreto generado en la pantalla de configuración de su punto de venta. Puede encontrar este parámetro en Canales de venta > Punto de venta > Características > pestaña Parámetros de Internet.
Nombre de equipo - el nombre de equipo de la URL del punto de venta para su plataforma de venta en línea.
Note Tenga en cuenta que el Newsletter Widget recuperará las configuraciones (por ejemplo, el tema y las etiquetas) del punto de venta correspondiente.
Campos activos - (Opcional) una matriz en la que puede especificar qué campos quiere mostrar en su Newsletter Widget. Los campos admitidos son "tratamiento", "nombre" y "apellido(s)".
Note Tenga también en cuenta que siempre aparece un campo de e-mail independientemente de los valores de Campos activos.
- Local - (Opcional) el código del idioma que define el idioma del Newsletter Widget. Cuando no esté fijado, el widget usará por defecto el idioma de la institución principal.
Aviso legal
Si desea mostrar un aviso legal en el Newsletter Widget, puede hacerlo usando el mecanismo de anulación de la etiqueta de la pantalla de personalización ligera del punto de venta de la plataforma de venta en línea correspondiente.