gplay-ppp-pricing

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PPP Pricing (Per-Region Pricing)

PPP定价(按区域定价)

Use this skill to set different prices for different countries based on purchasing power parity or custom pricing strategies.
使用此技能可基于购买力平价或自定义定价策略为不同国家设置不同价格。

Preconditions

前置条件

  • Ensure credentials are set (
    gplay auth login --service-account
    or
    GPLAY_SERVICE_ACCOUNT
    env var).
  • Use
    GPLAY_PACKAGE
    or pass
    --package
    explicitly.
  • Know your base region (usually US) and base price.
  • 确保已设置凭证(
    gplay auth login --service-account
    GPLAY_SERVICE_ACCOUNT
    环境变量)。
  • 使用
    GPLAY_PACKAGE
    环境变量或显式传递
    --package
    参数。
  • 知晓你的基准区域(通常为美国)和基准价格。

PPP Multiplier Table

PPP乘数表

Apply these multipliers to the base USD price. Round all results to
.99
endings (e.g., $4.73 → $4.99, ₹249.37 → ₹249.99).
将这些乘数应用于基准美元价格。所有结果四舍五入到以
.99
结尾(例如:4.73美元 → 4.99美元,249.37印度卢比 → 249.99印度卢比)。

Tier 1 — Full Price (1.0x–1.1x)

Tier 1 — 全价(1.0x–1.1x)

RegionCodeMultiplierCurrency
United StatesUS1.0xUSD
United KingdomGB1.0xGBP
GermanyDE1.0xEUR
AustraliaAU1.0xAUD
SwitzerlandCH1.1xCHF
CanadaCA1.0xCAD
NetherlandsNL1.0xEUR
SwedenSE1.0xSEK
NorwayNO1.05xNOK
DenmarkDK1.0xDKK
区域代码乘数货币
美国US1.0xUSD
英国GB1.0xGBP
德国DE1.0xEUR
澳大利亚AU1.0xAUD
瑞士CH1.1xCHF
加拿大CA1.0xCAD
荷兰NL1.0xEUR
瑞典SE1.0xSEK
挪威NO1.05xNOK
丹麦DK1.0xDKK

Tier 2 — Medium (0.6x–0.8x)

Tier 2 — 中等价位(0.6x–0.8x)

RegionCodeMultiplierCurrency
FranceFR0.8xEUR
SpainES0.7xEUR
ItalyIT0.7xEUR
JapanJP0.8xJPY
South KoreaKR0.7xKRW
PolandPL0.6xPLN
PortugalPT0.7xEUR
Czech RepublicCZ0.6xCZK
GreeceGR0.65xEUR
ChileCL0.6xCLP
Saudi ArabiaSA0.8xSAR
UAEAE0.8xAED
区域代码乘数货币
法国FR0.8xEUR
西班牙ES0.7xEUR
意大利IT0.7xEUR
日本JP0.8xJPY
韩国KR0.7xKRW
波兰PL0.6xPLN
葡萄牙PT0.7xEUR
捷克CZ0.6xCZK
希腊GR0.65xEUR
智利CL0.6xCLP
沙特阿拉伯SA0.8xSAR
阿联酋AE0.8xAED

Tier 3 — Low (0.3x–0.5x)

Tier 3 — 低价(0.3x–0.5x)

RegionCodeMultiplierCurrency
IndiaIN0.3xINR
BrazilBR0.5xBRL
MexicoMX0.45xMXN
IndonesiaID0.3xIDR
TurkeyTR0.35xTRY
VietnamVN0.3xVND
PhilippinesPH0.35xPHP
EgyptEG0.3xEGP
ColombiaCO0.4xCOP
ArgentinaAR0.3xARS
NigeriaNG0.3xNGN
PakistanPK0.25xPKR
ThailandTH0.4xTHB
MalaysiaMY0.45xMYR
South AfricaZA0.4xZAR
UkraineUA0.3xUAH
区域代码乘数货币
印度IN0.3xINR
巴西BR0.5xBRL
墨西哥MX0.45xMXN
印度尼西亚ID0.3xIDR
土耳其TR0.35xTRY
越南VN0.3xVND
菲律宾PH0.35xPHP
埃及EG0.3xEGP
哥伦比亚CO0.4xCOP
阿根廷AR0.3xARS
尼日利亚NG0.3xNGN
巴基斯坦PK0.25xPKR
泰国TH0.4xTHB
马来西亚MY0.45xMYR
南非ZA0.4xZAR
乌克兰UA0.3xUAH

Workflow: Set PPP-Based IAP Pricing

操作流程:设置基于PPP的应用内购买(IAP)定价

1. List in-app products

1. 列出应用内产品

bash
gplay iap list --package "PACKAGE"
bash
gplay iap list --package "PACKAGE"

2. Get current product details

2. 获取当前产品详情

bash
gplay iap get --package "PACKAGE" --sku "SKU"
Note the current
defaultPrice
as your base price.
bash
gplay iap get --package "PACKAGE" --sku "SKU"
记录当前的
defaultPrice
作为你的基准价格。

3. Build PPP-adjusted prices JSON

3. 构建经PPP调整的价格JSON

Using the base USD price and the multiplier table, compute per-region prices. Round all values to
.99
endings.
Example: Base price $9.99 USD → India (0.3x) = ₹249.99, Brazil (0.5x) = R$24.99
json
{
  "sku": "premium_upgrade",
  "defaultPrice": {
    "priceMicros": "9990000",
    "currency": "USD"
  },
  "prices": {
    "US": { "priceMicros": "9990000", "currency": "USD" },
    "IN": { "priceMicros": "2499900", "currency": "INR" },
    "BR": { "priceMicros": "24990000", "currency": "BRL" },
    "MX": { "priceMicros": "4490000", "currency": "MXN" },
    "TR": { "priceMicros": "3490000", "currency": "TRY" },
    "ID": { "priceMicros": "2990000", "currency": "IDR" },
    "JP": { "priceMicros": "7990000", "currency": "JPY" },
    "KR": { "priceMicros": "6990000", "currency": "KRW" },
    "GB": { "priceMicros": "9990000", "currency": "GBP" },
    "DE": { "priceMicros": "9990000", "currency": "EUR" }
  }
}
使用基准美元价格和乘数表,计算各区域价格。所有值四舍五入到以
.99
结尾。
示例:基准价格9.99美元 → 印度(0.3倍)= 249.99印度卢比,巴西(0.5倍)=24.99巴西雷亚尔
json
{
  "sku": "premium_upgrade",
  "defaultPrice": {
    "priceMicros": "9990000",
    "currency": "USD"
  },
  "prices": {
    "US": { "priceMicros": "9990000", "currency": "USD" },
    "IN": { "priceMicros": "2499900", "currency": "INR" },
    "BR": { "priceMicros": "24990000", "currency": "BRL" },
    "MX": { "priceMicros": "4490000", "currency": "MXN" },
    "TR": { "priceMicros": "3490000", "currency": "TRY" },
    "ID": { "priceMicros": "2990000", "currency": "IDR" },
    "JP": { "priceMicros": "7990000", "currency": "JPY" },
    "KR": { "priceMicros": "6990000", "currency": "KRW" },
    "GB": { "priceMicros": "9990000", "currency": "GBP" },
    "DE": { "priceMicros": "9990000", "currency": "EUR" }
  }
}

4. Update the product

4. 更新产品

bash
gplay iap update \
  --package "PACKAGE" \
  --sku "SKU" \
  --json @ppp-prices.json
bash
gplay iap update \
  --package "PACKAGE" \
  --sku "SKU" \
  --json @ppp-prices.json

5. Verify prices

5. 验证价格

bash
gplay iap get --package "PACKAGE" --sku "SKU"
Review the
prices
map to confirm all regions are set correctly.
bash
gplay iap get --package "PACKAGE" --sku "SKU"
查看
prices
映射表,确认所有区域的价格设置正确。

Workflow: Set PPP-Based Subscription Pricing

操作流程:设置基于PPP的订阅定价

1. List subscriptions

1. 列出订阅产品

bash
gplay subscriptions list --package "PACKAGE"
bash
gplay subscriptions list --package "PACKAGE"

2. Get current subscription details

2. 获取当前订阅详情

bash
gplay subscriptions get --package "PACKAGE" --product-id "PRODUCT_ID"
Note the base plans and their current
regionalConfigs
.
bash
gplay subscriptions get --package "PACKAGE" --product-id "PRODUCT_ID"
记录基础套餐及其当前的
regionalConfigs

3. Build PPP-adjusted subscription JSON

3. 构建经PPP调整的订阅JSON

Apply PPP multipliers equally to ALL base plans. Round to
.99
endings.
Example: Monthly $4.99, Yearly $49.99 with PPP for India (0.3x) and Brazil (0.5x):
json
{
  "productId": "premium_monthly",
  "basePlans": [
    {
      "basePlanId": "monthly",
      "regionalConfigs": [
        { "regionCode": "US", "price": { "priceMicros": "4990000", "currency": "USD" } },
        { "regionCode": "IN", "price": { "priceMicros": "1490000", "currency": "INR" } },
        { "regionCode": "BR", "price": { "priceMicros": "2490000", "currency": "BRL" } }
      ],
      "autoRenewingBasePlanType": { "billingPeriodDuration": "P1M" }
    },
    {
      "basePlanId": "yearly",
      "regionalConfigs": [
        { "regionCode": "US", "price": { "priceMicros": "49990000", "currency": "USD" } },
        { "regionCode": "IN", "price": { "priceMicros": "14990000", "currency": "INR" } },
        { "regionCode": "BR", "price": { "priceMicros": "24990000", "currency": "BRL" } }
      ],
      "autoRenewingBasePlanType": { "billingPeriodDuration": "P1Y" }
    }
  ]
}
将PPP乘数平等应用于所有基础套餐。四舍五入到以
.99
结尾。
示例:月度4.99美元,年度49.99美元,应用PPP于印度(0.3倍)和巴西(0.5倍):
json
{
  "productId": "premium_monthly",
  "basePlans": [
    {
      "basePlanId": "monthly",
      "regionalConfigs": [
        { "regionCode": "US", "price": { "priceMicros": "4990000", "currency": "USD" } },
        { "regionCode": "IN", "price": { "priceMicros": "1490000", "currency": "INR" } },
        { "regionCode": "BR", "price": { "priceMicros": "2490000", "currency": "BRL" } }
      ],
      "autoRenewingBasePlanType": { "billingPeriodDuration": "P1M" }
    },
    {
      "basePlanId": "yearly",
      "regionalConfigs": [
        { "regionCode": "US", "price": { "priceMicros": "49990000", "currency": "USD" } },
        { "regionCode": "IN", "price": { "priceMicros": "14990000", "currency": "INR" } },
        { "regionCode": "BR", "price": { "priceMicros": "24990000", "currency": "BRL" } }
      ],
      "autoRenewingBasePlanType": { "billingPeriodDuration": "P1Y" }
    }
  ]
}

4. Update the subscription

4. 更新订阅

bash
gplay subscriptions update \
  --package "PACKAGE" \
  --product-id "PRODUCT_ID" \
  --json @ppp-subscription.json
bash
gplay subscriptions update \
  --package "PACKAGE" \
  --product-id "PRODUCT_ID" \
  --json @ppp-subscription.json

5. Verify prices

5. 验证价格

bash
gplay subscriptions get --package "PACKAGE" --product-id "PRODUCT_ID"
Review all
regionalConfigs
across all base plans to confirm prices are correct.
bash
gplay subscriptions get --package "PACKAGE" --product-id "PRODUCT_ID"
查看所有基础套餐下的
regionalConfigs
,确认价格正确。

Workflow: Migrate Existing Subscriber Prices

操作流程:迁移现有订阅用户价格

When updating PPP prices on subscriptions with active subscribers, new prices only apply to new subscribers. To migrate existing subscribers:
当对已有活跃订阅用户的订阅产品更新PPP价格时,新价格仅适用于新订阅用户。如需迁移现有订阅用户:

1. Update prices (steps above)

1. 更新价格(执行上述步骤)

2. Migrate existing subscribers to new prices

2. 将现有订阅用户迁移至新价格

bash
gplay baseplans migrate-prices \
  --package "PACKAGE" \
  --product-id "PRODUCT_ID" \
  --base-plan "BASE_PLAN_ID" \
  --json @migration.json
bash
gplay baseplans migrate-prices \
  --package "PACKAGE" \
  --product-id "PRODUCT_ID" \
  --base-plan "BASE_PLAN_ID" \
  --json @migration.json

3. Repeat for each base plan

3. 对每个基础套餐重复操作

Apply migration to every base plan that had its prices changed:
bash
undefined
对所有价格已更改的基础套餐应用迁移:
bash
undefined

Monthly plan

月度套餐

gplay baseplans migrate-prices
--package "PACKAGE"
--product-id "PRODUCT_ID"
--base-plan monthly
--json @migration.json
gplay baseplans migrate-prices
--package "PACKAGE"
--product-id "PRODUCT_ID"
--base-plan monthly
--json @migration.json

Yearly plan

年度套餐

gplay baseplans migrate-prices
--package "PACKAGE"
--product-id "PRODUCT_ID"
--base-plan yearly
--json @migration.json
undefined
gplay baseplans migrate-prices
--package "PACKAGE"
--product-id "PRODUCT_ID"
--base-plan yearly
--json @migration.json
undefined

4. Verify migration

4. 验证迁移结果

bash
gplay subscriptions get --package "PACKAGE" --product-id "PRODUCT_ID"
bash
gplay subscriptions get --package "PACKAGE" --product-id "PRODUCT_ID"

Updating Existing PPP Prices

更新现有PPP价格

To change a region's price:
  1. Get the current product/subscription to see existing prices.
  2. Recompute the PPP-adjusted price with the new base price or new multiplier.
  3. Update with the modified JSON (include all regions, not just the changed ones).
  4. For subscriptions with active subscribers, run
    migrate-prices
    for each affected base plan.
  5. Verify with a fetch + summary review.
如需更改某区域的价格:
  1. 获取当前产品/订阅详情,查看现有价格。
  2. 使用新的基准价格或新乘数重新计算经PPP调整的价格。
  3. 使用修改后的JSON进行更新(需包含所有区域,而非仅更改的区域)。
  4. 对于有活跃订阅用户的订阅产品,为每个受影响的基础套餐执行
    migrate-prices
    命令。
  5. 通过获取详情并检查摘要来验证。

Batch PPP for Multiple Products

为多个产品批量设置PPP价格

Multiple IAPs

多个应用内产品

bash
undefined
bash
undefined

Build a JSON file with PPP prices for each SKU

构建包含每个SKU的PPP价格的JSON文件

gplay iap batch-update
--package "PACKAGE"
--json @ppp-all-iaps.json
undefined
gplay iap batch-update
--package "PACKAGE"
--json @ppp-all-iaps.json
undefined

Multiple subscriptions

多个订阅产品

Update each subscription individually:
bash
gplay subscriptions update --package "PACKAGE" --product-id "sub_1" --json @ppp-sub1.json
gplay subscriptions update --package "PACKAGE" --product-id "sub_2" --json @ppp-sub2.json
逐个更新每个订阅产品:
bash
gplay subscriptions update --package "PACKAGE" --product-id "sub_1" --json @ppp-sub1.json
gplay subscriptions update --package "PACKAGE" --product-id "sub_2" --json @ppp-sub2.json

Common PPP Strategies

常见PPP策略

BigMac Index Approach

巨无霸指数法

Adjust prices based on relative purchasing power:
  • USA: $9.99 (baseline)
  • India: $2.99 (~70% discount)
  • Brazil: $4.99 (~50% discount)
  • UK: $9.99 (similar)
  • Switzerland: $10.99 (premium)
基于相对购买力调整价格:
  • 美国:9.99美元(基准)
  • 印度:2.99美元(约70%折扣)
  • 巴西:4.99美元(约50%折扣)
  • 英国:9.99美元(与基准持平)
  • 瑞士:10.99美元(溢价)

Tiered Regional Pricing

分层区域定价

Group countries into pricing tiers:
  • Tier 1 (Full): USA, UK, Germany, Australia, Switzerland, Canada
  • Tier 2 (Medium): France, Spain, Italy, Japan, South Korea, Saudi Arabia
  • Tier 3 (Low): India, Brazil, Mexico, Indonesia, Turkey, Vietnam, Egypt
将国家划分为定价层级:
  • 第一层(全价):美国、英国、德国、澳大利亚、瑞士、加拿大
  • 第二层(中等价位):法国、西班牙、意大利、日本、韩国、沙特阿拉伯
  • 第三层(低价):印度、巴西、墨西哥、印度尼西亚、土耳其、越南、埃及

Revenue Optimization

收益优化

  • Start with Tier 3 discounts to capture volume in price-sensitive markets.
  • Monitor conversion rates per region after applying PPP.
  • Adjust multipliers based on actual revenue data.
  • 从第三层折扣开始,在价格敏感型市场获取用户量。
  • 应用PPP后监控各区域的转化率。
  • 根据实际收益数据调整乘数。

Notes

注意事项

  • Price changes for subscriptions apply immediately to new subscribers.
  • Existing subscribers require explicit price migration via
    migrate-prices
    .
  • Use
    gplay pricing convert
    for currency conversion reference, but apply PPP multipliers on top.
  • Always verify prices after updates by fetching the product and reviewing the summary.
  • The PPP multiplier table provides starting points — adjust based on your market data and revenue goals.
  • 订阅产品的价格变更会立即应用于新订阅用户。
  • 现有订阅用户需要通过
    migrate-prices
    命令进行显式价格迁移。
  • 可使用
    gplay pricing convert
    作为货币转换参考,但需在此基础上应用PPP乘数。
  • 更新后务必通过获取产品详情并检查摘要来验证价格。
  • PPP乘数表提供的是起始参考值,需根据你的市场数据和收益目标进行调整。