App Store Connect PPP定价工具：按地区定价与订阅价格批量管理

asc-ppp-pricing by rudrankriyam/asc-skills

226 周安装量

573 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/rudrankriyam/asc-skills --skill asc-ppp-pricing

iOS 开发 SaaS

🇨🇳中文介绍

PPP 定价（按地区定价）

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

优先使用当前的高级流程：

创建新产品时，使用 asc subscriptions setup 和 asc iap setup
订阅价格变更时，使用 asc subscriptions pricing ...
IAP 价格变更时，使用 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"

IAP PPP 工作流程

新建 IAP：使用 `setup` 引导

当您创建新的 IAP 并希望在一个经过验证的流程中创建产品、首次本地化和初始价格计划时，请使用 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 默认会验证创建的 IAP、本地化和价格计划。
使用 --start-date 来安排计划定价。
当您希望进行基于定价层级或 ID 的确定性设置时，请使用 --tier 或 --price-point-id。

在变更前检查当前 IAP 定价

使用 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"

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

发现候选 IAP 价格点

当您希望检查或固定确切的价格点 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"

创建或更新 IAP 价格计划

对于手动 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 ... 路径仍然存在，但规范的定价系列命令更清晰。
在文档和自动化中优先使用规范的 IAP 命令：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

226

Repository

rudrankriyam/asc-skills

GitHub Stars

573

First Seen

Jan 31, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex214

opencode194

gemini-cli193

kimi-cli191

github-copilot191

amp190

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

107,800 周安装

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

App Store Connect PPP定价工具：按地区定价与订阅价格批量管理

🇨🇳中文介绍

PPP 定价（按地区定价）

前提条件

相关 Skills

订阅 PPP 工作流程

新建订阅：使用 setup 引导

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

首选的批量 PPP 更新：使用试运行模式导入 CSV

一次性订阅地区变更

仅在需要时发现原始价格点

应用后验证

订阅可用性

IAP PPP 工作流程

新建 IAP：使用 setup 引导

在变更前检查当前 IAP 定价

发现候选 IAP 价格点

创建或更新 IAP 价格计划

应用后验证

常见的 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` 引导

新建 IAP：使用 `setup` 引导

New subscription: bootstrap with `setup`

New IAP: bootstrap with `setup`