推荐计划

推荐计划是一种吸引新用户的方法，现有用户通过特殊链接邀请其好友前往网页商城。因此计划的所有参与者都会获得奖励，这可以增强其忠诚度以及与网页商城持续互动的动力。

推荐计划可以让圈内达人和公会领袖推广网页商城，使自己和粉丝均受益。受邀者在首次购买时可获得奖励，从而增加在网页商城下单的活跃用户数量。

• 提供以下类型的一个或多个商品作为奖励：
  • 虚拟货币
  • 虚拟物品
  • 商品捆绑包
• 自定义推荐计划小组件。
• 生成推荐链接。
• 在受邀者首次购买之前更换选中的推荐计划。

• 一个项目中只能有一个推荐计划。
• 用户不能邀请自己。

邀请方流程

1. 邀请方进入网页商城。
2. 邀请方登录或注册网站。
3. 邀请方打开推荐计划小组件并阅读计划条件。
4. 邀请方在小组件中获取推荐链接。
5. 邀请方将链接分享给受邀者。
6. 受邀者点击链接并完成计划条件。
7. 邀请方打开推荐计划小组件，然后单击按钮领取奖励。

受邀者流程

1. 受邀者收推荐链接以及计划条件和奖励描述。
2. 受邀者通过推荐链接进入网页商城。
3. 受邀者在网页商城上完成注册。
4. 受邀者在网页商城进行首次购买。
5. 受邀者获得奖励。

如何获取

创建推荐计划

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中单击商店。
3. 在Live-ops and promotion tools窗格中，单击：
   • 连接 — 如果还没有促销活动或奖励。
   • 配置 — 如果之前已连接过促销活动或奖励。

4. 在推荐计划选项卡上，单击创建推荐计划。
5. 设置必要的参数：
   • 指定推荐计划的名称
   • 输入描述

6. 单击下一步。
7. 添加邀请方和受邀者将获得的奖励：
   • 要为邀请方添加奖励，在邀请玩家的奖励部分中，指定商品的SKU及其数量。
   • 要为受邀者添加奖励，在受邀者的奖励部分中，指定商品的SKU及其数量。

8. 单击下一步。
9. 检查推荐计划的描述，然后单击创建。

10. 要激活推荐计划，请将推荐计划开关设置为开。

设置推荐计划后，您可以创建和自定义小组件。

小组件设置

1. 在推荐计划页面，单击前往定制器。

2. 针对不同状态设置小组件组件。为使小组件与游戏和网站设计相匹配，您可以自定义并配置以下特征：
   • 界面元素集
   • 界面元素颜色
   • 按钮文本和标题（将本地化纳入考量）
   • 字体类型、颜色和大小

在小组件设置中，您还可以根据游戏的特点自定义推荐计划常见问答区块的内容。

3. 设置本地化。所有小组件文本都会翻译成在发布商帐户的项目设置 > 常规设置 > 项目语言部分中指定的项目语言。
   如要更改默认翻译，请双击文本并输入您自己的版本。
4. 单击发布。
5. 在打开的窗口中复制小组件代码并将其添加到您的网站。

将小组件代码添加到网站后，打开小组件的按钮将在页面上显示：

将小组件代码添加至您的网站

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中单击建站器。
3. 在站点部分，选择您的网站，然后单击打开建站器。
4. 单击添加区块。
5. 选择自定义代码区块。
6. 添加推荐计划小组件代码。

设置身份认证

如果使用自己的网站界面，则需要在己侧实现小组件中的用户授权功能。

小组件中的授权是通过小组件所在网站上的授权来进行的。

根据用户是在网站还是小组件中授权，有两种情况：

• 如果用户在网站上授权，您需要使用onTokenChange()方法将用户的授权令牌传入小组件。当用户退出系统时，需将null作为方法参数传入。

• 如果用户通过小组件授权，小组件将调用在初始化期间传递给它的requestAuth函数。作为响应，网站应返回用户的授权令牌。

window.XESApi.init({
requestAuth: requestAuth,
token: getToken()
})

小组件API提供了一组用于在小组件中认证用户身份的函数和方法：

如何进行更改

修改推荐计划设置

• 更改作为奖励提供的商品列表
• 更改描述

1. 前往已创建的推荐计划。
2. 单击编辑。

3. 更新文本或商品SKU。
4. 单击保存。

保存更改后，用户将看到更新后的活动条件并获得新的奖励。

用户在条件更新前已获得的奖励不会改变。

更新条件后无需重新发布小组件。

修改小组件设置

1. 前往小组件设置。
2. 进行所需的更改。
3. 单击发布。

小组件状态

推荐计划小组件可以根据用户类型（邀请方或受邀者）、用户授权状态、推荐计划条件满足情况而显示不同的状态。

小组件组件集包含不同状态的界面元素。您可以在设置小组件时配置这些组件。

打开小组件的按钮：

状态	描述	显示对象	可编辑的组件	图片
查看详细信息	鼓励用户参与推荐计划。	已授权但尚未参与推荐计划的用户。	背景和文字颜色。小组件打开按钮和查看详细信息按钮的文本。
等待授权	鼓励用户通过小组件登录。	已点击推荐链接但未授权的用户。	背景和文字颜色。按钮文本。
等待首次购买	鼓励用户进行首次购买。	已点击推荐链接并登录了网站的用户。	背景和文字颜色。按钮文本。
领取奖励	鼓励用户领取奖励。	邀请的好友已满足推荐计划条件，可以领取奖励的邀请方。	背景和文字颜色。按钮文本。
关闭小组件	小组件已打开，按钮变成×图标。	打开了小组件详细信息的授权用户。	背景和文字颜色。按钮颜色。
默认	小组件关闭。	关闭了小组件的用户。	背景和文字颜色。按钮文本。

邀请方的小组件页面：

描述	显示对象	可编辑的组件	图片
推荐计划详情。 发送推荐链接的按钮。 奖励列表及状态： 已领取 — 受邀者已领取奖励。 进行中 — 受邀者已登录网站，但尚未进行购买。 领取 — 受邀者已登录网站并完成首次购买。邀请方可以领取奖励。	已授权的邀请方，其好友已通过推荐链接登录网站。	背景和文字颜色。小组件文本，按钮文本。
常见问答部分	点击了推荐计划信息按钮的已授权邀请方。	添加和删除问答区块。背景和文字颜色。问题和回答内容。

受邀者的小组件页面：

描述	显示对象	可编辑的组件	图片
鼓励在网站上进行购买的小组件文本。用户完成购买后将向其显示一条领取奖励的通知。	已点击推荐链接并登录的用户。	背景和文字颜色。小组件文本，按钮文本。