mcpField
A
asc-promoted-purchases

asc-promoted-purchases

github.com/tddworksマーケティング・グロース560 回インストール5 週間前に更新
リポジトリ

asc-promoted-purchases について

asc-promoted-purchasesは、App Storeの商品ページでプロモーションするアプリ内購入を管理するスキルです。開発者向けに一覧・作成・更新・削除を提供し、審査状態に応じて競合し得る操作を表示しません。

主な機能

  1. 01アプリのプロモーション購入を一覧表示
  2. 02アプリ内購入または自動更新サブスクリプションを掲載
  3. 03表示状態と有効状態を設定
  4. 04プロモーション項目を更新・削除
  5. 05審査状態に応じて操作を制限

活用シーン

  1. 01アプリで掲載中のプロモーション購入を確認
  2. 02商品ページで購入項目やサブスクリプションを紹介
  3. 03審査中に許可されない更新や削除を回避

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tddworks/asc-cli-skills --skill asc-promoted-purchases

インストール後、Claude Code で/asc-promoted-purchasesを入力して読み込まれたか確認します。

詳細

asc プロモーション対象の購入

App Store の製品ページでプロモーション対象となっている App 内課金を管理します。これは、App Store のアプリの製品ページに表示される、注目の IAP または自動更新サブスクリプションです。各枠では IAP またはサブスクリプションのいずれか一方（相互排他）をプロモーションし、元の商品とは別に App Review を受けます。

一覧

asc promoted-purchases list --app-id <APP_ID> [--limit N] [--pretty]

作成

--iap-id または --subscription-id のいずれか一方が必須です（コマンドは両方が指定された場合、またはいずれも指定されなかった場合に検証して拒否します）。

# Promote an in-app purchase
asc promoted-purchases create --app-id <APP_ID> --iap-id <IAP_ID> --visible --enabled

# Promote an auto-renewable subscription
asc promoted-purchases create --app-id <APP_ID> --subscription-id <SUB_ID> --hidden --disabled

--visible / --hidden は isVisibleForAllUsers を切り替えます。--enabled / --disabled は isEnabled を切り替えます。デフォルト値：isVisibleForAllUsers=true、両方のフラグが省略された場合、isEnabled は変更されません。

更新

asc promoted-purchases update --promoted-id <PROMOTED_ID> [--visible | --hidden] [--enabled | --disabled]

フラグのペアを省略すると、そのフィールドは変更されません。

削除

asc promoted-purchases delete --promoted-id <PROMOTED_ID>

状態の意味

PromotedPurchaseState は、次の意味を持つブール値を公開します。

ブール値状態が次の場合に true
isLockedWAITING_FOR_REVIEW、IN_REVIEW
isApprovedAPPROVED

状態に応じた操作

JSON レスポンスでは、ASC が 409 の競合として拒否する変更操作を表示しません。

状態update リンクdelete リンク
approved / rejected / prepareForSubmission / developerActionNeeded表示表示
waitingForReview / inReview（つまり state.isLocked）非表示非表示
{
  "affordances": {
    "listSiblings": "asc promoted-purchases list --app-id <APP_ID>",
    "update":       "asc promoted-purchases update --promoted-id <ID>",   // omitted while in review
    "delete":       "asc promoted-purchases delete --promoted-id <ID>"    // omitted while in review
  }
}

App ID の解決

project-context.md を参照してください。ユーザーに尋ねたり asc apps list を実行したりする前に .asc/project.json を確認してください。

一般的なワークフロー

APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')

# Promote an IAP, visible to all users, slot enabled.
PROMO_ID=$(asc promoted-purchases create --app-id "$APP_ID" \
  --iap-id "iap-1" --visible --enabled \
  | jq -r '.data[0].id')

# Later: hide it temporarily without deleting
asc promoted-purchases update --promoted-id "$PROMO_ID" --hidden

# Or just remove the slot
asc promoted-purchases delete --promoted-id "$PROMO_ID"

リファレンス

ドメインモデルと REST の詳細については、docs/features/promoted-purchases.md を参照してください。

コメント

Markdown 対応