用于 IAP 批量提交的 CSV 文件


用于 IAP 批量提交的 CSV 文件

您可以使用 CSV 文件提交一批应用内项目来上传新的和更新的 IAP 项目。IAP 批量提交功能能够将现有 IAP 项目导出到 CSV 文件中。编辑该文件以更新现有条目和添加新条目,然后导入新的和更新的 IAP 项目并将其提交到 Appstore。

CSV 文件支持消费品和权利 IAP(但不支持订阅)。为更加轻松地创建 IAP,IAP 的图标图像现在是可选的。CSV 文件不支持上传图标图像。

要创建或更新单个 IAP(和订阅 IAP),请使用开发者控制台 UI,如提交单个应用内项目中所述。

功能

IAP 批量提交功能提供了以下功能:

  • 将现有的应用内项目导出为 CSV 文件。使用此文件作为起点来更新现有的 IAP 项目或创建新的 IAP 项目。

  • 导入 CSV 文件来创建新项目和更新现有的项目。

  • 两步错误处理:
    • 系统验证 CSV 文件是否存在任何格式错误(如缺少价格,或字段格式不正确)。
    • 系统识别任何提交后错误,如产品 ID 重复。
  • 如果 CSV 文件中的条目未通过验证检查或提交后检查,则系统会创建一个文件,其中包含针对每个失败条目的特定错误消息。

  • 开发者门户显示添加的 IAP 项目数量、更新的项目数量和错误数量。

  • CSV 文件可以混合包含消费品项目和权利项目、新项目和更新的现有项目。

CSV 文件格式

CSV 文件是具有 .csv 文件扩展名的文本文件。CSV 文件必须使用 UTF-8 编码,以支持本地化字符串。

CSV 文件包含一个标题行(它显示列标题)。文件中的每个后续行包含一个应用内项目的信息。“产品 ID”字段定义每个项目的唯一标识符。

下表介绍了文件中的每个条目(行)的字段:

字段 类型 描述
产品 ID 字符串 为 IAP 项目输入唯一产品 ID。在亚马逊开发者门户上,此字段又称为 SKU。产品 ID 值在您的所有应用中必须是唯一的。它最多包含 150 个字符,其中可包含字符 a-z、A-Z、0-9、下划线、句点和短划线。产品 ID 区分大小写。如果您未提供产品 ID 值,则系统将忽略文件的此行。
区域设置; 标题; 描述; 字符串 为项目指定区域设置、名称和描述。输入三个值,用分号隔开,顺序如下: 区域设置; 标题; 描述;​。您可以提供多组值(针对不同的区域设置)。
有关语言缩写的列表,请参阅下面的支持的语言表。
对于您未提供翻译文本的任何区域设置,系统将显示英语(美国)文本。
自动填充价格 TRUE 或 FALSE 如果将“Auto Fill Prices”(自动填充价格)设置为 TRUE,则仅在 Price(价格)字段中输入一个价格值(以设置基本价格)。
如果将“Auto Fill Prices”(自动填充价格)设置为 FALSE,则必须为每个市场输入价格。
价格 PriceMicro 如果您不对此项目收费,请输入 0。
如果将 Auto Fill Prices(自动填充价格)设置为 TRUE,请为项目提供币种缩写和价格。
否则,请使用用分号分隔的一对值为每个市场输入价格。对每个值对使用以下格式: 国家/地区缩写; 价格;(最后一对后面不需要分号)。
将价格设置为每种币种的有效金额。请参阅每种币种的 IAP 价格范围
有关示例条目和国家/地区到币种的映射,请参阅下文。以币种基本单位的百万分之一为单位输入价格。如果您没有为每个市场提供价格,则系统会将此行标记为存在错误。
IAP 类型 消费品权利 输入 IAP 类型。如果此字段为空或无效,则系统会将此行标记为存在错误。请注意,值区分大小写,并且不支持订阅

下面的示例显示了“Auto Fill Prices”(自动填充价格)设置为 FALSE 时的价格条目:

US;44000000;DE;41640000;IN;2933590000;JP;5015000000;IT;41640000;FR;41640000;ES;41640000;BR;137250000; AU;57990000;GB;36060000;CA;59020000

下面的示例显示了“Auto Fill Prices”(自动填充价格)设置为 TRUE 时的价格条目:

USD; 3840000

注意:​ 当“Auto Fill Prices”(自动填充价格)设置为 TRUE 时,请输入币种缩写,而不是国家/地区缩写。

国家/地区和币种缩写

下表显示了每个市场的国家/地区缩写、币种缩写和币种:

国家/地区
缩写
​币种
缩写
​币种 市场
AU AUD 澳元 Amazon.com.au
BR BRL 巴西雷亚尔 Amazon.com.br
CA CAN 加拿大元 Amazon.ca
CN CHY 人民币 Amazon.cn
DE EUR 欧元 Amazon.de
ES EUR 欧元 Amazon.es
FR EUR 欧元 Amazon.fr
GB GBP 英镑 Amazon.co.uk
IN INR 印度卢比 Amazon.in
IT EUR 欧元 Amazon.it
JP JPY 日元 Amazon.co.jp
US USD 美元 Amazon.com

支持的语言

下表显示了名称和描述字段支持的语言:

缩写 语言
Zh_CN 中文(不支持拼音。请参见下面的“警告”)
de_DE 德语
en_AU 英语(澳大利亚)
en_GB 英语(英国)
en_IN 英语(印度)
en_US 英语(美国)
es_ES 西班牙语
fr_FR 法语
it_IT 意大利语
ja_JP 日语
pt_BR 巴西葡萄牙语

错误消息

当您上传 CSV 文件时,系统将验证该文件中的每个条目。如果文件包含错误,则系统会复制输入文件,并在状态列中为具有错误的每个行添加消息。您可以查看消息作为解决任何问题的指南。

示例 CSV 文件

CSV 模板文件包含示例条目。有关下载文件的说明,请参阅创建并提交一批 IAP

有关行格式的说明:

  1. 在行中使用逗号分隔每个字段。
  2. 在字段中使用分号分隔值。忽略空格。

注意: 使用 Unicode 文本编辑器(以支持 UTF-8 字符集)来编辑您的 CSV 文件。Microsoft Excel 之类的工具以可读格式显示 CSV 文件,但如果您不是很小心,则可能会损坏 CSV 文件。例如,Excel 可能会重新设置日期字段和币种字段的格式,并且可能会将特殊字符转换为无效字符。

我们建议您使用 Google Sheets 来查看和编辑您的 CSV 文件。

有关如何为 Excel 和其他工具配置 UTF-8 编码的说明,请参阅为 Excel 配置 UTF-8​。

将 UTF-8 CSV 文件导入到 Excel 中:

  1. 选择 File>Import(文件 > 导入)​
  2. 选择 CSV 作为文件类型
  3. 选择要导入的文件
  4. 文本导入向导中,选择 UTF-8 作为文件源。