PPP pricing (per-territory pricing)

このスキルを使用して、購買力平価 (PPP) またはあなた独自の地域別価格戦略に基づいて、複数の地域にわたるローカライズされた価格を作成または更新します。

以下の高レベルのフローを優先してください:

• asc subscriptions setup と asc iap setup - 新しい商品を作成する場合
• asc subscriptions pricing ... - サブスクリプション価格の変更の場合
• asc iap pricing summary と asc iap pricing schedules ... - IAP 価格の変更の場合

前提条件

• 認証情報が設定されていることを確認してください (asc auth login または ASC_* 環境変数)。
• ASC_APP_ID を優先するか、明示的に --app を渡してください。
• ベース地域 (通常は USA) とベース価格を決定してください。
• サポートされている地域 ID が必要な場合は asc pricing territories list --paginate を使用してください。

サブスクリプション PPP ワークフロー

新しいサブスクリプション: setup でのブートストラップ

setup を使用して、新しいサブスクリプションを作成し、グループ、サブスクリプション、最初のローカライゼーション、初期価格、および可用性を 1 つの検証されたフローで作成します。

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 を使用してください。
• ワークフローがティアドリブンの場合は --price の代わりに --tier または --price-point-id を使用してください。

変更前の現在のサブスクリプション価格を検査

現在の状態のスナップショットが必要な場合は、まずサマリービューを使用してください。

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 ロールアウトの場合は、地域別価格を 1 つずつ手動で追加するのではなく、サブスクリプション価格インポートコマンドを優先してください。

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

まずドライランを実行:

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 文字のコード、またはきれいにマップされる一般的な地域名です。

1 回限りのサブスクリプション地域変更

少数の手動オーバーライドの場合は、canonical 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 でのブートストラップ

setup を使用して、新しい IAP を作成し、商品、最初のローカライゼーション、および初期価格スケジュールを 1 つの検証されたフローで作成します。

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 価格を検査

PPP 作業のメインの現在の状態サマリーとして asc iap pricing summary を使用してください。

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 戦略パターン

まずベース地域

• 1 つのベース地域を選択します。通常は USA です。
• そこでまずベース価格を設定します。
• そのベースラインから他の地域のターゲットを導き出します。

ティアード地域価格

• 高所得市場はベースラインに近いままです。
• 中所得市場は中程度の割引を受けます。
• 低所得市場はより強い PPP 調整を受けます。

スプレッドシートドリブンロールアウト

• CSV でターゲット地域リストを作成します。
• インポートをドライランします。
• 解決の失敗を修正します。
• インポートを適用します。
• 最も重要な地域のサマリーチェックを再度実行します。

注記

• ドキュメントと自動化では canonical コマンドを優先してください: asc subscriptions pricing ...
• 古い asc subscriptions prices ... パスはまだ存在しますが、canonical pricing ファミリーはより明確です。
• ドキュメントと自動化では canonical IAP コマンドを優先してください: asc iap pricing ...
• asc subscriptions pricing prices import --dry-run は今日最も安全なサブスクリプション一括 PPP パスです。
• asc subscriptions setup と asc iap setup には既にビルトイン の作成後検証が備わっています。
• まだ単一のファーストクラスの前/後 PPP diff コマンドはありません。適用前後に現在のサマリーコマンドを使用してください。
• 価格変更は App Store Connect とストアフロント内に伝播するのに時間がかかることがあります。