En el presente documento se describen los pasos a seguir para la implementación del formulario de suscripción de contactos de Fideltour en su página web.
Para cualquier duda, puede contactar con nosotros a través del correo electrónico help@fideltour.com.
A continuación se describen los pasos a seguir para la implementación del código de suscripción de usuario al B2C de Fideltour en su página web.
El código consiste en la inclusión de código HTML que debe incluir en su proyecto.
La configuración del código de suscripción de usuario de Fideltour en su página web es un proceso sencillo. Para ello, solo tiene que incluir el siguiente código
<form id="fideltour_form" method="POST"><div>
<label for="name">Name</label>
<input id="name" type="text" name="name" required>
</div>
<div>
<label for="email">Email *</label>
<input id="email" type="email" name="email" required>
</div>
<div>
<input type='hidden' id='subscribedHidden' name='subscribedHidden' value='off'>
<input type="checkbox" name="subscribed" id="subscribed">
<label for="subscribed" >Deseo recibir publicidad y ofertas especiales.</label>
</div>
<div>
<input type="checkbox" name="accept_terms" id="accept_terms" required>
<label for="accept_terms">Acepto</label>
<a href="" target="_blank"> la Política de Privacidad</a> *
</div>
<div>
<button type="submit">Suscribirse</button>
</div>
</form>
<script type="text/javascript">
var url = "https://backend.fideltour.com/api/contacts/subscription/?hc=CH&i=&lang=&tags=";
var redirect_url = "https://www.fideltour.com/";
var form = document.getElementById("fideltour_form");
var serialize = function (form) {
var serialized = [];
for (var i = 0; i < form.elements.length; i++) {
var field = form.elements[i];
if (!field.name || field.disabled || field.type === 'file' || field.type === 'reset' || field.type === 'submit' || field.type === 'button') continue;
if (field.type === 'select-multiple') {
for (var n = 0; n < field.options.length; n++) {
if (!field.options[n].selected) continue;
serialized.push(encodeURIComponent(field.name) + "=" + encodeURIComponent(field.options[n].value));
}
}
else if ((field.type !== 'checkbox' && field.type !== 'radio') || field.checked) {
serialized.push(encodeURIComponent(field.name) + "=" + encodeURIComponent(field.value));
}
}
return serialized.join('&');
};
form.addEventListener("submit", function(e) {
e.preventDefault();
doContactSubscription(this);
});
function doContactSubscription(form_validated){
var xhr = new XMLHttpRequest();
if(document.getElementById("subscribed").checked) {
document.getElementById('subscribedHidden').disabled = true;
}
xhr.open('POST', url);
xhr.setRequestHeader('Content-type', 'application/x-www-form-urlencoded');
xhr.onreadystatechange = function () {
if (xhr.readyState > 2) {
window.location = redirect_url;
}
};
xhr.send(serialize(form_validated));
};
</script>
El paso siguiente consiste en personalizar la URL indicada en la variable var url dentro del script, línea 24 del código anterior, cambiando los respectivos valores a las claves siguientes:
“hc” con el código correspondiente a la empresa. Ejemplo: hc=CH
“i” con los valores correspondientes a los ID de los intereses deseados y separados por comas. Ejemplos: i=3; i=6,7;
“lang” con el ISO Code (ISO 639-1) correspondiente al idioma que se le quiere asignar al contacto suscrito.
“tags” con el listado de etiquetas que se le desean asignar al contacto suscrito, separados por comas. Ejemplos: tags=residente,promoverano.
De manera que la URL completa quedase de la siguiente forma:
Se puede modificar la variable var redirect_url de dentro del script, línea 25 del código anterior, (actualmente https://www.fideltour.com/) por la URL donde se quiere redirigir el contacto
El listado de IDs identificativos de intereses se puede consultar revisando el ‘id’ que figura en la url de cada interés en la intranet del usuario de Fideltour.
Capturas de pantalla de ejemplo:
En caso de querer realizar la suscripción desde el formulario propio de la web y no usar el que proporciona Fideltour, se puede hacer una petición a la url que se indica a continuación
URL del Endpoint: POST https://backend.fideltour.com/api/contacts/subscription/
En la URL, en los parámetros GET se puede indicar lo siguiente:
Parámetro |
Tipo |
Obl. |
Descripción |
hc |
Cadena de caracteres |
Si |
Código de la empresa |
i |
Cadena de caracteres |
No |
Intereses del contacto, en formato numérico y separado por comas. Default: ningún interés |
lang |
Cadena de caracteres |
No |
Idioma del contacto en formato ISO 639-1 Code Default: ningún idioma |
s |
Numérico |
No |
Origen del contacto.
Default: 6 |
tags |
Cadena de caracteres |
No |
Listado de etiquetas personalizadas. Default: ninguna etiqueta |