本页面解释了集成 Fast Track Rewards 的集成要求。本指南适用于之前未集成 Fast Track 前端 Javascript SDK 的品牌(以及不打算将 Fast Track Rewards 与用于站内通知和富收件箱的 Fast Track Javascript SDK 一起集成的品牌)。
如果您打算将 Fast Track Rewards 前端与用于站内通知和富收件箱的 Fast Track Javascript SDK 一起集成, 请阅读此文章 »

步骤1:认证机制(JWT)

在您的后端,您需要生成一个符合官方JWT规范的JWT令牌。此JWT令牌应包含当前登录用户的id,并且JWT令牌应使用您将与Fast Track合作伙伴经理或集成经理共享的密钥进行编码。
建议
  1. 如果您已经在您的网站上使用JWT进行自己的身份验证,我们建议您专门为FT奖励实施单独的功能。
  2. 保持令牌的有效期较短,并在需要时重新认证。您可以使用SDK函数window.updateFtJwtToken(newToken)在同一会话中刷新它。
  3. 我们支持两种算法,RSA和HMAC。我们建议使用带有公钥和私钥的RSA。

JWT载荷示例

步骤2:设置配置对象

在您的前端中添加此javascript代码,最好尽可能早地添加。

步骤3:加载Javascript SDK

将此代码片段原样复制并粘贴到您的前端代码中,直接粘贴在您粘贴配置对象的位置之后(上面的部分)。

步骤4:绑定点击事件以打开"我的奖励"

下面概述了如何使用Fast Track Rewards Web组件来显示"我的奖励模态框"。

HTML:

您可以在Fast Track元素ft-my-rewards-toggle内放置任何HTML元素。此HTML元素及其内容的可见性由FT CRM控制。

CSS:

为了使ft-my-rewards-toggle元素默认隐藏,您可以添加以下CSS。

如何重新认证奖励

SDK中的这些函数可用于用户注销并重新登录而不刷新页面时。或使用新的JWT令牌重新认证。请注意,这可能与如何重新认证站内通知不同。
window.logoutFtRewards() 注销当前用户,他们将不再看到奖励。
window.updateFtJwtToken("newJWTToken") 将更新FT Rewards中使用的现有JWT令牌,填充window.sid变量。
window.initFtRewards() 为登录用户初始化奖励组件。查找window.sid以获取用于认证的JWT令牌。

流程图解