You need to enable JavaScript to run this app.
导航
企业直播
  • 文档首页
    • /
  • 企业直播

奖券奖品

最近更新时间：2023.10.17 09:39:13

首次发布时间：2023.04.04 15:59:34

我的收藏

您可以在奖品库中创建奖券奖品。开奖后，中奖观众可通过配置的领奖链接直接领取奖品。

前提条件

  • 您已开通旗舰版或定制版套餐。具体操作，详见计费说明。
  • 确保您拥有火山引擎主账号或具备营销互动 > 可编辑权限的子账号。有关如何添加子账号，详见子账号管理。
  • 确保您已将观看限制设置为自定义或 OAuth2.0。详见自定义登录和 OAuth2.0。

    说明

    如果您集成了 Web 观播 SDK，确保将鉴权模式设置为自定义（即 mode=2）。详见集成 Web SDK。

操作步骤

  1. 登录企业直播控制台。

  2. 在直播列表中，单击进入直播间。

  3. 在左侧导航栏，选择营销互动 > 抽奖玩法。单击奖品库。
    图片

  4. 在奖品库页面，单击新建奖品。

  5. 在弹出的新建奖品对话框中，单击奖券奖品页签并完成以下配置。
    图片

    配置项

    描述

    奖品名称

    输入奖品的名称。最多支持输入 20 个字符。

    说明

    如需在观看页显示多语言的奖品名称，请同时满足以下要求：

    • 在观看页管理 > 基础信息页面，打开页面语言开关并选择相应的语言。

    • 按照界面提示的规则编辑多语言的奖品名称。简体中文、繁体中文、日语、韩语最多可输入 20 个字符，英文最多可输入 40 个字符。

      发送抽奖后，观看页默认仅显示当前 PC 端浏览器默认语言或移动端系统语言的奖品名称。观众也可以在观看页手动切换页面语言，从而查看其他语言的奖品名称。

    奖品图片

    单击上传图片，上传中奖页面的奖品图片。如不上传，则中奖页面不展示奖品图片。支持上传格式为 JPG、PNG 的图片。

    领奖链接

    填写领奖链接。最多支持输入 200 个字符。支持 URL Scheme。中奖观众可以在中奖页面单击前往领取奖品，在跳转到的领奖页面直接领取奖品。关于领奖页面链接的组成，详见领奖页面链接。

    说明

    填写的领奖链接中不可以包含 AwardSign、ActivityId、ExternalId、AwardId、AwardType、TaskAwardId 和 TaskAwardItemId 参数。

    奖品库存

    奖品的库存数量。取值范围为 [1,100000]，未输入库存数量则表示无限库存。
    该奖品的库存数量在您的主账号及其子账号下的所有直播间中是共享的，即系统会根据所有直播间内抽奖设置的奖品个数计算库存应减少的数量。如果实际抽奖过程中奖品未发放完毕、抽奖被删除或关闭等，未发放完的奖品数量会返还回奖品库。

    说明

    • 奖品库中添加的奖品支持在您的主账号及其子账号下的所有直播间中使用。
    • 奖品库内的修改不会同步至已保存奖品的实时抽奖或累计观看抽奖中。如需同步修改，需在对应的实时抽奖或累计观看抽奖中重新添加奖品。

  6. 在实时抽奖或累计观看抽奖中，添加奖券奖品。详见实时抽奖和累计观看抽奖。

领奖页面链接

实时抽奖

中奖观众在实时抽奖的中奖页面单击前往领取奖品后，可以跳转到领奖页面直接领取奖品。领奖页面的链接为奖券奖品中配置的领奖链接+?+AwardSign+ActivityId+ExternalId+AwardId+AwardType+TaskAwardId，例如 https://live.bytedance.com?ActivityId=1770549707694142&AwardId=1621641300&AwardSign=37e2b7228596d5bf5fbfb164f616c370&AwardType=1&ExternalId=281892860987192&TaskAwardId=1621641300。

参数

类型

描述

示例值

AwardSign

String

校验的加密字符串。
您可以按照以下规则生成 AwardSign 值，并进行 AwardSign 值校验。如果领奖页面链接中的 AwardSign 值与您生成的 AwardSign 值一致，则表明链接未被篡改。

  1. 按照 AccountSecret、ActivityId、AwardId、AwardType、ExternalId 的顺序，拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

说明

请联系技术支持获取 AccountSecret。若缺少该参数值，则领奖页面链接中将无法包含 AwardSign 参数。

37e2b7228596d5bf5fbfb164f616c370

ActivityId

Integer

直播间 ID。您可以通过调用 GetActivityAPI 接口查询直播间信息。

1770549707694142

ExternalId

String

观众在第三方平台的唯一标识。您可以根据该关联用户 ID 识别企业自身的用户身份，以便于按需实现用户洞察和进行数据分析。观众通过不同方式登录直播间，其关联用户 ID 的取值如下所示：

  • 自定义：自定义登录时通过 UserId 传入的值。详见自定义登录。
  • OAuth 2.0：您自有账号系统中用户 ID 对应的字段。

281892860987192

AwardId

Integer

实时抽奖的奖品 ID。您可以通过调用 GetAwardConfigListAPI 查询该奖品的配置。

1621641300

AwardType

Integer

抽奖类型。取值为 1，表示实时抽奖。

1

TaskAwardId

Integer

已废弃。

无

累计观看抽奖

中奖观众在累计观看抽奖的中奖页面单击前往领取奖品后，可以跳转到领奖页面直接领取奖品。领奖页面的链接为奖券奖品中配置的领奖链接+?+AwardSign+ActivityId+ExternalId+TaskAwardItemId+AwardType+TaskAwardId，例如 https://live.bytedance.com?ActivityId=1770549707694142&AwardSign=f10ead58bc92279c29c72c589299a781&AwardType=2&ExternalId=281892860987192&TaskAwardId=1771649735489607&TaskAwardItemId=12029。

参数

类型

描述

示例值

AwardSign

String

校验的加密字符串。
您可以按照以下规则生成 AwardSign 值，并进行 AwardSign 值校验。如果领奖页面链接中的 AwardSign 值与您生成的 AwardSign 值一致，则表明链接未被篡改。

  1. 按照 AccountSecret、ActivityId、AwardType、ExternalId、TaskAwardId、TaskAwardItemId 的顺序，拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

说明

请联系技术支持获取 AccountSecret。若缺少该参数值，则领奖页面链接中将无法包含 AwardSign 参数。

f10ead58bc92279c29c72c589299a781

ActivityId

Integer

直播间 ID。您可以通过调用 GetActivityAPI 接口查询直播间信息。

1770549707694142

ExternalId

String

观众在第三方平台的唯一标识。您可以根据该关联用户 ID 识别企业自身的用户身份，以便于按需实现用户洞察和进行数据分析。观众通过不同方式登录直播间，其关联用户 ID 的取值如下所示：

  • 自定义：自定义登录时通过 UserId 传入的值。详见自定义登录。
  • OAuth 2.0：您自有账号系统中用户 ID 对应的字段。

281892860987192

TaskAwardItemId

String

累计观看抽奖的奖品 ID。

12029

AwardType

Integer

抽奖类型。取值为 2，表示累计观看抽奖。

2

TaskAwardId

Integer

累计观看抽奖配置 ID。

1771649735489607