Integração Front End

Esta página explica os requisitos de integração para conseguir integrar o Fast Track Rewards. Este guia é para marcas que não integraram anteriormente o Fast Track Front End Javascript SDK (e que não pretendem integrar o Fast Track Rewards em conjunto com o Fast Track Javascript SDK para Notificações On Site e Rich Inbox).
Se pretende integrar o Fast Track Rewards Front End em conjunto com o Fast Track Javascript SDK para Notificações On Site e Rich Inbox, leia este artigo em vez disso »​

Passo 1: Mecanismo de Autenticação (JWT)

No seu backend, precisa de gerar um Token JWT que esteja em conformidade com as Especificações Oficiais do JWT. Este Token JWT deve conter o id do utilizador atualmente logado e o Token JWT deve ser codificado com um segredo que irá partilhar com o seu Gestor de Parceiro Fast Track ou Gestor de Integração.
Recomendações
  1. Se já está a usar JWT para a sua própria autenticação no seu site, recomendamos que implemente uma funcionalidade separada especificamente para as recompensas FT.
  2. Mantenha a expiração do token curta e re-autentique se necessário. Pode usar a função SDK window.updateFtJwtToken(newToken) para atualizá-lo dentro da mesma sessão.
  3. Suportamos dois algoritmos, RSA e HMAC. Recomendamos usar RSA com chaves públicas e privadas.

Exemplo de payload JWT

Passo 2: Configurar o objeto de configuração

Adicione este código javascript no seu front end, preferencialmente o mais cedo possível.

Passo 3: Carregar o Javascript SDK

Copie este snippet exatamente como está e cole-o no seu código front end, diretamente após onde colou o objeto de configuração (secção acima).

Passo 4: Ligar evento de clique para abrir "As Minhas Recompensas"

Abaixo descreve-se como pode usar os Fast Track Rewards Web Components para mostrar o "Modal das Minhas Recompensas".

HTML:

Pode colocar qualquer elemento HTML dentro do elemento Fast Track ft-my-rewards-toggle. A visibilidade deste elemento HTML e do seu conteúdo é controlada a partir do FT CRM.

CSS:

Para tornar o elemento ft-my-rewards-toggle oculto por defeito, pode adicionar o CSS abaixo.

Como re-autenticar Recompensas

Estas funções no SDK podem ser usadas para quando um utilizador faz logout e volta a fazer login sem atualizar a página. Ou para re-autenticar com um novo token JWT. Por favor note que pode diferir de como re-autenticar com as notificações OnSite.
window.logoutFtRewards() Faz logout do utilizador atual e deixará de ver Recompensas.
window.updateFtJwtToken("newJWTToken") Irá atualizar o token JWT existente que é usado dentro do FT Rewards, preenchendo a variável window.sid.
window.initFtRewards() inicializa o componente Rewards para o utilizador logado. Procura o window.sid para o token JWT para autenticar.

O fluxo ilustrado

​
​