区域定价

设置商品目录时，可为虚拟物品和游戏密钥套餐配置面向不同国家/地区用户的价格政策（区域定价）。每个商品或游戏密钥套餐的价格默认以美元设置。您可以同时设置区域限制和区域价格。

运行机制

目录中的价格基于用户所在国家/地区。

通过支付中心进行购买的过程中，商品价格将转换为用户所在国家/地区的货币价格且含税（如适用）。

国家/地区的决定

  • 请求商品目录时，用户国家/地区在虚拟物品和货币或游戏密钥方法组的目录子部分下的方法的country参数中传递。
    如未指定国家/地区，将基于用户的IP地址决定。据此再针对用户国家/地区选择商品目录的价格。
  • 购买商品时：
    • 如使用客户端方法来获取支付令牌，切记应只从客户端侧使用它们，而不要从服务器侧使用。客户端方法中的国家/地区和货币由用户IP地址决定。从服务器侧使用该方法可能造成错误的货币决定并影响支付中心中的支付方式。
    • 如使用为购买创建支付令牌服务器方法，需在请求正文中传递country对象或在X-User-Ip头中传递用户IP地址。
    1. 如在country.value参数中传入了国家/地区且在X-User-Ip头中传入了IP地址，则country.value参数中的国家/地区值优先。
注：
您可以在currency参数中传递货币。该值的优先级高于国家/地区值，且影响支付货币的显示。支付界面中的支付方式仍将由country.value参数中的国家/地区值决定。

商品目录中的价格显示原则

应对目录中的所有商品使用相同的货币列表来指定价格。

这样做是为了让目录中的所有商品以相同的货币显示。如未对某个国家/地区的某个商品指定价格，则整个目录的价格在该国家/地区以默认货币显示。

如果商品的默认货币不同，则价格以目录中第一个商品的默认价格显示。如某个商品没有该货币下的价格，则响应中对它的价格返回null值。这会导致该商品价格显示不正确，并可能影响目录的整体显示。

示例：

适用对象

希望通过设置针对不同国家/地区用户的商店定价政策从而增加购买力较低国家/地区销量的合作伙伴。

如何获取

您可以通过以下方式添加、编辑和删除区域价格：

注：
从Google Play导入目录时，添加的商品包含可编辑的区域价格。重新导入目录时，请考虑数据更新的情况。

创建和编辑商品时通过发布商帐户进行设置

要创建具有区域价格的虚拟物品：
  1. 在发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店。
  3. 在虚拟物品窗格中，单击配置。
  4. 单击+，然后从下拉列表中选择创建物品。
  1. 指定：
    • 图片
    • SKU
    • 该物品所属的一个或多个组
    • 名称
    • 描述
    • 物品属性 — 消耗品、非消耗品或到期性订阅
  2. 在价格设置区块，选择付费物品。
  3. 将真实货币定价开关切换为开并指定价格。如未设置区域价格，则该物品在所有国家/地区中的价格相同并以美元表示。
注：
您可以将USD改为其他默认货币。
注意
不能创建价格为零的物品。
  1. 设置价格：
    • 如要设置不同货币下的物品价格，请单击+，然后指定货币和价格。
    • 如要针对国家/地区设置特殊价格，请单击添加定价，然后指定国家/地区、货币和数量。您可以根据需要设置多个区域价格。
  2. 如要添加以虚拟货币表示的价格，请将虚拟货币定价开关设置为开，然后指定价格。
  3. 如要限制指定用户的物品可购数量，请将限制单个用户可购买此物品的次数开关设置为开，然后指定数量。
  4. 如要在商店中显示物品，请将在商店中显示物品开关设置为开。
  5. 单击创建物品。

在发布商帐户中从文件导入

您可以从文件中导入预创建商品的区域价格。

功能

  • 一次性上传或更新多个商品的区域价格。
  • 支持所有类型的商品：
    • 虚拟物品
    • 虚拟货币
    • 虚拟货币套餐
    • 捆绑包
    • 特定平台的游戏密钥套餐

  • 验证上传的数据。如文件结构或数据格式不符合要求，您将在导入过程中看到错误列表。

文件结构

文件必须为CSV格式并包含以下列：
注：
请勿更改英文列名称，更改后可能会在文件导入过程中造成错误。
  • SKU — 要为其设置区域价格的商品SKU。
  • Country — 用ISO 3166-1 alpha-2格式指定的国家/地区代码。上传CSV文件前请检查艾克索拉支持的国家/地区列表。此列中的单元格是选填的。您可以查看在未指定国家/地区的情况下的价格显示示例。
  • Currency — 货币代码使用ISO 4217格式。
  • Amount — 商品的价格。小数点用句点表示。

  • IsDefault — 这是否为默认价格。指定：

    • 1 — 在使用默认价格的行中使用该值。它将显示在所有无区域价格的国家/地区中。
    • 0 — 在所有其他行中使用该值。您也可以将IsDefault列的单元格留空。

注：

默认价格不应是区域性的，将Country列的单元格留空。

示例

正确填写的文件（多个商品、3种货币、有区域价格）。

错误填写的文件（多个商品、3种货币、有区域价格）。
错误：在virtual-item-1和bundle-1组中，Country列的单元格不为空。


添加每个新商品时，必须设置默认货币的价格。如果未指定，导入文件时将显示错误。

示例

正确填写的文件（多个商品、3种货币、有区域价格）。

错误填写的文件（多个商品、3种货币、有区域价格）。
错误：virtual-item-1和bundle-1组没有任何默认货币。

  • Platform — 平台SKU。仅用于设置游戏密钥的区域价格，不用于其他商品。

    可用平台。
    平台SKU平台名称
    steamSteam
    playstationPlayStation
    xboxXbox
    uplayUplay
    originOrigin
    drmfreeDRM Free
    gogGOG
    epicgamesEpic Games Store
    nintendo_eshopNintendo Switch eShop
    discord_game_storeDiscord Game Store
    oculusOculus
    viveportViveport
    stadiaGoogle Stadia

注：

具有相同SKU但平台不同的游戏密钥视为不同的实体。每个实体都必须指定默认货币的价格。

示例

正确填写的文件（多个游戏密钥、3种货币、有区域价格、2个平台）。

错误填写的文件（多个游戏密钥、3种货币、有区域价格、2个平台）。
错误1：按SKU和Platform对游戏密钥分组不正确，导致找到9个实体而不是3个。
错误2：由于分组不正确，组3、4、5和6没有默认价格。
错误3：组9将覆盖组7的数据，因为它们对同一实体有一组完整的价格。因此，导入后playstation平台的game-key-2将只有MYR的价格。

文件填写示例和可能出现的错误

正确填写CSV导入文件的示例：
错误填写CSV导入文件的示例：

文件导入

要从文件导入价格：
  1. 在发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店，然后前往包含任意产品类型的部分。
  3. 单击导入价格。

  1. 在导入窗口中，可下载文件目标并添加值。
  2. 在导入窗口的相应字段上传文件。
  3. 导入过程中如发生错误，导入窗口将显示错误列表和改正建议。请对文件作出必要更改，然后重新上传。

成功上传后，所指定SKU的商品的区域价格将根据文件中的价格更新。之前指定的价格将被删除。

示例：

在发布商帐户中存在用不同货币指定的多个价格以及多个区域价格。在导入的文件中，只有一个EUR价格。导入该文件后，在发布商帐户中，该商品将只有一个EUR价格。

使用API方法进行设置

要通过API方法设置区域价格，请在以下方法中传入包含国家/地区价格设置的对象数组：数组示例：
Copy
Full screen
Small screen
  • http
"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]
本文对您的有帮助吗？
谢谢！
我们还有其他可改进之处吗？ 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2024年11月8日

发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈！