Integración Front End

Esta página explica los requisitos de integración para poder integrar Fast Track Rewards. Esta guía es para marcas que no han integrado el SDK de Javascript de Front End de Fast Track anteriormente (y que no tienen la intención de integrar Fast Track Rewards junto con el SDK de Javascript de Fast Track para Notificaciones en el Sitio y Rich Inbox).
Si tienes la intención de integrar Fast Track Rewards Front End junto con el SDK de Javascript de Fast Track para Notificaciones en el Sitio y Rich Inbox, lee este artículo en su lugar »​

Paso 1: Mecanismo de autenticación (JWT)

En tu backend, necesitas generar un Token JWT que se ajuste a las Especificaciones Oficiales de JWT. Este Token JWT debe contener el id del usuario actualmente conectado y el Token JWT debe ser codificado con un secreto que compartirás con tu Gerente de Socios de Fast Track o Gerente de Integración.
Recomendaciones
  1. Si ya estás usando JWT para tu propia autenticación en tu sitio, recomendamos que implementes una funcionalidad separada específicamente para las recompensas de FT.
  2. Mantén la expiración del token corta y re-autentica si es necesario. Puedes usar la función del SDK window.updateFtJwtToken(newToken) para actualizarlo dentro de la misma sesión.
  3. Soportamos dos algoritmos, RSA y HMAC. Recomendamos usar RSA con claves públicas y privadas.

Ejemplo de payload JWT

Paso 2: Configurar el objeto de configuración

Añade este código javascript en tu front end, preferiblemente lo antes posible.

Paso 3: Cargar el SDK de Javascript

Copia este fragmento exactamente como está y pégalo en tu código de front end, directamente después de donde pegaste el objeto de configuración (sección anterior).

Paso 4: Conectar evento de clic para abrir "Mis Recompensas"

A continuación se describe cómo puedes usar los Componentes Web de Fast Track Rewards para mostrar el "Modal de Mis Recompensas".

HTML:

Puedes poner cualquier elemento HTML dentro del elemento de Fast Track ft-my-rewards-toggle. La visibilidad de este elemento HTML y su contenido se controla desde FT CRM.

CSS:

Para hacer que el elemento ft-my-rewards-toggle esté oculto por defecto puedes añadir el CSS siguiente.

Cómo re-autenticar Recompensas

Estas funciones en el SDK pueden ser usadas cuando un usuario cierra sesión y vuelve a iniciar sesión sin refrescar la página. O para re-autenticar con un nuevo token JWT. Ten en cuenta que puede diferir de cómo re-autenticar con las notificaciones OnSite.
window.logoutFtRewards() Cierra la sesión del usuario actual y ya no verán Recompensas.
window.updateFtJwtToken("newJWTToken") Actualizará el token JWT existente que se usa dentro de FT Rewards, poblando la variable window.sid.
window.initFtRewards() inicializa el componente de Recompensas para el usuario conectado. Busca el window.sid para el token JWT con el que autenticarse.

El flujo ilustrado

​
​