You need to enable JavaScript to run this app.
导航

奖品库(直播伴侣)

最近更新时间2024.03.28 15:04:41

首次发布时间2024.03.28 15:04:41

奖品库即存放奖品的仓库。您可以将常用的奖品添加到奖品库中,从而在进行实时抽奖或累计观看抽奖时可以直接从奖品库中选择奖品。通过该功能,可以方便快捷地配置抽奖活动及实现对奖品的统一管理。

前提条件

  • 您已开通旗舰版或定制版套餐。详见计费说明

    说明

    仅定制版支持新增自定义奖品。

  • 确保您已启用互动工具菜单。有关如何启用互动工具菜单,详见互动工具
  • 如需新增自定义奖品,确保您已将观看限制设置为自定义OAuth2.0。详见自定义登录OAuth 2.0

操作步骤

  1. 在页面右下方,单击互动工具菜单下的抽奖图标。
    图片

  2. 抽奖对话框中,单击选择奖品下拉列表中的新建奖品或页面右上方的奖品库
    图片

  3. 在弹出的奖品库页面,单击新建奖品
    图片

  4. 在弹出的新建奖品对话框中,按需选择奖品类型并完成以下配置。

    • 实物奖品:指实体奖品,例如手机、手办等。开奖后,根据中奖人信息联系中奖人或邮寄奖品。
    • 虚拟奖品:指非实体奖品,例如游戏虚拟货币或装备等。开奖后,根据中奖人信息联系中奖人。
    • 自定义奖品:指企业可自行发放的奖品,例如优惠券、积分等。开奖后,企业直播会触发实时抽奖结果回调。您可进行二次开发,根据中奖回调消息向中奖观众发送短信或站内信以及自动发放奖品。
    • 奖券奖品:指观众可自行领取的奖品,例如优惠券、购物券等。开奖后,中奖观众可通过企业配置的领奖链接直接领取奖品。

    图片

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

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

    • 奖品库存:奖品的库存数量。取值范围为 [1,100000],未输入库存数量则表示无限库存。

      该奖品的库存数量在您的主账号及其子账号下的所有直播间中是共享的,即系统会根据所有直播间内抽奖设置的奖品个数计算库存应减少的数量。如果实际抽奖过程中奖品未发放完毕、抽奖被删除或关闭等,未发放完的奖品数量会返还回奖品库。

    • 中奖人填写:观众中奖后需要填写的个人信息。

    说明

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

  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

已废弃。