Integración de 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 Fast Track Front End Javascript SDK anteriormente (y que no pretenden integrar Fast Track Rewards junto con Fast Track Javascript SDK para Notificaciones en Sitio y Rich Inbox).
Si pretendes integrar Fast Track Rewards Front End junto con Fast Track Javascript SDK para Notificaciones en Sitio y Rich Inbox, lee este artículo en su lugar »​

Paso 1: Mecanismo de autenticación (JWT)

En tu backend, necesitas generar un JWT Token que se ajuste a las Especificaciones JWT Oficiales. Este JWT Token debe contener el id del usuario actualmente conectado y el JWT Token debe estar codificado con un secreto que compartirás con tu Fast Track Partner Manager o Integration Manager.
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 FT rewards.
  2. Mantén la expiración del token corta y vuelve a autenticar si es necesario. Puedes usar la función 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

Agrega este código javascript en tu front end, preferiblemente lo más temprano posible.

Paso 3: Cargar el Javascript SDK

Copia este fragmento exactamente como está y pégalo en tu código 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 Fast Track Rewards Web Components para mostrar el "Modal de Mis Recompensas".

HTML:

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

CSS:

Para hacer que el elemento ft-my-rewards-toggle esté oculto por defecto puedes agregar el CSS a continuación.

Cómo reautenticar Rewards

Estas funciones en el SDK pueden usarse cuando un usuario cierra sesión y vuelve a iniciar sesión sin refrescar la página. O para reautenticar con un nuevo token JWT. Ten en cuenta que puede diferir de cómo reautenticar con las notificaciones OnSite.
window.logoutFtRewards() Cierra la sesión del usuario actual y ya no verán Rewards.
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 Rewards para el usuario conectado. Busca el window.sid para el token JWT con el cual autenticarse.

El flujo ilustrado

​
​