商务产品

您可以在 Roblox 游戏中目录和销售真实世界的产品，或称为 商务产品。用户可以在您的游戏中购买这些产品，并且如果符合条件，您可以提供作为捆绑福利的数字激励。

要创建和管理目录项目及商务产品，您必须满足 商务资格。要将商务产品添加到您的游戏中：

1. 从 Shopify 导入真实世界目录项目。
2. 在创作者中心创建商务产品。
3. 在您的游戏中实现购买提示。

资格

以下资格要求适用于有兴趣实现商务产品的 创作者、托管商务功能的 游戏 和可以购买商务产品的 用户。捆绑数字物品 也需要额外的资格要求。

这些要求可能会有所更改。

创作者

合格的创作者可以将商务产品添加到他们的游戏中。要符合资格，创作者必须满足并保持以下条件：

• 年满18岁。
• 拥有经过身份证明和电子邮件验证的账户。
• 启用双重验证。
• 是与链接商店相关的 Shopify 注册帐户持有人。

  • 或者，您必须获得相关注册帐户持有人的书面许可才能链接 Shopify 商店。
• 提交了 商业信息。您可以通过以下方式访问此提交表格：

  • 商务资格页面 — 第一次访问商务页面时，会出现资格表单。
  • 创作者仪表板 — 在 账户信息 中，您必须填写 核心账户 和 法律 标签。若出现，请跳过核心账户下的扩展服务部分。
  • 如果您代表某个团体提交商业信息，创作者必须启用 配置和消费团体收入。
• 如果代表团体访问商务设置，您的角色必须启用 创建和编辑社区体验。
• 始终与 Roblox 的 社区规范 保持良好状态。

游戏

创作者必须确保托管商务功能的游戏满足以下要求：

• 游戏必须是公开的。
• 游戏在完成内容成熟度问卷后已获得 内容成熟度标签。
• 游戏始终符合 Roblox 的 社区规范、广告标准 和 商务标准。

用户

目前，仅限美国用户可以购买商务产品。参与用户还必须满足以下要求：

• 年满13岁，德克萨斯州除外。
• 德克萨斯州的用户必须年满18岁。

您可以通过使用 PolicyService 验证用户的资格，以返回有关每个用户的政策信息。

数字福利

某些创作者可能符合条件，可以将数字福利（如头像物品或开发者物品）与其商务产品捆绑在一起，前提是他们至少符合以下两个要求之一：

• 托管商店的游戏满足以下条件：

  • 在过去的90天内，平均每天活跃用户超过100,000。
  • 在过去的90天内，平均月收入超过1,000,000 Robux。
  • 在获得捆绑批准后的三个月内售出至少一个捆绑。
• 或与 Roblox 签订书面协议，承诺在一年内的广告支出至少为50,000美元。

捆绑数字福利

如果您有资格将数字福利与商务产品捆绑在一起，则每个数字福利必须：

• 符合 Roblox 的 社区规范 和 广告标准，作为独立物品以及在捆绑背景下的产品和捆绑数字福利的组合。
• 不是在列出捆绑之前曾经可供购买的物品，或单独以 Robux 可供购买的物品。
• 不是 Robux 或游戏内货币。
• 在 Roblox 的产品列表中披露足够详细的信息，不应给买家造成不确定性。
• 不是随机物品，不得需要基于几率的机制来接收基础物品。
• 在捆绑付款完成后，不要求额外步骤获取。

导入目录项目

在 创作者仪表板 中，您可以将您的 Roblox 账户连接到 Shopify 商店，并将目录项目链接到您的游戏。您必须添加打算导入到 Roblox 的单个产品。

从 Shopify 导入目录项目

1. 在 创作者仪表板 中导航到您的游戏，并选择 货币化产品 ⟩ 商务。
2. 点击 前往导入的目录 ⟩ 开始导入。
3. 点击 连接。
4. 在您的商店上安装 Roblox 销售渠道。
5. 连接您的 Roblox 账户。点击 下一步。

   1. 连接您的 Roblox 账户后，您可以选择性地连接一个 Roblox 群组，以授予所有群组成员访问您的导入的目录项目的权限。此设置可以在 Roblox 销售渠道的 账户 下随时更新。
6. 点击 添加产品，选择您将导入到 Roblox 的项目。
7. 点击 完成，并等待项目与 Roblox 同步。您可以在商务页的导入目录标签中查看您的导入目录项目。

移除目录项目

在商务页面中，您可以通过点击项目旁边的 删除 或 移除 按钮，移除您在目录标签中导入的任何目录项。

当您删除一项物品时，所有包含该物品的商务产品将自动被删除。要再次出售该商务产品，您必须重新导入该物品并重新创建产品。

修改目录项目

当您在 Shopify 上更改目录项目的价格时，所有相关的商务产品捆绑将被下架并重新提交以处理捆绑费用。

当您更新 Shopify 项目的内容，例如名称、描述或展示图像时，所有相关的产品不会下架，但它们将重新提交进行审核。每个产品在 Roblox 上的产品列表将继续显示先前批准的内容，直到新内容获得审核批准。有关这些 Shopify 属性如何显示和管理的更多信息，请参见 产品详细页面。

管理商务产品

将目录项目导入到游戏的商务页面后，您可以开始创建商务产品。

创建

一旦您导入了目录项目，就可以创建商务产品。商务产品可以是单独的目录项目，或与数字福利捆绑的目录项目。

每个游戏最多可以创建 500 个产品。

要创建商务产品：

1. 在创作者仪表板中导航到您的游戏，并选择 货币化产品 ⟩ 商务。
2. 点击 开始创建 或 创建产品。
3. 选择您要包含在商务产品中的导入目录项目，并点击 下一步。

   1. 如果您没有看到 下一步 按钮，您的游戏不符合创建含数字福利捆绑的资格。请跳到第 4 步。
   2. 此时，您的商务产品已保存为草稿。如果您退出此页面并希望返回，可以在 创作 标签下的 草稿 中找到草稿商务产品。

(可选) 捆绑数字福利

如果您 有资格将商务产品与数字福利捆绑，可以将数字福利捆绑到商务产品中。捆绑产品在审核后需要支付捆绑费用。要捆绑数字福利：

1. 点击 添加福利。
2. 选择 虚拟福利类型：
3. 头像物品：要作为捆绑的一部分，头像物品必须之前未曾出售。您必须拥有该物品或属于拥有该物品的群组。
4. 通过选择 头像物品类型 并使用下拉菜单选择一个头像物品。点击 保存。
5. 开发者产品：要作为捆绑的一部分，开发者产品必须被游戏拥有，不能之前有出售，并且不得有价格。
6. 选择现有的 开发者产品，或通过点击 创建新建、填写开发者产品信息并点击 创建 来创建一个新的捆绑。点击 保存。

   1. 同一游戏中的开发者产品名称必须是唯一的。
   2. 开发者产品在您提交产品进行审查时创建。为了能够在多个捆绑中重用开发者产品，请提交一个产品（这将创建开发者产品），然后在随后的捆绑中选择该福利。

7. 输入目录项目的 库存类型。

   1. 固定数量：商务物品数量固定。在 数量 下输入数量。
   2. 按需商品：商务物品按需创建。
   3. 预订：商务物品为预订商品。

4. 仔细检查产品的详细信息并点击 预览，以预览每个产品的产品列表。有关此页面包含内容和填写方式的详细信息，请参见 自定义产品详细页面。点击 提交审核。
5. 您新创建的商务产品的状态为 待处理，因为该产品正在等待审核和可能的捆绑费用处理。您可以将鼠标悬停在信息图标上以查看哪些任务待办。

   1. 审核

      1. 如果发现您的商务产品违反了 Roblox 社区标准，您会看到商务产品的 状态 改为 审核中。
      2. 将鼠标悬停在信息图标上并点击 查看违规 以查看违规信息并提交上诉，或者创建符合 Roblox 社区标准的新商务产品。您必须是与 Shopify 商店关联的账户的用户，或是群组拥有商店的群组拥有者，才能查看违规信息。
   2. 捆绑费用（如果适用）

      1. 一旦捆绑费用可用于捆绑商务产品，请导航到商务产品以查看其在 捆绑费用 下的状态。
      2. 要接受，请选择产品并点击 接受捆绑费用，或点击捆绑费用旁边的三个点并点击 接受。
6. 一旦这些任务获批，您的商务产品 状态 将变为 已批准，并准备通过 CommerceService 集成到您的游戏中。

获取 ID

您需要商务产品的产品 ID 才能在游戏中出售它。

获取产品 ID 的方法：

1. 将鼠标悬停在 产品 ID 上。

2. 单击 复制 ID 将其复制到剪贴板。

   

上架销售

商务产品必须可供销售，才能在游戏中被购买。

两项相同的目录项目不能同时上架销售。您必须将捆绑包含目录项目的产品下架，才能将另一个相同目录项目上架销售。每个游戏最多可以同时上架 100 个产品。

要更改产品的销售状态：

1. 在商务页面中，导航到您打算销售的产品。

2. 点击 上架销售 或 下架 对应的产品。

   

删除

要删除商务产品：

1. 将鼠标悬停在产品上。
2. 点击 删除 以删除该产品。

实现购买

在您的游戏中，使用以下 CommerceService 函数实现商务产品购买：

• CommerceService:PromptCommerceProductPurchase(): 提示特定用户购买提供的 commerceProductId 的商务产品。它将打开一个网页视图，引导用户完成购买流程。
• CommerceService:PromptCommerceProductPurchaseFinished(): 使用此信号检测用户完成购买流程并关闭网页视图，以继续游戏内的玩法。

  • 此信号不表示购买成功，仅表示提示已关闭。
  • 虽然是可选的，但建议使用此信号在 Android 上重新定位您的用户，因为商务购买流程会强制他们进入纵向模式。

授予数字福利

在 创建商务产品 时，您可以选择将目录项目与数字福利捆绑。

头像物品

如果头像物品与商务物品捆绑在一起，用户成功购买商务产品后，Roblox 将自动授予链接的头像物品。

如果 Roblox 检测到物理项的取消或退款，Roblox 将自动从账户中撤销头像物品。

如果头像物品被审核，该物品的任何与之相关的商务产品状态将变为审核中，该产品将下架。7 天后，Roblox 将自动从所有购买了这些产品的账户中撤销头像物品。在成功上诉后，将重新授予头像物品。

开发者产品

用户成功购买商务产品后，Roblox 生成开发者产品收据并将其发送到用户所在的服务器。请遵循现有的 MarketplaceService.ProcessReceipt 流程处理开发者产品授予。

如果物理项的退款或取消发生，您可能希望撤销相关的游戏内物品或福利。Roblox 不会自动撤销授予用户的作为数字福利的开发者产品。

Roblox 提供了商务事件的 webhook 集成。当订单被支付、取消或退款时，Roblox 将发送 webhook 消息，包含最新的订单状态和订单详情。开发者可以根据需要使用这些信息撤销游戏内的物品或福利。

有关 webhook 通知的更多信息，请参阅 文档。

使用 CommerceProductOrderPaid 和 CommerceProductOrderRefunded 事件来跟踪产品订单的状态。EventPayload 将包含相关的 CommerceProductOrder，其架构如下：

EventPayload schema
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "商务产品订单的资源路径。\n\n格式：\n `universes/{universe_id}/commerce-products/{commerce_product_id}/orders/{commerce_product_order_id}`",
      "x-example-values": {
        "exampleValues": [
          "universes/123/commerce-products/123/orders/123e4567-e89b-12d3-a456-426655440000"
        ]
      }
    },
    "createTime": {
      "readOnly": true,
      "type": "string",
      "description": "商务订单创建时的时间戳。",
      "format": "date-time",
      "x-example-values": {
        "exampleValues": [
          "2023-07-05T12:34:56Z"
        ]
      }
    },
    "updateTime": {
      "readOnly": true,
      "type": "string",
      "description": "商务订单最后一次更新时的时间戳。",
      "format": "date-time",
      "x-example-values": {
        "exampleValues": [
          "2023-07-05T12:34:56Z"
        ]
      }
    },
    "state": {
      "readOnly": true,
      "enum": [
        "STATE_UNSPECIFIED",
        "STATE_PAID",
        "STATE_REFUNDED"
      ],
      "type": "string",
      "description": "该订单的当前状态，即 PAID、REFUNDED、CANCELED\n\n可能的值：\n\n  | 值 | 描述 |\n  | --- | --- |\n  | STATE_UNSPECIFIED | 未指定状态。 |\n  | STATE_PAID | 订单已支付。 |\n  | STATE_REFUNDED | 订单已退款。 |",
      "format": "enum",
      "x-example-values": {
        "exampleValues": [
          "STATE_UNSPECIFIED"
        ]
      }
    },
    "merchantOrderId": {
      "immutable": true,
      "type": "string",
      "description": "商家特定的订单 ID，可以用于在商家平台上查找订单。"
    },
    "merchant": {
      "immutable": true,
      "enum": [
        "MERCHANT_PLATFORM_UNSPECIFIED",
        "SHOPIFY",
      ],
      "type": "string",
      "description": "用于履行订单的商家。\n\n可能的值：\n\n  | 值 | 描述 |\n  | --- | --- |\n  | MERCHANT_PLATFORM_UNSPECIFIED | 未指定商家类型。 |\n  | SHOPIFY | 该物品通过 Shopify 销售。 |",
      "format": "enum",
      "x-example-values": {
        "exampleValues": [
          "MERCHANT_PLATFORM_UNSPECIFIED"
        ]
      }
    },
    "user": {
      "immutable": true,
      "type": "string",
      "description": "下此订单的用户。",
      "x-example-values": {
        "exampleValues": [
          "users/123"
        ]
      }
    }
  },
  "description": "一项商务产品订单代表 Roblox 用户购买 CommerceProduct 的过程。它包含进行购买的用户和商家订单的详细信息。",
}

产品详细页面

产品详细页面 (PDP) 在 Roblox 游戏中向用户展示您的商务产品，例如，当通过 CommerceService:PromptCommerceProductPurchase() 提示时。您可以自定义此页面的多个元素，以提供独特而有信息性的购物体验。

产品图像 展示您在 Shopify 商店中提供的产品图像。

产品标题、价格和卖家信息 包含产品和卖家详情。

变体和数量 显示不同的可用选项和数量。

产品详情 显示 Shopify 产品描述。

附加信息 包含补充详细信息，例如“材料”、“护理说明”或“尺码表”。

购买时的虚拟福利 详细说明用户在购买时将收到的虚拟物品。

来自此游戏的更多信息 建议用户查看同一游戏内提供的其他商务产品。

产品图像

产品图像部分显示来自您 Shopify 商店的所有产品图像。图像的顺序直接与 Shopify 中设置的顺序相符。

第一张图像，被称为 Shopify 中的 主图，作为产品的主缩略图使用。此缩略图在多个地方使用，例如购物车和 来自更多的 部分。

当您在 Shopify 中更新产品图像时，这些更改会遵循 目录项目的审核流程。Roblox 上的产品列表将继续显示先前批准的图像，直到新图像获得批准。

产品标题、价格和卖家信息

产品标题直接来源于 Shopify 商店中设置的产品标题。

如果用户选择了不同价格的产品 变体和数量，显示的价格将动态更新。显示的卖家信息为您的 Shopify 商店名称。

与其他产品属性类似，如果您在 Shopify 中更新产品标题，则这些更改需遵循 目录项目的审核流程。Roblox 上的产品列表将继续显示先前批准的标题，直到新标题获得批准。

变体和数量

产品变体及其选项（如不同颜色或尺寸）与您的 Shopify 商店进行同步。这些变体和选项的顺序与 Shopify 中的顺序相匹配，从上到下显示。

当用户选择特定变体时，主产品图像会更新为显示与该变体在 Shopify 中关联的图像。

目前，PDP 上的数量选择器不提供自定义选项。如果所选产品变体不可用，“立即购买”和“添加到购物车”按钮将被禁用。请确保在 Shopify 中正确配置您的变体以允许购买。

在 Shopify 中对产品变体或其图像所做的任何更新均须遵循 目录项目的审核流程。产品详细页面将继续显示先前批准的变体信息和图像，直到新版本获得批准。

产品详情

产品详情 部分直接显示来自 Shopify 产品描述的内容。

该部分支持使用 HTML 来样式化和格式化您的产品信息。出于安全性和一致性考虑，Roblox 会自动删除某些 HTML 元素，包括链接、图像、脚本以及其他类似标签和属性。否则，您可以使用 HTML 来样式化和构造文本内容，例如使用标题、粗体文本、列表和段落。

产品描述必须包含对商品的准确描述，涵盖功能、规格、特性、退换货政策和来源等详细信息。请确保您的所有商务产品在 Shopify 中都有完整的描述，以便获得销售批准。有关更多信息，请参见 商务标准。

与从 Shopify 同步的其他产品信息一样，产品描述的任何更新都需遵循 目录项目的审核流程。产品详细信息将继续显示先前批准的描述，直到新内容通过审核获得批准。

附加信息

附加信息 部分使用可折叠的手风琴展示有关您的产品的补充细节。您可以为不同主题（如“材料”、“护理说明”或“尺码”）添加 最多五个 手风琴部分。

这是一个可选功能，使用 Shopify 产品 metafields 进行填充。要在 Shopify 中创建一个 metafield 手风琴：

• 在您的 Shopify 商店中定义一个具有特定命名空间的产品 metafield：Roblox.pdp_info_。

  • 您可以将唯一标识符附加到此命名空间中，例如 Roblox.pdp_info_materials 或 Roblox.pdp_info_care_instructions。

• 设置以下字段：

  • 名称 — 此字段的值显示为该手风琴的标题。

  • 类型 — 仅支持“多行文本”。

    

• 然后设置每个所需产品的 metafield 的 值。此值将显示为该手风琴的内容。

像从 Shopify 同步的其他产品内容一样，这些 metafields 中的任何新信息或更新需遵循 目录项目的审核流程。此页面将显示先前批准的内容，直到新信息获得批准。

购买时的虚拟福利

如果您为产品捆绑了 数字福利，则此部分展示用户在购买时获得的虚拟物品。此部分为用户提供了关于他们所获得的附加数字价值的清晰视觉和信息提示，提高了您的商务产品的吸引力。

此部分的内容取决于提供的虚拟物品类型：

• 头像物品

  • 此部分显示头像物品的缩略图和名称。
  • 用户可以点击此部分查看头像物品的 3D 预览。
  • 当用户点击此部分时，头像物品的描述将显示。

• 开发者产品

  • 此部分显示开发者产品的图像和名称。
  • 当用户点击此部分时，开发者产品的描述将显示。

特定的头像物品或开发者产品，包括其名称、描述和图像，在您 创建商务产品捆绑 时进行配置。由于这些福利是整体产品提供的一部分，因此它们须遵循 Roblox 的内容政策和审核流程。

来自此游戏的更多信息

此部分显示您在同一 Roblox 游戏中提供的其他当前在售商务产品。此信息喂养进一步鼓励用户探索您的产品目录，并有助于提升您游戏全系列产品的可见性。

在此部分中，用户可以查看产品的主图、名称和价格。