开发人员控制台

用于IAP批量提交的CSV文件


用于IAP批量提交的CSV文件

您可以使用CSV文件来上传新的和更新的IAP商品,以便批量提交应用程序内商品。IAP批量提交功能可以将现有IAP商品导出到CSV文件中。编辑该文件以更新现有条目并添加新条目,然后导入新的和更新的IAP商品并将它们提交到应用商店。

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文本编辑器来编辑您的CSV文件,以支持UTF-8字符集。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. Text Import Wizard(文本导入向导)中,选择UTF-8作为文件源。