App Store Connect CLI PPP定价技能：按区域定价与购买力平价策略指南

asc-ppp-pricing by rudrankriyam/app-store-connect-cli-skills

1,200 周安装量

588 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/rudrankriyam/app-store-connect-cli-skills --skill asc-ppp-pricing

开发产品管理

🇨🇳中文介绍

PPP 定价（按区域定价）

使用此技能基于购买力平价（PPP）或您自己的区域定价策略，创建或更新跨区域的本地化定价。

推荐使用当前的高级流程：

创建新产品时使用 asc subscriptions setup 和 asc iap setup
更改订阅定价时使用 asc subscriptions pricing ...
更改应用内购买定价时使用 asc iap pricing summary 和 asc iap pricing schedules ...

前提条件

确保已设置凭据（使用 asc auth login 或 ASC_* 环境变量）。
推荐使用 ASC_APP_ID 或显式传递参数。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

订阅 PPP 工作流程

新订阅：使用 `setup` 引导创建

当您创建新订阅并希望在一个经过验证的流程中创建组、订阅、首次本地化、初始价格和可用性时，请使用 setup。

asc subscriptions setup \
  --app "APP_ID" \
  --group-reference-name "Pro" \
  --reference-name "Pro Monthly" \
  --product-id "com.example.pro.monthly" \
  --subscription-period ONE_MONTH \
  --locale "en-US" \
  --display-name "Pro Monthly" \
  --description "Unlock everything" \
  --price "9.99" \
  --price-territory "USA" \
  --territories "USA,CAN,GBR" \
  --output json

setup 默认会验证创建的状态。
仅当您明确希望速度优先于回读验证时，才使用 --no-verify。
当您的工作流程是基于定价等级驱动时，请使用 --tier 或 --price-point-id 代替 --price。

在更改前检查当前订阅定价

当您需要当前状态的简洁快照时，请首先使用摘要视图。

asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "USA"
asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "IND"
asc subscriptions pricing prices list --subscription-id "SUB_ID" --paginate

使用 summary 进行快速的前后抽查，当您需要原始价格记录时使用 prices list。

推荐批量 PPP 更新：使用试运行模式导入 CSV

对于广泛的 PPP 部署，推荐使用订阅定价导入命令，而不是手动逐个添加区域价格。

territory,price,start_date,preserved
IND,2.99,2026-04-01,false
BRA,4.99,2026-04-01,false
MEX,4.99,2026-04-01,false
DEU,8.99,2026-04-01,false

首先进行试运行：

asc subscriptions pricing prices import \
  --subscription-id "SUB_ID" \
  --input "./ppp-prices.csv" \
  --dry-run \
  --output table

asc subscriptions pricing prices import \
  --subscription-id "SUB_ID" \
  --input "./ppp-prices.csv" \
  --output table

--dry-run 会验证行并解析价格点，但不会创建价格。
--continue-on-error=false 为您提供快速失败模式。
CSV 必需列：territory, price
CSV 可选列：currency_code, start_date, preserved, preserve_current_price, price_point_id
当省略 price_point_id 时，CLI 会自动为行的区域和价格解析匹配的价格点。
导入中的区域输入可以是 3 字母 ID、2 字母代码或能清晰映射的常见区域名称。

一次性订阅区域更改

对于少量手动覆盖，请使用规范的 set 命令。

asc subscriptions pricing prices set --subscription-id "SUB_ID" --price "2.99" --territory "IND"
asc subscriptions pricing prices set --subscription-id "SUB_ID" --tier 5 --territory "BRA"
asc subscriptions pricing prices set --subscription-id "SUB_ID" --price-point "PRICE_POINT_ID" --territory "DEU"

添加 --start-date "YYYY-MM-DD" 以安排未来的更改。
当您希望保持当前价格关系时，添加 --preserved。
该命令处理初始定价和后续的价格更改。

仅在需要时查找原始价格点

当您想要直接检查 Apple 的本地化价格阶梯或固定确切的价格点 ID 时，请使用价格点查找和等价命令。

asc subscriptions pricing price-points list --subscription-id "SUB_ID" --territory "USA" --paginate --price "9.99"
asc subscriptions pricing price-points equalizations --price-point-id "PRICE_POINT_ID" --paginate

更改后重新运行摘要和原始列表视图。

asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "IND"
asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "BRA"
asc subscriptions pricing prices list --subscription-id "SUB_ID" --paginate

如果订阅是新创建的，您也可以使用启用了验证的 asc subscriptions setup，而不是将单独的创建和定价步骤拼接在一起。

如果您需要为现有订阅显式启用区域，请使用定价可用性系列命令。

asc subscriptions pricing availability edit --subscription-id "SUB_ID" --territories "USA,CAN,IND,BRA"
asc subscriptions pricing availability view --subscription-id "SUB_ID"

应用内购买 PPP 工作流程

新应用内购买：使用 `setup` 引导创建

当您创建新的应用内购买并希望在一个经过验证的流程中创建产品、首次本地化和初始价格计划时，请使用 setup。

asc iap setup \
  --app "APP_ID" \
  --type NON_CONSUMABLE \
  --reference-name "Pro Lifetime" \
  --product-id "com.example.pro.lifetime" \
  --locale "en-US" \
  --display-name "Pro Lifetime" \
  --description "Unlock everything forever" \
  --price "9.99" \
  --base-territory "USA" \
  --output json

setup 默认会验证创建的应用内购买、本地化和价格计划。
使用 --start-date 安排计划定价。
当您希望进行基于定价等级或 ID 的确定性设置时，请使用 --tier 或 --price-point-id。

在更改前检查当前应用内购买定价

使用 asc iap pricing summary 作为 PPP 工作的主要当前状态摘要。

asc iap pricing summary --iap-id "IAP_ID" --territory "USA"
asc iap pricing summary --iap-id "IAP_ID" --territory "IND"

这将返回所请求区域的基础区域、当前价格、预估收益和计划中的更改。

查找候选应用内购买价格点

当您想要检查或固定确切的价格点 ID 时，请使用价格点查找命令。

asc iap pricing price-points list --iap-id "IAP_ID" --territory "USA" --paginate --price "9.99"
asc iap pricing price-points equalizations --id "PRICE_POINT_ID"

创建或更新应用内购买价格计划

对于手动 PPP 更新，直接创建价格计划。

asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --price "4.99" --start-date "2026-04-01"
asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --tier 5 --start-date "2026-04-01"
asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --prices "PRICE_POINT_ID:2026-04-01"

当您有意创建或替换计划条目时使用这些命令。如需更深入的检查：

asc iap pricing schedules view --iap-id "IAP_ID"
asc iap pricing schedules manual-prices --schedule-id "SCHEDULE_ID" --paginate
asc iap pricing schedules automatic-prices --schedule-id "SCHEDULE_ID" --paginate

在安排或应用定价更改后，再次使用摘要命令。

asc iap pricing summary --iap-id "IAP_ID" --territory "USA"
asc iap pricing summary --iap-id "IAP_ID" --territory "IND"

对于未来日期的计划，预计会有计划中的更改，而不是立即更新的当前价格。

常见 PPP 策略模式

选择一个基准区域，通常是 USA。
首先在那里设置基准价格。
从该基准价格推导出其他区域的目标价格（更低或更高）。

高收入市场保持接近基准价格。
中等收入市场获得适度折扣。
低收入市场获得更强的 PPP 调整。

电子表格驱动部署

在 CSV 中构建目标区域列表。
对导入进行试运行。
修复任何解析失败。
应用导入。
为最重要的区域重新运行摘要检查。

在文档和自动化中推荐使用规范命令：asc subscriptions pricing ...
旧的 asc subscriptions prices ... 路径仍然存在，但规范的定价系列命令更清晰。
在文档和自动化中推荐使用规范的应用内购买命令：asc iap pricing ...
asc subscriptions pricing prices import --dry-run 是目前最安全的订阅批量 PPP 路径。
asc subscriptions setup 和 asc iap setup 已经提供了内置的创建后验证。
目前还没有一个单一的一流的 PPP 前后差异比较命令；请在应用前后使用当前的摘要命令。
价格更改在 App Store Connect 和商店前端可能需要时间才能生效。

2026 年 1 月 31 日

🇺🇸English

PPP pricing (per-territory pricing)

Use this skill to create or update localized pricing across territories based on purchasing power parity (PPP) or your own regional pricing strategy.

Prefer the current high-level flows:

asc subscriptions setup and asc iap setup when you are creating a new product
asc subscriptions pricing ... for subscription pricing changes
asc iap pricing summary and asc iap pricing schedules ... for IAP pricing changes

Preconditions

Ensure credentials are set (asc auth login or ASC_* env vars).
Prefer ASC_APP_ID or pass --app explicitly.
Decide your base territory (usually USA) and baseline price.
Use asc pricing territories list --paginate if you need supported territory IDs.

Subscription PPP workflow

New subscription: bootstrap with `setup`

Use setup when you are creating a new subscription and want to create the group, subscription, first localization, initial price, and availability in one verified flow.

asc subscriptions setup \
  --app "APP_ID" \
  --group-reference-name "Pro" \
  --reference-name "Pro Monthly" \
  --product-id "com.example.pro.monthly" \
  --subscription-period ONE_MONTH \
  --locale "en-US" \
  --display-name "Pro Monthly" \
  --description "Unlock everything" \
  --price "9.99" \
  --price-territory "USA" \
  --territories "USA,CAN,GBR" \
  --output json

Notes:

setup verifies the created state by default.
Use --no-verify only when you explicitly want speed over readback verification.
Use --tier or --price-point-id instead of --price when your workflow is tier-driven.

Inspect current subscription pricing before changes

Use the summary view first when you want a compact current-state snapshot.

asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "USA"
asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "IND"
asc subscriptions pricing prices list --subscription-id "SUB_ID" --paginate

Use summary for quick before/after spot checks and prices list when you need raw price records.

Preferred bulk PPP update: import a CSV with dry run

For broad PPP rollouts, prefer the subscription pricing import command instead of manually adding territory prices one by one.

Example CSV:

territory,price,start_date,preserved
IND,2.99,2026-04-01,false
BRA,4.99,2026-04-01,false
MEX,4.99,2026-04-01,false
DEU,8.99,2026-04-01,false

Dry-run first:

asc subscriptions pricing prices import \
  --subscription-id "SUB_ID" \
  --input "./ppp-prices.csv" \
  --dry-run \
  --output table

Apply for real:

asc subscriptions pricing prices import \
  --subscription-id "SUB_ID" \
  --input "./ppp-prices.csv" \
  --output table

Notes:

--dry-run validates rows and resolves price points without creating prices.
--continue-on-error=false gives you a fail-fast mode.
CSV required columns: territory, price
CSV optional columns: currency_code, start_date, preserved, preserve_current_price, price_point_id
When price_point_id is omitted, the CLI resolves the matching price point for the row's territory and price automatically.

One-off subscription territory changes

For a small number of manual overrides, use the canonical set command.

asc subscriptions pricing prices set --subscription-id "SUB_ID" --price "2.99" --territory "IND"
asc subscriptions pricing prices set --subscription-id "SUB_ID" --tier 5 --territory "BRA"
asc subscriptions pricing prices set --subscription-id "SUB_ID" --price-point "PRICE_POINT_ID" --territory "DEU"

Notes:

Add --start-date "YYYY-MM-DD" to schedule a future change.
Add --preserved when you want to preserve the current price relationship.
The command handles both initial pricing and later price changes.

Discover raw price points only when you need them

Use price-point lookup and equalizations when you want to inspect Apple's localized ladder directly or pin exact price point IDs.

asc subscriptions pricing price-points list --subscription-id "SUB_ID" --territory "USA" --paginate --price "9.99"
asc subscriptions pricing price-points equalizations --price-point-id "PRICE_POINT_ID" --paginate

Verify after apply

Re-run the summary and raw list views after changes.

asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "IND"
asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "BRA"
asc subscriptions pricing prices list --subscription-id "SUB_ID" --paginate

If the subscription was newly created, you can also use asc subscriptions setup with verification enabled instead of stitching together separate create and pricing steps.

Subscription availability

If you need to explicitly enable territories for an existing subscription, use the pricing availability family.

asc subscriptions pricing availability edit --subscription-id "SUB_ID" --territories "USA,CAN,IND,BRA"
asc subscriptions pricing availability view --subscription-id "SUB_ID"

IAP PPP workflow

New IAP: bootstrap with `setup`

Use setup when you are creating a new IAP and want to create the product, first localization, and initial price schedule in one verified flow.

asc iap setup \
  --app "APP_ID" \
  --type NON_CONSUMABLE \
  --reference-name "Pro Lifetime" \
  --product-id "com.example.pro.lifetime" \
  --locale "en-US" \
  --display-name "Pro Lifetime" \
  --description "Unlock everything forever" \
  --price "9.99" \
  --base-territory "USA" \
  --output json

Notes:

setup verifies the created IAP, localization, and price schedule by default.
Use --start-date for scheduled pricing.
Use --tier or --price-point-id when you want deterministic tier- or ID-based setup.

Inspect current IAP pricing before changes

Use asc iap pricing summary as the main current-state summary for PPP work.

asc iap pricing summary --iap-id "IAP_ID" --territory "USA"
asc iap pricing summary --iap-id "IAP_ID" --territory "IND"

This returns the base territory, current price, estimated proceeds, and scheduled changes for the requested territory.

Discover candidate IAP price points

Use price-point lookup when you want to inspect or pin exact price point IDs.

asc iap pricing price-points list --iap-id "IAP_ID" --territory "USA" --paginate --price "9.99"
asc iap pricing price-points equalizations --id "PRICE_POINT_ID"

Create or update an IAP price schedule

For manual PPP updates, create a price schedule directly.

asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --price "4.99" --start-date "2026-04-01"
asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --tier 5 --start-date "2026-04-01"
asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --prices "PRICE_POINT_ID:2026-04-01"

Use these when you are intentionally creating or replacing schedule entries. For deeper inspection:

asc iap pricing schedules view --iap-id "IAP_ID"
asc iap pricing schedules manual-prices --schedule-id "SCHEDULE_ID" --paginate
asc iap pricing schedules automatic-prices --schedule-id "SCHEDULE_ID" --paginate

Verify after apply

Use the summary command again after scheduling or applying pricing changes.

asc iap pricing summary --iap-id "IAP_ID" --territory "USA"
asc iap pricing summary --iap-id "IAP_ID" --territory "IND"

For future-dated schedules, expect scheduled changes rather than an immediately updated current price.

Common PPP strategy patterns

Base territory first

Pick one baseline territory, usually USA.
Set the baseline price there first.
Derive lower or higher territory targets from that baseline.

Tiered regional pricing

High-income markets stay close to baseline.
Mid-income markets get moderate discounts.
Lower-income markets get stronger PPP adjustments.

Spreadsheet-driven rollout

Build the target territory list in a CSV.
Dry-run the import.
Fix any resolution failures.
Apply the import.
Re-run summary checks for the most important territories.

Notes

Prefer canonical commands in docs and automation: asc subscriptions pricing ...
Older asc subscriptions prices ... paths still exist, but the canonical pricing family is clearer.
Prefer canonical IAP commands in docs and automation: asc iap pricing ...
asc subscriptions pricing prices import --dry-run is the safest subscription batch PPP path today.
asc subscriptions setup and asc iap setup already provide built-in post-create verification.
There is not yet a single first-class before/after PPP diff command; use the current summary commands before and after apply.
Price changes may take time to propagate in App Store Connect and storefronts.

Weekly Installs

1.2K

Repository

rudrankriyam/ap…i-skills

GitHub Stars

588

First Seen

Jan 31, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex1.1K

opencode1.1K

gemini-cli1.1K

github-copilot1.1K

kimi-cli1.1K

amp1.1K

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装

Territory inputs in import can be 3-letter IDs, 2-letter codes, or common territory names that map cleanly.

App Store Connect CLI PPP定价技能：按区域定价与购买力平价策略指南

🇨🇳中文介绍

PPP 定价（按区域定价）

前提条件

相关 Skills

订阅 PPP 工作流程

新订阅：使用 setup 引导创建

在更改前检查当前订阅定价

推荐批量 PPP 更新：使用试运行模式导入 CSV

一次性订阅区域更改

仅在需要时查找原始价格点

应用后验证

订阅可用性

应用内购买 PPP 工作流程

新应用内购买：使用 setup 引导创建

在更改前检查当前应用内购买定价

查找候选应用内购买价格点

创建或更新应用内购买价格计划

应用后验证

常见 PPP 策略模式

基础区域优先

分层区域定价

电子表格驱动部署

注意事项

🇺🇸English

PPP pricing (per-territory pricing)

Preconditions

Subscription PPP workflow

New subscription: bootstrap with setup

Inspect current subscription pricing before changes

Preferred bulk PPP update: import a CSV with dry run

One-off subscription territory changes

Discover raw price points only when you need them

Verify after apply

Subscription availability

IAP PPP workflow

New IAP: bootstrap with setup

Inspect current IAP pricing before changes

Discover candidate IAP price points

Create or update an IAP price schedule

Verify after apply

Common PPP strategy patterns

Base territory first

Tiered regional pricing

Spreadsheet-driven rollout

Notes

最新 Skills

新订阅：使用 `setup` 引导创建

新应用内购买：使用 `setup` 引导创建

New subscription: bootstrap with `setup`

New IAP: bootstrap with `setup`