メインコンテンツまでスキップ

应用内产品

📘

您可以使用我们的 API 以编程方式 管理应用的应用内产品的各个方面。

包含产品详情和可用状态的应用内产品列表

要访问 应用内产品 部分，请前往 应用，点击您要管理的应用，然后转到 应用内产品 选项卡。

在那里，您可以添加新的应用内产品、编辑现有产品并管理其可用性。

自动应用内产品​

如果您的应用也以相同的包名在 Google Play 上提供，您可以启用 应用内产品自动同步 开关。这可确保每当用户购买尚未在 Aptoide Connect 中列出的项目时，您的应用内产品列表都会自动更新。

通过自动同步添加产品后，其价格将 每周 刷新一次以保持最新。手动添加的应用内产品的价格不会与 Google Play 同步，必须由您自行更新。点击 适用的国家/地区 可查看我们能够代表您从 Google Play 获取价格的国家/地区列表。

此功能目前支持在以下国家/地区获取价格：巴西（BR）、德国（DE）、法国（FR）、英国（GB）、中国香港（HK）、印度尼西亚（ID）、爱尔兰（IE）、印度（IN）、日本（JP）、韩国（KR）、墨西哥（MX）、俄罗斯（RU）、瑞典（SE）以及 美国（US）。您可以将其中之一选为默认货币，在自动导入应用内产品时它将用作参考价格。

只有当获取到的值看起来像 刻意设定的价格 而非货币换算产物时，才会存储特定于国家/地区的价格。当价格符合以下模式之一时，会被视为刻意设定的价格：

  • 末位数字为 5 或 9 的两位小数 — 例如 0.99、1.49、12.25、99.95、123.45。
  • 单位小数（后面可选地跟随结尾的零）— 例如 1.5、2.7、14.5、25.50、9.900。
  • 满足以下任一条件的 整数（后面可选地跟随 .0、.00 等）：
    • 介于 0 和 29 之间 — 例如 5、15、29；或
    • 以 0、5 或 9 结尾 — 例如 30、45、99、1000、1500。

任何不符合上述模式之一的值（例如 1.37、33、41.23、10.51）都会被假定为货币换算的结果而被丢弃。在这种情况下，不会保存国家/地区价格，购买时金额将根据参考价格动态换算。

📘

这是一种 启发式方法，旨在过滤掉那些看起来像货币换算而非刻意设定价格的值。它并不完美——少数合理的价格可能会被跳过，少数换算后的值也可能会被漏过——但它能正确分类绝大多数现实世界中的价格。

⚠️

Google Play 在某些国家/地区返回 税前 价格，而在其他国家/地区返回 税后 价格。在依赖自动获取价格时请注意这一点，因为根据国家/地区的不同，存储的值可能已包含也可能未包含当地税费。

通过 CSV 预加载应用内产品​

要预先填充您的应用内产品列表，您可以使用 预加载 (CSV) 选项。这允许您上传一个包含您希望提前从 Google Play 获取的 SKU 的 CSV 文件，确保在用户尝试购买之前产品信息即已可用。

您的 CSV 文件必须包含一个表头为 Product ID 的单列，后跟每行一个 SKU，例如：

Product ID
sword.01
sword.02

上传文件后，新产品最多可能需要 5 分钟才会出现在您的应用内产品列表中。请确保所有 SKU 均有效，并与 Google Play 上使用的标识符相匹配，以避免同步问题。

手动应用内产品​

如果您的应用未以相同的包名在 Google Play 上提供，或者您禁用了 应用内产品自动同步 开关，您将获得对管理应用内产品的完全控制权。

设置产品价格有两种方式：

  • 逐个设置 – 逐一添加产品以进行精确管理。
  • 批量导入 – 上传 CSV 文件以高效地为多个产品设置价格。

逐个添加应用内产品​

要向您的应用添加单个应用内产品，请点击“添加”按钮。

将出现一个模态窗口，您可以在其中输入应用内产品详情，包括 ID、标题、描述 和 参考价格。填写完所有信息后，点击 添加 以完成此过程。

包含 ID、标题、描述和价格的添加应用内产品模态窗口

ID 只能包含小写字母、数字、下划线 (_) 和句点 (.)。

参考价格 在未设置特定国家/地区价格时使用。在这种情况下，购买金额将通过在交易时换算参考价格来自动计算。

逐个编辑应用内产品​

编辑应用内产品时，您可以更新多种语言的 状态、标题 和 描述，设置 参考价格，并管理 特定国家/地区价格。

包含多语言详情和国家/地区价格的编辑应用内产品视图

通过批量导入添加/编辑应用内产品​

您可以通过导入 CSV 文件（从 Google Play 导出，或从 Aptoide Connect 上的另一个应用导出）在 Aptoide Connect 上管理应用内产品。这使得在多个应用之间复制产品列表变得简单。

要导入 CSV 文件：

  1. 前往应用内产品选项卡。
  2. 点击菜单顶部的导入 CSV。
  3. 上传您的文件。

您还可以导出当前的产品列表，并用它在另一个应用中填充相同的产品，从而确保各应用之间的一致性。

⚠️
包含标题行

CSV 的第一行必须是列标题 Product ID,Published State,Price,Language; Title; Description。缺少此标题行的文件将无法导入。请参阅注册应用内产品时 CSV 导入失败。

文件应如何组织的示例如下：
Product ID,Published State,Price,Language; Title; Description
sword.020,published,EUR; 5,en; Sword 1; Big sword 1

各字段定义如下：

  1. Product ID： 产品的唯一 ID。只能包含小写字母、数字、下划线 (_) 和句点 (.)。示例：sword.020
  2. Published State： 产品的状态，为 published 或 not published。
  3. Price： 产品的价格。第一项是参考价格，使用有效的货币代码 和一个数值（例如 EUR; 5）。其余各项是特定国家/地区价格，使用有效的国家/地区代码 和一个数值（例如 US; 10）。
  4. Language： 用于标题和描述的有效的语言代码。示例：en
  5. Title： 向最终用户显示的产品名称。如果您不想显示标题，请使用 null。 示例：Sword 1
  6. Description： 向最终用户显示的产品描述。如果您不想显示描述，请使用 null。 示例：Big sword 1

上传的文件必须是 .csv 文件。我们建议使用能够保持结构完整的程序来编辑文件，例如 Notepad 或 VS Code。

您可以在同一 CSV 行中为单个产品添加多个价格：

Product ID,Published State,Price,Language; Title; Description
sword.020,published,USD; 5; BR; 2; PT; 5,en; Sword 1; Big sword 1

  • 参考价格：5 USD
  • 巴西 (BR) 价格：2 BRL
  • 葡萄牙 (PT) 价格：5 EUR

要更新现有产品，请保持 Product ID 不变并修改其他字段。要在不删除现有价格的情况下批量添加新价格，请在 CSV 中包含当前价格。否则，任何缺失的价格都将被替换。

只要 Product ID 保持不变，导入 CSV 就会更新所有其他字段。这样便可批量更新您的应用内产品。

👍
我们支持 Google Play 的产品 CSV 文件

我们也支持 CSV 格式的 Google Play 产品。您可以从 Google Play 下载您的产品列表，并直接将其导入到我们的平台上。