本节说明了如何让您在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 调用的真实性。
重要信息
- 回调URL应该指向基于 此处提供的API规范 的
PaymentsProcessingCallback
API。
4. 隐私政策(Privacy Policy)
使用此部分,您可以配置隐私政策设置。
5. 发布或保存草稿
在完成对您的网上商店的配置后,您可以:
保存草稿
将您的网上商店保存为草稿:
- 点击右下角的保存草稿(Save Draft)。
- 您的网上商店将被保存为草稿,并添加到商店详情(Shop Details)部分,如下图所示:
- 要预览您的网上商店,请点击预览网上商店(Preview Webshop)。
- 您可以预览您的网上商店,并在发布之前做出必要的更改。
(预览窗口将在新窗口中打开)
- 要继续编辑您的网上商店,请点击编辑商店(Edit Shop),如上所示。
发布您的网上商店
在您完成对网上商店的配置后:
- 点击右下角中的发布(Publish)。
- 您的网上商店将被发布并添加到商店详情(Shop Details)部分,如下图所示:
- 您可以复制已发布的URL(published URL),或点击查看网上商店(View Webshop)按钮以访问您的网上商店。
- 如果您希望编辑网上商店有关的任何详情/信息:
- 在您完成编辑后,点击发布(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)。
使用现有的网上商店
使用此部分,您可以将您现有的网上商店连接到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)
请求头(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的成功状态后,我们将把订单标记为完成。
- 如果我们没有得到成功的响应,我们将会继续重试一段时间。如果还没有收到响应,我们将为订单发起退款。