用于IAP批量提交的CSV文件
您可以使用CSV文件来上传新的和更新的IAP商品,以便批量提交应用内商品。IAP批量提交功能可以将现有IAP商品导出到CSV文件中。编辑该文件以更新现有条目并添加新条目,然后导入新的和更新的IAP商品并将它们提交到亚马逊应用商店。
CSV文件支持消费品和权利IAP(但不支持订阅)。为更加轻松地创建IAP,现在IAP的图标图像是可选的。CSV文件不支持上传图标图像。
要创建或更新单个IAP(和订阅IAP),请使用开发者控制台用户界面,如提交单个应用内商品中所述。
功能
IAP批量提交提供了以下功能:
-
将现有的应用内商品导出为CSV文件。使用此文件作为起点来更新现有的IAP商品或创建新的IAP商品。
-
导入CSV文件来创建新商品和更新现有商品。
- 两步错误处理:
- 系统验证CSV文件是否存在任何格式错误(如缺少价格,或字段格式不正确)。
- 系统识别任何提交后错误,如产品ID重复。
-
如果CSV文件中的条目未通过验证检查或提交后检查,则系统会创建一个文件,其中包含针对每个失败条目的特定错误消息。
-
开发者门户显示添加的IAP商品数量、更新的商品数量和错误数量。
- CSV文件可以包含消费品商品和权利商品、新商品和更新的现有商品的组合。
CSV文件格式
CSV文件是具有.csv文件扩展名的文本文件。CSV文件必须使用UTF-8编码,以支持本地化字符串。
CSV文件包含一个标题行(其中显示列标题)。文件中的每个后续行都包含一个应用内商品的信息。“产品ID”字段定义每个商品的唯一标识符。
下表介绍了文件中每个条目(行)的字段:
字段 | 类型 | 描述 |
---|---|---|
Product ID | 字符串 | 为IAP商品输入唯一产品ID。在亚马逊开发者门户上,此字段又称为SKU。产品ID值在您的所有应用中必须是唯一的。它最多包含150个字符,其中可包含字符a-z、A-Z、0-9、下划线、句点和短划线。产品ID区分大小写。如果您未提供产品ID值,则系统将忽略文件的这一行。 |
Locale; Title; Description; | 字符串 | 为商品指定区域设置、名称和描述。输入三个值,用分号隔开,顺序如下: 区域设置;名称;描述;。您可以针对不同的区域设置提供多组值。但是,即使您的应用仅在不使用en_US编码的国家/地区可用,您也必须为每个项目提供英语(en_US)文本。 有关语言缩写的列表,请参阅下面的支持的语言表。 对于您未提供翻译文本的任何区域设置,系统将显示英语文本。 |
Auto Fill Prices | TRUE或FALSE | 如果将Auto Fill Prices(自动填充价格)设置为TRUE,则只需在Price(价格)字段中输入价格值(以设置基本价格)。 如果将Auto Fill Prices设置为FALSE,则必须为每个市场输入价格。 |
Price | PriceMicro | 如果您不对此商品收费,请输入0。 如果将Auto Fill Prices设置为TRUE,请为商品提供币种缩写和价格。 否则,请使用用分号分隔的一对值为每个市场输入价格。对每个值对使用以下格式: 国家/地区缩写; 价格;(最后一对后面不需要分号)。 将价格设置为每种币种的有效金额。请参阅每种币种的IAP价格范围。 有关示例条目以及国家/地区与币种的对应关系,请参阅下文。以币种基本单位的百万分之一为单位输入价格,不带小数。例如,如果单位价格为1美元,则在CSV文件上应输入为 US; 1000000; 。如果您没有为每个市场提供价格,则系统会将此行标记为存在错误。
|
IAP Type | 消费品或权利 | 输入IAP类型。如果此字段为空或无效,则系统会将此行标记为存在错误。请注意,值区分大小写,并且不支持订阅。 |
TEST IAP 注意: 仅在导出商品时出现。不用于导入商品。 |
TRUE或FALSE | 对于仅为LAT提交或发布的IAP(带有“测试”标签的IAP),此字段的值为TRUE。
对于同时为测试和上线创建和提交的IAP,此字段的值为FALSE。 |
下面的示例显示了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 |
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 |
MX | MXN | 墨西哥比索 | Amazon.com.mx |
US | USD | 美元 | Amazon.com |
支持的语言
下表显示了名称和描述字段支持的语言:
缩写 | 语言 |
---|---|
Zh_CN | 中文(不支持拼音。请参见下面的“警告”) |
de_DE | 德语 |
en_AU | 英语(澳大利亚) |
en_GB | 英语(英国) |
en_IN | 英语(印度) |
en_US | 英语(美国) |
es_ES | 西班牙语 |
es_MX | 西班牙语(墨西哥) |
fr_FR | 法语 |
it_IT | 意大利语 |
ja_JP | 日语 |
pt_BR | 巴西葡萄牙语 |
错误消息
当您上传CSV文件时,系统将验证该文件中的每个条目。如果文件包含错误,则系统会复制输入文件,并在状态列中为具有错误的每一行添加消息。您可以查看消息作为解决任何问题的指导。
示例CSV文件
CSV模板文件包含示例条目。有关下载文件的说明,请参阅创建并提交一批IAP。
有关行格式的说明:
- 使用逗号分隔行中的每个字段。
- 使用分号分隔字段中的值。忽略空格。
注意: 使用Unicode文本编辑器来编辑您的CSV文件,以支持UTF-8字符集。Microsoft Excel之类的工具以可读形式显示CSV文件,但如果您操作不慎,则这些工具可能会损坏CSV文件。例如,Excel可能会重新设置日期字段和币种字段的格式,并且可能会将特殊字符转换为无效字符。
建议使用Google Sheets查看和编辑CSV文件。
有关如何为Excel和其他工具配置UTF-8编码的说明,请参阅为Excel配置UTF-8。
将UTF-8 CSV文件导入到Excel中:
- 选择File>Import(文件 > 导入)
- 选择CSV作为文件类型
- 选择要导入的文件
- 在Text Import Wizard(文本导入向导)中,选择UTF-8作为文件源。
Last updated: 2024年10月23日