プロダクトとプロダクトオファーのコマンド

これらの Adapty CLI コマンドは、プロダクト の管理、App Store および Google Play のプロダクト ID へのマッピング、ストアオファーとの紐付けを行います。

プロダクト

adapty products list

アプリの全プロダクトを一覧表示します。

adapty products list --app <app-id>
フラグ必須説明
--appはいアプリID(UUID)

ページネーションフラグを使用できます。

adapty products get

特定のプロダクトの詳細を取得します。

adapty products get --app <app-id> <product-id>
引数説明
product-idプロダクト ID(UUID)
フラグ必須説明
--appはいアプリ ID(UUID)

adapty products create

新しいプロダクトを作成します。

Important

ストアプロダクトと価格 ID は作成後に変更できません。別のストア ID を使用するには、新しいプロダクトを作成してください。

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly
フラグ必須説明
--appはいアプリ ID(UUID)
--titleはいプロダクトのタイトル
--access-level-idはいこのプロダクトが解除するアクセスレベル ID(UUID)
--periodはいサブスクリプション期間:weekly、monthly、two_months、trimonthly、semiannual、annual、lifetime
--ios-product-idいずれか1つのストアが必須App Store Connect のプロダクト ID
--android-product-idいずれか1つのストアが必須Google Play Console のプロダクト ID
--android-base-plan-id--period lifetime でない場合、--android-product-id と共に必須Google Play Console のベースプラン ID
--stripe-product-idいずれか1つのストアが必須Stripe のプロダクト ID
--stripe-price-id--stripe-product-id と共に必須Stripe の価格 ID
--paddle-product-idいずれか1つのストアが必須Paddle のプロダクト ID
--paddle-price-id--paddle-product-id と共に必須Paddle の価格 ID

すべてのプロダクトには少なくとも1つのストアが必要です: --ios-product-id、--android-product-id、--stripe-product-id、または --paddle-product-id。1つのプロダクトに複数のストアのIDをまとめて設定することもできます。

Stripe や Paddle を通じてウェブでプロダクトを販売するには、まず決済プロバイダーを Adapty に接続してください: Stripe および Paddle を参照。これらのストアでは、プロダクト ID と価格 ID をセットで渡す必要があります。どちらか一方のみを渡した場合、コマンドはエラーになります。

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --stripe-product-id prod_xxx --stripe-price-id price_xxx

ウェブ専用のプロダクトも有効です。App Store や Google Play の ID がなくても、Stripe または Paddle の ID のみを使用してプロダクトを作成できます。

adapty products update

既存のプロダクトを更新します。

ストアのプロダクトIDと価格IDは作成後に変更できないため、このコマンドでは利用できません。異なるストアIDを使用するには、新しいプロダクトを作成してください。

adapty products update --app <app-id> <product-id> --title "Monthly" --access-level-id <access-level-id>
引数説明
product-idプロダクトID(UUID)
フラグ必須説明
--appはいアプリ ID(UUID)
--titleいいえプロダクトのタイトル
--access-level-idいいえこのプロダクトがアンロックするアクセスレベル ID(UUID)

プロダクトオファー

App Store Connect または Google Play Console で作成したオファーを Adapty のプロダクトに紐付けることで、Adapty がオファーを適用できるようになります。各オファータイプの詳細や、ストアでのオファー作成方法については、Adapty にオファーを追加するを参照してください。

以下のオファーを追加してください:

  • App Store のプロモーションオファーおよびウィンバックオファー。
  • 無料トライアルを含む、すべての Google Play オファー。Google Play には初回オファーという概念がないため、トライアルはベースプランへのオファーとして扱われ、Adapty で紐付けを行って初めて適用されます。

App Store の初回オファーは追加不要です。対象ユーザーに自動的に適用されます。

リンクされたオファーは、ユーザーに表示される前に、フローまたはペイウォール内のプロダクトで選択される必要があります。ペイウォールで選択するには、Adapty ダッシュボードを使用してください。詳しくは オファーを表示する をご覧ください。

adapty products list と adapty products get では、各プロダクトにリンクされているオファーの数を offers_count で確認できます。この数にはAdapty でリンクされたオファーのみが含まれ、ストアに存在するオファーは含まれません。

adapty product-offers list

プロダクトに紐づくすべてのオファーを一覧表示します。

adapty product-offers list --app <app-id> --product <product-id>
フラグ必須説明
--appはいアプリID(UUID)
--productはいプロダクトID(UUID)

すべてのオファーを1ページで返し、ページネーションフラグは使用できません。

adapty product-offers get

特定のオファーの詳細を取得します。

adapty product-offers get --app <app-id> <offer-id>
引数説明
offer-idオファー ID(UUID)
フラグ必須説明
--appはいアプリ ID(UUID)

adapty product-offers create

プロダクトにストアオファーをリンクします。

adapty product-offers create --app <app-id> --product <product-id> --title "Spring" --type promotional --ios-offer-id spring_ios --android-offer-id spring-android
フラグ必須説明
--app必須アプリID(UUID)
--product必須プロダクトID(UUID)
--title必須オファー名(Adapty ダッシュボードにのみ表示)
--type必須オファータイプ:promotional または win_back
--ios-offer-id少なくとも1つのストアが必須App Store ConnectのオファーID
--android-offer-id少なくとも1つのストアが必須Google Play ConsoleのオファーID

ウィンバックオファーはApp Store専用のため、--type win_back は --ios-offer-id のみを使用します。Google Playのオファー(無料トライアルを含む)はすべて --type promotional を使用してください。

adapty product-offers create --app <app-id> --product <product-id> --title "Come back" --type win_back --ios-offer-id winback_ios

adapty product-offers update

既存のオファーを更新します。

adapty product-offers update --app <app-id> <offer-id> --title "Spring 2"
引数説明
offer-idオファーID(UUID)
フラグ必須説明
--appはいアプリID(UUID)
--titleいいえオファー名
--typeいいえオファータイプ:promotional(プロモーションオファー)または win_back(ウィンバックオファー)。オファーを win_back に変更するには、--clear-android-offer-id を使用してGoogle Play側も削除してください
--ios-offer-idいいえ新しいApp StoreのオファーID
--android-offer-idいいえ新しいGoogle PlayのオファーID
--clear-ios-offer-idいいえオファーのApp Store側を削除する
--clear-android-offer-idいいえオファーのGoogle Play側を削除する

--app 以外のフラグを少なくとも1つ指定する必要があります。省略したフィールドは現在の値が維持されます。オファーには必ず1つ以上のストアオファーIDが必要なため、最後の1つを削除しようとするとコマンドは失敗します。

Warning

このコマンドはオファーを読み取り、まるごと保存します。読み取りから保存までの間に誰かが Adapty ダッシュボードで同じオファーを編集した場合、その変更は上書きされます。

初回オファーは更新できません。App Store または Google Play 以外のストアのオファーも、CLI からは更新できません。その場合は Adapty ダッシュボードで編集してください。

オファーを削除するには、Adapty ダッシュボードを使用してください。CLIには削除コマンドがありません。

次のステップ