nowStudio >

网上商店

本节说明了如何让您在now.gg的技术支持下建立一个网上商店，或连接现有的网上商店到您的应用程序，节省商店佣金。

要设置网上商店，请执行以下操作：

  • 点击设置商店（Setup Shop）。
    这将会跳转到商店详情（Shop Details）- 配置（Configuration）部分，在那里您可以提供所需的详情并发布您的商店。

商店详情

该部分允许您配置您的商店，并在此列出草稿或已发布的商店。

配置

使用此部分，您可以配置您的网上商店。

要配置您的商店，您必须选择您的商店偏好（Shop preference）。

您可以：

建立由now.gg技术支持的网上商店

在商店偏好（Shop preference）中选择“建立网上商店”（’Build Webshop’），您可以在这里继续配置您由now.gg技术支持的网上商店。

1. 商店产品

使用此部分，您可以选择您想在网上商店上销售的产品。

  • 点击选择产品（Select Products）+，如下图所示：
  • 从您已经添加的产品中选择：
  • 如果没有存在的产品或您想添加新的产品，您可以在 应用内产品章节 添加它们。
  • 选择完产品后，请点击“完成”（Done）。
  • 您现在可以在下一步继续添加设计资源。

2. 设计资源

使用此部分，您可以为网上商店选择设计资源。

重要信息

  • 如果您在将应用添加到nowStudio时在发布标签（Publish tab）下上传了通用的游戏资源，那么在建立您的网上商店时，这些资源将自动被选用。
  • 您可以点击“替换图片”（replace image），按需更改。
  • 这里所做的任何更改都将反映在发布标签（Publishing tab）内的 描述和资源页面。

您可以根据以下规格上传资源：

  • 游戏图标（Game Icon）
    • 尺寸 – 512 x 512px
    • 图片格式 – .JPG, .JPEG, .PNG
    • 最大大小 – 10 Mb
  • 游戏标志（Game Logo）
    • 尺寸 – 550 x 300px
    • 图片格式 – .PNG, .SVG
    • 最大大小 – 10 Mb
  • 屏幕截图（Screenshots）
    • 尺寸 – 16:9, 9:16 (each side between 320px to 3840px)
    • 图片格式 – .JPG, .JPEG, .PNG
    • 最大大小 – 10 Mb
  • 横幅视频
    • 尺寸 – 1920 x 1080px
    • 格式 – MP4
    • 最大大小 – 50 Mb
  • 横幅图片
    • 尺寸 – 1920 x 1080px
    • 图片格式 – JPEG
    • 最大大小 – 10 Mb
  • OG图片（OG Image）
    • 尺寸 – 1920 x 1080px
    • 图片格式 – JPEG
    • 最大大小 – 10 Mb
  • 移动应用页面横幅
    • 横幅视频
      • 尺寸 – 1920 x 1080px
      • 格式 – MP4
      • 最大大小 – 50 Mb
    • 横幅图片
      • 尺寸 – 1920 x 1280px
      • 图片格式 – JPEG
      • 最大大小 – 10 Mb

3. 支付设置（Payment Settings）

使用此部分，您可以为网上商店配置以下支付设置。

您可以配置：

  • 回调URL（Callback URL）
    为我们提供回调URL，我们将使用它在交易后发送请求数据。
  • API秘钥（API Key）
    交易后，API秘钥将与请求数据一同发送给您。您可以验证它以确保 API 调用的真实性。

重要信息

4. 隐私政策（Privacy Policy）

使用此部分，您可以配置隐私政策设置。

  • 请提供贵组织的隐私政策URL，如下图所示：
  • 更新此处的隐私政策URL也会反映在 发布标签（Publish tab）的信息（information）部分。

5. 发布或保存草稿

在完成对您的网上商店的配置后，您可以：

  • 保存您的网上商店为草稿
    • 预览您的网上商店
  • 发布您的网上商店
保存草稿

将您的网上商店保存为草稿：

  • 点击右下角的保存草稿（Save Draft）。
  • 您的网上商店将被保存为草稿，并添加到商店详情（Shop Details）部分，如下图所示：
  • 要预览您的网上商店，请点击预览网上商店（Preview Webshop）。
    • 您可以预览您的网上商店，并在发布之前做出必要的更改。
      （预览窗口将在新窗口中打开）
  • 要继续编辑您的网上商店，请点击编辑商店（Edit Shop），如上所示。
发布您的网上商店

在您完成对网上商店的配置后：

  • 点击右下角中的发布（Publish）。
  • 您的网上商店将被发布并添加到商店详情（Shop Details）部分，如下图所示：
  • 您可以复制已发布的URL（published URL），或点击查看网上商店（View Webshop）按钮以访问您的网上商店。
  • 如果您希望编辑网上商店有关的任何详情/信息：
    • 点击编辑商店（Edit Shop）。
  • 在您完成编辑后，点击发布（Publish）。
    • 在确认窗口中，点击发布（Publish）。

取消发布now.gg技术支持的网上商店或切换到您现有的网上商店

要取消发布您的now.gg技术支持的网上商店：

  • 在商店详情（Shop Details）部分中：
    • 点击右上角的编辑商店（Edit Shop）。
    • 点击右下角的取消发布（Unpublish）。
    • 在确认窗口中，点击取消发布（Unpublish）。
  • 您的网上商店将取消发布，并转为草稿状态。
  • 要访问您起草的网上商店，请点击左侧导航上的商店详情（Shop Details）。
切换到现有的网上商店

您可以从“now.gg技术支持的网上商店”切换到现有的网上商店（非now.gg）。

要执行此操作请：

  • 点击编辑商店（Edit Shop），如下图所示：

    （将打开配置部分）
  • 在配置部分的商店偏好（Shop Preference）下：
    • 点击使用现有网上商店（Use Existing Webshop）。
    • 在确认窗口中，点击继续（Proceed）。
    • 您的now.gg技术支持的网上商店将被禁用。
    • 您可以输入您现有商店的URL。
    • 点击发布（Publish）。
      • 在确认窗口中，点击发布（Publish）。

使用现有的网上商店

使用此部分，您可以将您现有的网上商店连接到nowStudio，并销售您的产品。

要使用您现有的网上商店：

  • 输入您现有网上商店的URL
    • 点击发布（Publish）。
    • 在确认窗口点击发布（Publish）。
  • 您的网上商店将被发布并添加到商店详情（Shop Details）部分，如下图所示：
  • 您可以将提供的链接复制到您的网上商店，或点击查看网上商店（View Webshop），以在新的浏览器窗口打开您的网上商店。
  • 如果您想编辑您的网上商店，在右上角点击编辑商店（Edit Shop），如上所示。
  • 在您完成编辑后，点击发布（Publish）。

切换到now.gg技术支持的网上商店

使用该部分，您可以从现有的网上商店切换到now.gg技术支持的网上商店。

要执行此操作：

  • 在商店详情（Shop Details）部分，点击右上角的编辑商店（Edit Shop），如下图所示：

    （将打开配置部分）
  • 在配置部分的商店偏好（Shop Preference）下：
    • 点击建立网上商店（Build Webshop）。
    • 在确认窗口中，点击继续（Proceed）。
  • 请按照 这里的步骤 配置您的网上商店。

内部测试人员

内部测试允许您轻松在now.gg技术支持的网上商店里测试产品购买和交付流程。您可以添加测试人员来测试网上商店的购买。

要添加测试人员：

  • 在所有应用程序（All Apps）下。
  • 点击您希望测试集成的应用程序的查看详情（View Details）。
    • 点击左侧侧边栏上的测试人员（Testers）。
    • 点击添加测试人员（Add Tester）。
      • 输入要用于测试的游戏内用户ID（IN_GAME_ID）。
    • 点击添加（Add）。
      屏幕上将显示确认信息“已成功添加测试人员”（‘A tester has been added successfully’）。

要删除测试人员：

  • 在所有应用程序（All Apps）下。
  • 点击您希望测试集成的应用程序的查看详情（View Details）。
    • 点击左侧侧边栏上的测试人员（Testers）。
    • 将显示测试人员列表，如下所示：
    • 将显示确认弹窗，如下图所示：
    • 点击删除（Delete）。
      屏幕上将显示确认信息“已成功删除测试人员”（‘A tester has been deleted successfully’）。

支付处理回调API

（由开发人员提供）

本节说明了API规范，您需要为我们提供 PaymentsProcessingCallback API，以成功地处理网上商店的购买。

重要

  • 这是一个由开发人员提供的API。在网上商店购买产品后，我们将使用此API发送请求数据。

PaymentsProcessingCallback API应用于成功地处理网上商店支付。以下是与订单处理相关的工作流程：

  • nowStudio将使用这个API将请求数据发送到您的游戏后端。
  • 您的游戏后端可以使用我们提供的API密钥（在 支付设置 下）来验证请求。
  • 您可以通过将所购买的产品分配给用户来完成购买流程。
  • 在我们收到状态码为200与为true的成功状态后，我们将把购买订单标记为已完成。
请求方法（Request Method）
 POST
请求头（Request Header）
Authorization: "<API-Key Here>"
 Content-type: application/json

注意：您可以 使用此部分 生成/重新生成API密钥。

请求主体（Request Body）

以下参数将包含在请求主体中。

参数 类型 值 描述
notificationType string WEBSHOP_ITEM_PURCHASED 当用户支付完成时发送。
data object
数据对象参数

以下参数与数据对象关联。

参数 类型 取值示例 描述
orderId string 1-202402110116343 与购买订单关联的订单ID。
packageName string gg.now.sample.app 您应用程序的包名。
productId string SampleProduct 与用户购买产品关联的产品ID。
eventTime long 1707965194000 与订单关联的纪元时间戳（epoch timestamp）。
paymentId string 1234 您应用的唯一标识符。
amount float 24.99 与订单关联的金额。
isTestOrder boolean true True/False
currency string USD 与应用内购买订单关联的货币。
inGameId string abc123 游戏内的用户ID。
developerPayload string {UID: abc} 开发者指定的字符串，包含有关订单的补充信息。
预期响应

以下是与 PaymentsProcessingCallback API相关的预期响应示例。

{
     "success": true, 
     "reason": "reason_for_failure". // 可选参数。失败时才需要。 
 }
退款处理

以下是实现在网上商店退款的流程。

  • 在我们使用您提供的回调URL发送请求数据之后，我们将等待来自您API的响应。
    • 如果我们收到状态码200的true的成功状态后，我们将把订单标记为完成。
    • 如果我们没有得到成功的响应，我们将会继续重试一段时间。如果还没有收到响应，我们将为订单发起退款。
×

目录

网上商店

目录

文档版本 1.0

文本已复制到剪贴板
copyLinkText
有疑问？请通过以下方式联系我们： dev-support@now.gg