You need to enable JavaScript to run this app.
导航
商品脚本
最近更新时间:2025.04.16 11:15:17首次发布时间:2025.04.16 11:00:01
我的收藏
有用
有用
无用
无用

配置录播直播视频的商品脚本后,当录播直播视频播放到指定时间节点时,将按照脚本中配置的上下架时间、讲解起止时间和商品信息展示商品,从而降低运营人力成本、提高商品曝光率、丰富直播带货场景。

注意

由于受到推拉流延迟的影响,商品上下架和讲解起止时间存在一定误差。

观看页效果演示

Image

前提条件
  • 您已开通专业版、旗舰版或定制版套餐。详见计费说明
  • 确保您拥有火山引擎主账号或具备以下权限的子账号用于完成相关操作。有关如何添加子账号,详见子账号管理
    • 观看页管理 > 基础信息 > 可编辑权限:用于开启商品脚本录制。
    • 回放管理 > 仅查看可编辑权限:用于查看直播回放的视频 ID。
    • 视频库 > 可编辑权限:用于在视频库页面配置视频的商品脚本。
    • 直播暂存 > 可编辑权限:用于在直播暂存页面配置视频的商品脚本并将视频转入视频库。
    • 直播控制 > 可编辑权限:用于添加录播直播视频、配置视频的商品脚本,并开始录播直播。

注意事项

仅支持在第一个直播频道内,按照商品脚本展示商品。更多有关直播频道的内容,详见直播频道管理

操作步骤

您可以通过以下方案,配置录播直播视频的商品脚本。开始录播直播后,当录播直播视频播放到指定时间节点时,将按照脚本中配置的上下架时间、讲解起止时间和商品信息展示商品。

  • 方案一:先配置视频的商品脚本,再添加视频作为录播直播视频。

    说明

    如果您在添加视频后,在视频库中更新了视频的商品脚本配置,则更新的配置不会自动同步至录播直播视频。如需同步更新,需重新将视频添加为录播直播视频。

  • 方案二:先添加录播直播视频,再配置该视频的商品脚本。

注意

如果录播直播视频会循环播放多次,则仅会在第一轮播放时,根据商品脚本展示商品。

方案一:先配置商品脚本,再添加录播直播视频

(可选)步骤一:开启商品脚本录制

在直播开始前,完成以下步骤,开启商品脚本录制,将直播期间的商品信息作为脚本录制到回放视频中。适用于需要循环利用商品信息的场景,可有效节省运营人力成本。

  1. 登录企业直播控制台

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

  3. 在左侧导航栏,选择观看页管理 > 基础信息

  4. 互动脚本录制字段中,选择商品并单击保存
    Image

  5. 在左侧导航栏,选择菜单管理 > 商品卡片

  6. 打开启用开关,按需添加商品并单击保存。有关如何添加商品,详见步骤一:配置商品卡片菜单
    Image

  7. 以任一开播方式开始直播。

  8. 如需录制商品的上下架时间和讲解起始时间,可在直播控制页面的商品卡片菜单下,完成以下操作:
    Image

    • 上下架时间:如果您需要在指定时间上架或下架某商品,可单击商品右侧的上架下架。商品下架后,观看页将不再显示该商品。
    • 讲解起始时间:在讲解期间,商品会在商品卡片菜单内高优展示,并以浮窗形式展示在观看页。
      当您开始讲解某商品时,单击商品讲解。结束讲解时,单击取消讲解即可。您也可以单击其他商品右侧的商品讲解,开始讲解新商品并结束当前商品的讲解。

    直播结束并生成直播回放后,商品的上下架时间、讲解起止时间和商品信息即可同步至该直播回放视频的商品脚本中。

    说明

    以下内容不会同步至直播回放视频的商品脚本中:

    • 直播期间从未上架的商品信息
    • 商品的热卖提醒、库存提醒及下单消息情况
  9. (可选)查看直播回放的商品脚本。

    1. 在左侧导航栏,选择回放管理
    2. 单击复制图标,复制直播回放的视频 ID。
      Image
    3. 媒资库 > 视频管理 > 直播暂存页面,通过复制的视频 ID 找到该直播回放视频。
      Image
    4. 单击操作列下的更多(...)图标,选择互动脚本
      Image
    5. 查看录制的商品脚本。有关如何更新脚本内容,详见步骤二:在直播暂存或视频库页面,配置视频的商品脚本
      Image

步骤二:在直播暂存或视频库页面,配置视频的商品脚本

  1. 登录企业直播控制台
  2. 在顶部导航栏,单击媒资库
  3. 在左侧导航栏,选择视频管理 > 直播暂存视频库
  4. 单击操作列下的互动脚本
    • 直播暂存
      Image
    • 视频库
      Image
  5. 商品页签下,完成以下操作并单击保存
    • 单击全局设置,根据界面提示完成配置并单击确定
      Image

      配置项

      说明

      直达链接

      适用于观众在不同平台观看直播,且不同平台具备不同商品链接的场景。该功能仅移动端支持。

      1. 打开直达链接开关。
      2. 输入环境名称和对应的环境 UA(User Agent)。例如环境为微信,对应环境 UA 为 MicroMessenger。

        说明

        只要平台的环境 UA 包含了配置的 UA 地址,即可成功匹配。例如输入 Mozilla 作为环境UA 字段的值,只要观众在环境 UA 包含 Mozilla 字段的平台点击商品卡片,即可在该平台内实现直达链接的跳转。

      3. 在配置商品脚本信息时,填写不同环境对应的直达链接。

      观众在环境 UA 匹配成功的移动端平台点击商品卡片时,即可跳转至当前环境对应的直达链接。如果观众在与环境 UA 不匹配的平台点击商品卡片,则会跳转至该商品卡片的跳转链接。

      微信小程序跳转

      适用于具有微信小程序商品链接的场景。该功能仅移动端支持。

      1. 打开微信小程序跳转开关。
      2. 输入指定微信小程序的原始 ID。
        完成以下步骤,获取原始 ID。
        1. 使用微信小程序账号登录微信公众平台
        2. 在左侧导航栏,选择设置
        3. 基本设置页签下查看 App ID。
      3. 在配置商品脚本信息时,填写指定的微信小程序链接。

      观众在移动端微信环境点击商品卡片时,即可跳转至指定的微信小程序。如果观众在其他环境点击商品卡片,则会跳转至该商品卡片的跳转链接。

      显示菜单栏

      选择商品卡片在观看页的入口。开关默认打开。

      • 打开开关:观看页支持展示商品卡片菜单和浮窗商品卡片。移动端观看页可同步展示购物车图标。

        说明

        • 移动端竖屏直播间仅支持展示购物车图标和浮窗商品卡片。
        • 如需在移动端横屏直播间展示购物车图标,请确保已启用聊天互动菜单。有关如何启用聊天互动菜单,详见聊天互动
        • 商品卡片菜单
          Image
        • 浮窗商品卡片
          Image
        • 购物车图标
          Image
      • 关闭开关:观看页仅支持展示浮窗商品卡片。

      卡片位置

      选择浮窗商品卡片在 PC 端观看页的展示位置。默认展示在播放器的右上方。
      Image

      交互展示

      选择商品详情页的展示方式。该配置仅对直达链接和跳转链接生效。

      • 新页面展示内容:观众点击商品卡片后,页面自动跳转至新的浏览器标签页展示商品详情页。观众无法同时观看直播与商品详情页。
      • 直播页浮层展示内容:观众在移动端点击商品卡片后,在当前观看页以浮层形式展示商品详情页。观众可以在观看直播的同时查看商品详情页,实现边看边买。
    • 通过模板批量添加商品脚本,或手动添加商品脚本。

      • 批量添加
        Image
        1. 单击模板下载
        2. 根据提示编辑模板内容。
        3. 单击批量导入,上传编辑后的模板。

        注意

        如需添加商品图等图片,则必须通过手动添加脚本的方式进行配置。

      • 手动添加
        1. 单击添加商品脚本

        2. 单击商品列下的空白商品图或编辑,进入编辑商品卡片页面。
          Image

        3. 根据界面提示完成配置并单击保存
          Image

          配置项

          描述

          商品图

          展示在商品卡片左侧。
          Image

          活动标签

          展示在商品名称左侧。您可以选择企业直播提供的活动标签,或选择自定义并上传不超过 2 MB 的 PNG 图片作为活动标签。该功能目前仅移动端支持。
          Image

          商品名称

          商品的名称。
          Image

          商品介绍

          商品的简短文字介绍。
          Image

          售卖价

          商品的当前价格。
          Image

          参考价

          商品原价。
          Image

          卖点标签

          展示在商品介绍下方。最多支持 3 个卖点,卖点间以分号(;)相隔。每个卖点最多支持 20 个字符,但建议不要超过 6 个字符。该功能目前仅移动端支持。
          Image

          跳转图

          展示在商品卡片右下方。不配置,则展示默认的跳转图。
          Image

          直达链接

          该字段仅在您于全局设置页面开启直达链接功能后显示。
          当观众在环境 UA 匹配成功的移动端平台上点击商品卡片时,即可跳转至该链接。

          说明

          如果您既配置了微信环境的直达链接,又配置了微信小程序链接,则观众在移动端微信环境点击商品卡片时,会跳转至指定的微信小程序。

          微信小程序链接

          该字段仅在您于全局设置页面开启微信小程序跳转功能后显示。
          当观众在移动端微信环境点击商品卡片时,即可跳转至该链接对应的微信小程序。有关如何获取微信小程序链接,详见如何获取微信小程序链接?

          说明

          如果您既配置了微信环境的直达链接,又配置了微信小程序链接,则观众在移动端微信环境点击商品卡片时,会跳转至指定的微信小程序。

          跳转链接

          商品链接。观众点击商品卡片后,如果无法跳转至直达链接或微信小程序,则会跳转至该链接,打开商品详情页。

          说明

          当满足以下任一条件时,观众点击商品卡片后,跳转链接会自动拼接 ProductLinkExternalUserId=ID,传入观众的第三方平台唯一标识。您可通过该 ID,同步第三方平台与商城的登录状态。

          • 将观看限制或评论限制设置为自定义,且观众已完成自定义登录。拼接的 ProductLinkExternalUserId 取值为自定义登录时传入的 UserId。详见自定义登录
          • 以自定义模式(mode = 2)集成 Web 观播 SDK,且观众已完成自定义登录。拼接的 ProductLinkExternalUserId 取值为调用 GetSDKTokenAPI 接口时传入的 UserIdStr
        4. 默认在录播直播视频播放期间,商品卡片会一直展示在商品列表中。如果某商品仅需在特定时间段内展示,可为商品添加上下架时间。支持添加多个时间段。
          将下架时间设置为空值,商品卡片即可一直展示在商品列表中。为保证商品能够正常上架,请确保上架时间小于视频总时长。
          Image

        5. (可选)您可以设置商品的讲解起止时间,在讲解期间,商品会在商品卡片菜单内高优展示,并以浮窗形式展示在观看页。支持添加多个时间段。
          为保证商品能够正常讲解,请确保讲解起始时间小于视频总时长。同一时间仅有一个商品可以处于讲解中状态,因此请确保商品的讲解起止时间不与其他商品重合。
          Image
          您也可以先在页面右侧调整讲解起止时间,再单击添加商品脚本
          Image

    • 通过变更序号,调整商品在商品列表中的展示顺序。
      Image

    • 如需在多个商品卡片菜单下展示商品,单击 +,添加商品卡片菜单,并按需修改菜单名称、调整菜单展示顺序。脚本中最多支持添加 5 个商品卡片菜单。
      Image

  6. (可选)单击导出,导出当前脚本中的所有商品信息。
  7. 如果您是在直播暂存页面配置的商品脚本,选择该视频,并单击转入视频库。只有转入视频库的视频可添加为录播直播视频。
    Image

步骤三:添加视频作为录播直播视频

  1. 在顶部导航栏,单击我的直播
  2. 在直播列表中,单击进入直播间。
  3. 单击开播方式页签下的录播直播,并单击编辑录播直播
    Image
  4. 编辑录播直播对话框中,单击从视频库中选择
    Image
  5. 选择视频对话框中,选择上一步中配置了商品脚本的视频,并单击确定
  6. 互动脚本列,选择商品
    Image
  7. (可选)如需修改商品脚本,可单击编辑脚本。完成修改后,单击保存。如需将修改同步至视频库,可单击保存并同步至视频库,后续将视频库中的该视频添加为录播直播视频时,商品脚本中即可包含本次修改的配置。
  8. 完成其他录播直播相关配置,并单击确定。更多有关录播直播配置的内容,详见录播直播
  9. 单击开始录播直播
    Image

在观看页,当录播直播视频播放到指定时间节点时,会按照脚本中配置的上下架时间、讲解起止时间和商品信息展示商品。

方案二:先添加录播直播视频,再配置脚本

  1. 登录企业直播控制台
  2. 在直播列表中,单击进入直播间。
  3. 单击开播方式页签下的录播直播,并单击编辑录播直播
    Image
  4. 以任一方式添加视频。
  5. 互动脚本列,选择商品并单击编辑脚本
    Image
  6. 在弹出页面的商品页签下,完成以下操作并单击保存
    • 单击全局设置,根据界面提示完成配置并单击确定
      Image

      配置项

      说明

      直达链接

      适用于观众在不同平台观看直播,且不同平台具备不同商品链接的场景。该功能仅移动端支持。

      1. 打开直达链接开关。
      2. 输入环境名称和对应的环境 UA(User Agent)。例如环境为微信,对应环境 UA 为 MicroMessenger。

        说明

        只要平台的环境 UA 包含了配置的 UA 地址,即可成功匹配。例如输入 Mozilla 作为环境UA 字段的值,只要观众在环境 UA 包含 Mozilla 字段的平台点击商品卡片,即可在该平台内实现直达链接的跳转。

      3. 在配置商品脚本信息时,填写不同环境对应的直达链接。

      观众在环境 UA 匹配成功的移动端平台点击商品卡片时,即可跳转至当前环境对应的直达链接。如果观众在与环境 UA 不匹配的平台点击商品卡片,则会跳转至该商品卡片的跳转链接。

      微信小程序跳转

      适用于具有微信小程序商品链接的场景。该功能仅移动端支持。

      1. 打开微信小程序跳转开关。
      2. 输入指定微信小程序的原始 ID。
        完成以下步骤,获取原始 ID。
        1. 使用微信小程序账号登录微信公众平台
        2. 在左侧导航栏,选择设置
        3. 基本设置页签下查看 App ID。
      3. 在配置商品脚本信息时,填写指定的微信小程序链接。

      观众在移动端微信环境点击商品卡片时,即可跳转至指定的微信小程序。如果观众在其他环境点击商品卡片,则会跳转至该商品卡片的跳转链接。

      显示菜单栏

      选择商品卡片在观看页的入口。开关默认打开。

      • 打开开关:观看页支持展示商品卡片菜单和浮窗商品卡片。移动端观看页可同步展示购物车图标。

        说明

        • 移动端竖屏直播间仅支持展示购物车图标和浮窗商品卡片。
        • 如需在移动端横屏直播间展示购物车图标,请确保已启用聊天互动菜单。有关如何启用聊天互动菜单,详见聊天互动
        • 商品卡片菜单
          Image
        • 浮窗商品卡片
          Image
        • 购物车图标
          Image
      • 关闭开关:观看页仅支持展示浮窗商品卡片。

      卡片位置

      选择浮窗商品卡片在 PC 端观看页的展示位置。默认展示在播放器的右上方。
      Image

      交互展示

      选择商品详情页的展示方式。该配置仅对直达链接和跳转链接生效。

      • 新页面展示内容:观众点击商品卡片后,页面自动跳转至新的浏览器标签页展示商品详情页。观众无法同时观看直播与商品详情页。
      • 直播页浮层展示内容:观众在移动端点击商品卡片后,在当前观看页以浮层形式展示商品详情页。观众可以在观看直播的同时查看商品详情页,实现边看边买。
    • 通过模板批量添加商品脚本,或手动添加商品脚本。

      • 批量添加
        Image
        1. 单击模板下载
        2. 根据提示编辑模板内容。
        3. 单击批量导入,上传编辑后的模板。

        注意

        如需添加商品图等图片,则必须通过手动添加脚本的方式进行配置。

      • 手动添加
        1. 单击添加商品脚本

        2. 单击商品列下的空白商品图或编辑,进入编辑商品卡片页面。
          Image

        3. 根据界面提示完成配置并单击保存
          Image

          配置项

          描述

          商品图

          展示在商品卡片左侧。
          Image

          活动标签

          展示在商品名称左侧。您可以选择企业直播提供的活动标签,或选择自定义并上传不超过 2 MB 的 PNG 图片作为活动标签。该功能目前仅移动端支持。
          Image

          商品名称

          商品的名称。
          Image

          商品介绍

          商品的简短文字介绍。
          Image

          售卖价

          商品的当前价格。
          Image

          参考价

          商品原价。
          Image

          卖点标签

          展示在商品介绍下方。最多支持 3 个卖点,卖点间以分号(;)相隔。每个卖点最多支持 20 个字符,但建议不要超过 6 个字符。该功能目前仅移动端支持。
          Image

          跳转图

          展示在商品卡片右下方。不配置,则展示默认的跳转图。
          Image

          直达链接

          该字段仅在您于全局设置页面开启直达链接功能后显示。
          当观众在环境 UA 匹配成功的移动端平台上点击商品卡片时,即可跳转至该链接。

          说明

          如果您既配置了微信环境的直达链接,又配置了微信小程序链接,则观众在移动端微信环境点击商品卡片时,会跳转至指定的微信小程序。

          微信小程序链接

          该字段仅在您于全局设置页面开启微信小程序跳转功能后显示。
          当观众在移动端微信环境点击商品卡片时,即可跳转至该链接对应的微信小程序。有关如何获取微信小程序链接,详见如何获取微信小程序链接?

          说明

          如果您既配置了微信环境的直达链接,又配置了微信小程序链接,则观众在移动端微信环境点击商品卡片时,会跳转至指定的微信小程序。

          跳转链接

          商品链接。观众点击商品卡片后,如果无法跳转至直达链接或微信小程序,则会跳转至该链接,打开商品详情页。

          说明

          当满足以下任一条件时,观众点击商品卡片后,跳转链接会自动拼接 ProductLinkExternalUserId=ID,传入观众的第三方平台唯一标识。您可通过该 ID,同步第三方平台与商城的登录状态。

          • 将观看限制或评论限制设置为自定义,且观众已完成自定义登录。拼接的 ProductLinkExternalUserId 取值为自定义登录时传入的 UserId。详见自定义登录
          • 以自定义模式(mode = 2)集成 Web 观播 SDK,且观众已完成自定义登录。拼接的 ProductLinkExternalUserId 取值为调用 GetSDKTokenAPI 接口时传入的 UserIdStr
        4. 默认在录播直播视频播放期间,商品卡片会一直展示在商品列表中。如果某商品仅需在特定时间段内展示,可为商品添加上下架时间。支持添加多个时间段。
          将下架时间设置为空值,商品卡片即可一直展示在商品列表中。为保证商品能够正常上架,请确保上架时间小于视频总时长。
          Image

        5. (可选)您可以设置商品的讲解起止时间,在讲解期间,商品会在商品卡片菜单内高优展示,并以浮窗形式展示在观看页。支持添加多个时间段。
          为保证商品能够正常讲解,请确保讲解起始时间小于视频总时长。同一时间仅有一个商品可以处于讲解中状态,因此请确保商品的讲解起止时间不与其他商品重合。
          Image
          您也可以先在页面右侧调整讲解起止时间,再单击添加商品脚本
          Image

    • 通过变更序号,调整商品在商品列表中的展示顺序。
      Image

    • 如需在多个商品卡片菜单下展示商品,单击 +,添加商品卡片菜单,并按需修改菜单名称、调整菜单展示顺序。脚本中最多支持添加 5 个商品卡片菜单。
      Image

  7. (可选)单击导出,导出当前脚本中的所有商品信息。
  8. (可选)单击保存并同步至视频库,将脚本配置同步至视频库。后续将视频库中的该视频添加为录播直播视频时,商品脚本中即可包含本次修改的配置。
  9. 编辑录播直播弹窗中,完成其他配置并单击确定。更多有关录播直播配置的内容,详见录播直播
    Image
  10. 单击开始录播直播
    Image

在观看页,当录播直播视频播放到指定时间节点时,会按照脚本中配置的上下架时间、讲解起止时间和商品信息展示商品。