本文介绍了如何在企业直播控制台、网页直播开播页面和直播伴侣新建、配置和发送实时抽奖。实时抽奖有助于提高直播间的互动氛围，丰富直播效果。

观看页效果演示

前提条件

• 您已开通旗舰版或定制版套餐。详见计费说明。
• 确保您拥有火山引擎主账号或具备以下权限的子账号。有关如何添加子账号，详见子账号管理。
  • 奖品库 > 仅查看或可编辑权限：用于添加奖品。如需在奖品库中新建奖品，则子账号需具备奖品库 > 可编辑权限。
  • 直播控制 > 可编辑权限：用于管理抽奖。仅在通过控制台管理抽奖或者通过控制台进入网页直播开播页面管理抽奖时，需要该子账号权限。
• 如需通过网页直播开播页面管理抽奖，推荐您使用满足指定条件的设备以及浏览器进行直播，以保证您可以获得流畅的直播体验。详见开播环境要求。
• 如需通过直播伴侣管理抽奖，确保您已下载、安装直播伴侣。有关如何下载和安装直播伴侣，详见安装。
• 如需让观众参与自定义奖品或奖券奖品的抽奖，或者让观众先下单再参与抽奖，确保您已将观看限制设置为自定义或 OAuth2.0。详见自定义登录和 OAuth 2.0。

主办方发送抽奖

步骤一：进入管理抽奖页面

• 控制台
  1. 登录企业直播控制台。
  2. 在直播列表中，单击进入直播间。
  3. 在页面右侧，单击互动工具菜单下的抽奖图标，并单击管理抽奖。
     

     说明

     • 如果页面未显示互动工具菜单，请先在菜单管理 > 互动工具启用互动工具菜单。
     • 建议打开互动工具菜单下的显示菜单栏开关，观众即可在观看页查看互动工具菜单。
• 网页直播开播页面
  1. 登录企业直播控制台。
  2. 选择网页直播作为开播方式并进入开播页面。具体操作，详见网页直播。
  3. 在页面右侧，单击互动工具菜单下的抽奖图标。
     
• 直播伴侣
  1. 打开并登录直播伴侣，进入指定直播间。详见登录。
  2. 在页面右侧，单击互动工具菜单下的抽奖图标。
     

步骤二：配置和发送抽奖

通过控制台、网页直播开播页面和直播伴侣配置及发送抽奖的方式基本相同，本步骤以控制台为例进行介绍。

1. 在抽奖对话框中，完成以下配置并单击保存。
   如非首次新建抽奖，需单击新建，再完成以下配置并单击保存。
   
   • 抽奖名称：输入抽奖名称。
   • 奖品配置：配置奖品信息。配置多个奖品时，观众将从配置的奖品中随机抽取中奖奖品。
     • 奖品名称：选择奖品库中已添加的奖品。支持通过奖品名称进行模糊搜索。您也可以单击下拉列表中的新建奖品或页面右上方的奖品库，在奖品库页面中添加奖品。关于如何在奖品库中添加奖品，详见奖品库。
     • 奖品数量：输入奖品数量。不可超过所选奖品的库存数量，且所有奖品的总数量最多为 10,000。
       奖品的库存数量在您的主账号及其子账号下的所有直播间中是共享的，即系统会根据所有直播间内抽奖设置的奖品个数计算库存应减少的数量。如果实际抽奖过程中奖品未发放完毕、抽奖被删除或关闭等，未发放完的奖品数量会返还回奖品库。
       您还可以拖拽调整奖品在观看页的展示顺序。

     说明

     复制直播间或通过直播模板创建直播间时，如果奖品个数大于当前奖品的库存数量，则该抽奖活动无法复制成功。关于如何复制直播间和通过直播模板创建直播间，详见复制直播间和直播模板。

   • 发送方式：选择定时发送或手动发送。如选择定时发送，需设置发送时间。
   • 开奖方式：选择自动开奖或手动开奖。
     • 自动开奖：倒计时结束后，系统会自动开奖。
     • 手动开奖：需单击开奖手动开奖。手动开奖后，观看页将延迟 5 秒开奖，以提高开奖的稳定性。
   • 开奖倒计时：设置自动开奖的倒计时。仅在选择自动开奖后才需要配置。
   • 参与人数：打开开关后，观看页可展示抽奖的实际参与人数。
   • 短信提醒：打开开关后，通过手机号登录直播间的观众在中奖后可收到中奖提醒短信，非手机号登录直播间的观众在中奖信息中填写手机号后也会收到中奖提醒短信。
   • 奖品数量：打开开关后，观看页可展示每个奖品的数量。
   • 参与条件：选择观众参与抽奖的条件。观众只有在同时满足所选条件后，才能参与抽奖。
     如果选择问卷、投票、签到、答题或简答作为参与条件，观众必须在本场直播期间完成相关活动，才能被视为有效参与。也就是说，直播间必须处于直播中状态，且活动必须在本场直播期间完成。
     全部问卷、投票、签到、答题或简答指从本场直播开始至参与本次抽奖期间发送的全部问卷、投票、签到、答题或简答。
     • 登录：观众必须登录直播间。该选项默认选中且不可更改。

       说明

       如果您在观看页管理 > 观看限制页面将评论限制设置为公开，则观众需通过手机号登录直播间。

     • 弹幕：观众需要发送指定弹幕口令。

       说明

       如需在直播画面中展示弹幕效果，请确保已在聊天互动菜单中打开弹幕开关。详见聊天互动。

     • 问卷：观众需要提交全部问卷或指定个数的问卷。
     • 投票：观众需要提交全部投票或指定个数的投票。

       说明

       网页直播开播页面和直播伴侣暂不支持发起投票。

     • 签到：观众需要提交全部签到或指定个数的签到。
     • 答题/简答：观众需要提交全部答题或简答、提交指定个数的答题或简答、答对全部答题或简答，或答对指定个数的答题或简答。
     • 下单：观众需要下单商品。
       完成以下配置：
       • 任务名称：观众参与抽奖时，展示的下单任务名称。
         
       • 订单查询URL：输入订单查询接口的请求地址。您必须按照规范自行开发接口，详见下单条件接口规范。观众参与抽奖时，企业直播会调用该接口，查询观众是否已完成抽奖的下单条件。

       说明

       直播伴侣 2.x 版本暂不支持下单条件。如需通过直播伴侣使用该功能，请联系企业直播技术支持获取直播伴侣 1.x 版本安装包。

   • 中奖条件：选择中奖条件。
     • 所有人：所有观众的中奖概率相同。
     • 未中奖观众优先：加大在当前直播间 30 天未中奖观众的中奖概率。
     • 重复中奖限制：设置同一观众在当前直播间 30 天内允许中奖（包括实时抽奖和红包）的次数。可以设置为 1~99 的正整数。默认为 1。

• 优先中奖名单：设置优先中奖的人员名单。
  当优先中奖名单中的人数大于奖品数量，则在优先中奖名单中随机抽奖。当奖品数量大于优先中奖名单中的人数时，则优先中奖名单中的观众全部中奖，多出的奖品在普通观众中随机抽奖。优先中奖名单中的用户无需亲自进入直播间或参与抽奖即可获得中奖资格，但只有在开奖前已登录直播间（仅输入昵称除外）且开奖时仍在直播间内，才会收到中奖弹窗通知，无论中奖与否。
  单击设置名单，在弹出的优先中奖名单对话框中，您可以完成以下操作。
  • 新增某个观众至优先中奖名单：单击新增观众，在弹出的对话框中输入用户昵称、手机号或用户 ID 并单击提交。

    说明

    如需添加海外地区和中国香港、中国澳门、中国台湾地区的手机号，请按照以下格式填写：“+” + 国际电话区号 + 手机号，例如填写 +1XXXXXXXXXX 添加北美手机号。

  • 批量导入观众至优先中奖名单：根据提示下载并编辑模板，单击批量导入上传已编辑的模板。您可以在批量导入弹窗中查看导入进度。如果有数据导入失败，可单击下载错误数据，查看导入失败的数据信息和原因。

    说明

    单次导入数据上限为 50,000 条。如果超出该上限，所有数据均会导入失败。

  • 删除优先中奖名单中的观众：删除一条或多条观众信息。
  • 一键清空优先中奖名单：单击一键清空，清空所有观众信息。
  • 在优先中奖名单中搜索指定观众：支持根据用户昵称和用户 ID 进行搜索。其中，用户昵称支持模糊搜索，英文区分大小写。

  说明

  • 当用户昵称、手机号或用户 ID 一致时，会被判定为同一观众。同一观众只会被添加一次。如果模板中存在相同的用户昵称、手机号或用户 ID，则仅第一条数据可成功导入。
  • 企业直播按照以下优先级顺序匹配名单中的观众：用户 ID、手机号、用户昵称。例如配置了用户 ID，则无论是否能匹配到观众，均不再按手机号或用户昵称进行匹配。因此，选择其中之一配置即可。
  • 如果您在优先中奖名单中仅配置了昵称，且该昵称在当前直播间的观众中并非唯一，则会从昵称相同的观众中随机抽奖。
• 中奖黑名单：设置无法中奖的人员名单。如果某观众被同时添加进优先中奖名单和中奖黑名单，则该观众无法中奖。单击设置名单，在弹出的中奖黑名单对话框中，完成相关操作。具体操作与优先中奖名单的操作类似，详见优先中奖名单。

  说明

  如果您在中奖黑名单中仅配置了昵称，且该昵称在当前直播间的观众中并非唯一，则昵称相同的所有观众均无法中奖。

• 中奖者详情：打开开关后，在中奖名单中，除中奖人昵称外，还可以展示其他信息，例如中奖人所在的地区。
  您可以通过以下方式实现该功能：
  • 将观看限制设置为自定义，并通过 CustomComment 参数配置中奖者信息。详见自定义登录。
  • 集成 Web 观播 SDK，且 SDK 的鉴权模式为自定义模式（即 mode = 2），通过 GetSDKTokenAPI 接口的 CustomComment 参数配置中奖者信息。
• 抽奖主题：选择抽奖相关弹窗的皮肤主题和开奖动画。默认为黑白皮肤、无开奖动画。选择指定开奖动画后，观看页将在开奖后展示所选动画，以增加抽奖活动的趣味性。

阅读抽奖活动规则和承诺函后，勾选相应复选框。
2. （可选）如果存在多个未发送的抽奖，在左侧列表选择未发送的抽奖。
3. 如果是手动发送的抽奖，单击添加至发送区，再在互动工具菜单下单击发送将抽奖发送至观看页。

如果是定时发送的抽奖，关闭当前对话框即可。抽奖会在设置的发送时间自动发送至观看页。您也可以单击添加至发送区，将抽奖提前发送至观看页。
您也可以单击互动工具菜单下的抽奖图标，再在弹出的对话框中选择未发送的抽奖，单击发送将抽奖发送至观看页。该方法仅适用于控制台。

3. （可选）您可以预览、编辑、删除未发送的抽奖，以及预览和删除已发送的抽奖。
4. （可选）在互动工具菜单，您可以完成以下操作。
   
   • 如选择手动开奖，单击开奖手动开奖。如选择自动开奖，等待倒计时结束即可自动开奖。
   • 单击撤回图标撤回已发送的抽奖。
   • 查看已参与抽奖的人数。
   • 开奖后，单击查看中奖结果，查看中奖名单。
5. （可选）在数据统计 > 抽奖数据 > 实时抽奖页面，查看已发送抽奖的数据。该步骤仅适用于控制台。详见抽奖数据。

下单条件接口规范

企业直播支持与您的系统对接，以便在观众参与抽奖时，查询观众是否已完成抽奖的下单条件。请按照以下规范自行开发商品下单查询接口。
如果在对接过程中遇到问题，请联系企业直播技术支持。

• 接口说明：企业直播调用该接口，查询观众是否已完成抽奖的下单条件。

• 响应时间要求：企业直播调用该接口时，如果在 3 秒内未能收到您的服务器的响应，即认为本次调用失败。

• 限流策略建议：为防止在高峰期用户参与抽奖时，企业直播调用您的接口频率（QPS）过高导致您的服务不稳定，请联系企业直播技术支持，设置合适的限流策略。这样可以有效保证您的服务稳定运行，避免因超出最大处理能力而引发的问题。

• 请求方式：POST

• 请求参数

  Body 参数

  参数	类型	示例值	描述
  AccountId	Long	200****914	账号 ID。
  ActivityId	Long	1825****31427235	直播间 ID。
  UserId	Long	1767****47763719	观众在企业直播的用户 ID。
  ExternalId	String	28189****987192	关联用户 ID，即观众在您自有系统的唯一标识。 观众通过不同方式登录直播间，关联用户 ID 的取值如下所示。 自定义：自定义登录时通过 UserId 传入的值。详见自定义登录。 OAuth 2.0：您自有系统中用户 ID 对应的字段。 说明 如果您集成了观播 SDK，且 SDK 的鉴权模式为自定义模式，关联用户 ID 的取值为调用 GetSDKTokenAPI 接口时传入的 UserIdStr（观众 ID）。
  UserName	String	观众 A	观众昵称。
  Timestamp	Long	1741319677	接口调用时的系统时间。Unix 时间戳，单位为秒。
  AwardId	String	162****438	抽奖 ID。
  AwardName	String	3	抽奖名称。
  AwarItemConfigs	Array of AwardItemConfig	-	新建抽奖时添加的奖品列表。 说明 奖品配置在添加到抽奖时已固定，即使后续在奖品库中更新了奖品配置，该参数传入的奖品配置仍为新建抽奖添加奖品时的配置。
  Sign	String	858d760ed64e4e****aa002c76acc2b5	校验签名。 完成以下步骤，计算校验签名。 按照 AccountSecret、AccountId、ActivityId、AwardId、AwardName、ExternalId、Timestamp、UserId、UserName 的顺序，拼接对应的参数值。 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。 说明 请联系技术支持获取鉴权 AccountSecret。

AwardItemConfig

返回参数

请求示例

POST https://test.com/post
            header Content-Type: application/json; charset=utf-8
            body {
                    "AccountId": 200****914,
                    "ActivityId": 1825****31427235,
                    "UserId": 1767****47763719,
                    "ExternalId": "28189****987192",
                    "UserName": "观众 A",
                    "Timestamp": 1741319677,
                    "AwardId": "162****438",
                    "AwardName": "3",
                    "AwardItemConfigs": [
                        {
                            "AwardItemId": "99576",
                            "AwardItemName": "奖品 A",
                            "AwardItemType": "1",
                            "DeliveryMethod": "",
                            "AwardItemNum": ""
                        }
                    ],
                    "Sign": "858d760ed64e4e****aa002c76acc2b5"
                }

返回示例

{
    "Status": 1
}

观众参与抽奖

1. 观众必须先登录直播间才能参与抽奖。

   说明

   如果您在观看页管理 > 观看限制页面将评论限制设置为公开，则观众需通过手机号登录直播间。

2. 抽奖推送至观看页后，参与抽奖对话框自动弹出。观众单击立即参与，参与抽奖。如果抽奖设置了参与条件，则观众必须先完成指定条件才能参与抽奖。
   
3. 在抽奖倒计时结束或手动开奖后，中奖结果弹窗会自动弹出。
   中奖观众可根据奖品类型，完成相关操作。
   • 实物奖品：如果奖品需要中奖人填写收件人姓名、手机号或收货地址，观众需填写相关信息后单击提交中奖信息。
     
     已提交的信息支持修改，以最后一次提交内容为准。
     
   • 虚拟奖品：如果奖品需要中奖人填写手机号，观众需填写手机号后单击提交中奖信息。
     
     已提交的信息支持修改，以最后一次提交内容为准。
     
   • 奖券奖品：单击前往领取奖品，领取相应的奖券。
     
   • 自定义奖品：您可自行实现向中奖观众发送短信或站内信。详见自定义奖品。
     
4. 观众可在中奖结果弹窗中单击查看中奖名单，查看本次抽奖的中奖名单。

   说明

   中奖名单中最多支持展示 200 位中奖观众。

关闭参与抽奖对话框或中奖结果弹窗后，观众也可以单击抽奖图标或在互动工具菜单下单击立即参与或中奖结果，手动打开参与抽奖对话框或中奖结果弹窗。