アプリ内課金キーをAdaptyに追加する

Adaptyはアプリ内課金キーを使用して、アプリ内の購入を検証し、プロモーションオファーに署名します。App Store Connectでキーを生成し、Adaptyの App settings の2つのセクションに入力してください。キーが機能しなくなったり変更が必要になった場合は、キーを交換してください。

アプリ内購入キーは App Store Connect APIキー とは異なりますが、App Store Connect では両方のキーのIDに Issuer ID と Key ID というラベルが付いています。

App settings > iOS SDK にすべての認証情報をまとめて入力するには、App Store連携の設定 を参照してください。

App Store Connect でキーを生成する

  1. App Store Connectで、Users and Access > Integrations > In-App Purchaseに移動します。

    1つのキーでApp Store Connectチームのすべてのアプリに使用できます。このページのアクティブなキーを再利用するには、そのファイルが必要です。ファイルがあれば、ステップ2〜4はスキップしてください。新しいキーを生成しても、既存のアクティブなキーは引き続き使用できます。

  2. キーを生成するには、App Store ConnectでAccount HolderまたはAdmin権限が必要です。どちらの権限もない場合は、権限を持つ方にキーの生成を依頼し、Issuer IDとKey IDとともにファイルを送ってもらってください。

    ページにすでにアクティブなキーが表示されている場合は + をクリックします。表示されていない場合は Generate In-App Purchase Key をクリックします。

    In-App Purchase keys page in App Store Connect, with the button that adds a key
  3. キーの名前を入力し、Generate をクリックします。キーが Active リストに表示されます。

    Generate In-App Purchase Key dialog with a name for the key and the Generate button
  4. 各キーのダウンロードは1回のみ可能です。新しいキーの横にある Download In-App Purchase Key をクリックします。

    Active list of In-App Purchase keys, with the download link next to a new key

    次に、ダイアログで Download をクリックします。ファイルは安全に保管してください。このキーを使用する各Adaptyアプリにアップロードします。

    Download dialog for an In-App Purchase key

Appleはこれらの手順をAPIリクエストを認可するためのAPIキーの作成で説明しています。

キーをAdaptyに追加する

  1. Issuer ID と Key ID を確認するには、App Store Connect で Users and Access > Integrations > In-App Purchase に移動します。他の人がキーを生成し、Issuer ID、Key ID、ファイルを送ってもらった場合は、このステップをスキップしてください。

    Issuer ID and the Key ID of an In-App Purchase key in App Store Connect
  2. Adapty で App settings > iOS SDK に移動します。In-app purchase API (StoreKit 2) セクションで、各フィールドを入力してください:

    • Issuer ID:App Store Connect の In-App Purchase ページからコピーします。
    • Key ID:In-App Purchase ページの Active リストで、ダウンロードしたキーの横に表示されている値をコピーします。
    • Private key (.p8 file):ダウンロードしたファイルをアップロードします。
    Issuer ID, Key ID, and Private key (.p8 file) fields in the In-app purchase API (StoreKit 2) section in Adapty
  3. Adapty は In-App Purchase キーを使ってプロモーションオファーに署名します。App Store promotional offers セクションで、同じキーを再度入力してください:

    • Subscription key ID:手順 2 の Key ID を入力します。
    • Subscription key (.p8 file):手順 2 のファイルをアップロードします。
    Subscription key ID and Subscription key (.p8 file) fields in the App Store promotional offers section

    別のキーを入力してもエラーなく保存されますが、ユーザーはプロモーションオファーを受け取れなくなります。

  4. Save をクリックします。Adapty はページを保存する前に、In-app purchase API (StoreKit 2) セクションのキーを Apple に対して検証します。Apple がキーを拒否した場合、ページに「The provided field values are incorrect」と表示されます。値を確認してください。

キーの更新

キーが機能しなくなった場合や変更が必要な場合は、古いキーを失効させる前に新しいキーをAdaptyに保存してください。

キーが機能しなくなると以下の問題が発生します:

  • アプリ内の購入がアクセスを付与せず、アプリにエラーも返されない。
  • ユーザーがプロモーションオファーを利用できない。
  • Refund Saver が消費リクエストに応答できない。
  • Adaptyは警告を表示せず、App Store server notifications セクションのステータスは Active のままとなる。

アプリが別のAppleデベロッパーアカウントに移行する場合は、新しいオーナーのチームのキーに差し替えてください。

To replace the key:

  1. Adaptyで App settings > iOS SDK に移動します。現在Adaptyが使用しているキーを確認するには、In-app purchase API (StoreKit 2) セクションの Key ID フィールドの値をメモしておきます。
  2. 新しいキーを生成します。
  3. In-app purchase API (StoreKit 2) セクションと App Store promotional offers セクションで 新しいキーをAdaptyに追加し、Save をクリックします。
  4. 1つのキーがApp Store Connectチームのすべてのアプリで使用されます。他のAdaptyアプリがステップ1のKey IDを使用している場合は、それらのアプリにも新しいキーを追加してください。また、そのキーを使用しているサーバーがあれば、古いキーを新しいキーに置き換えます。
  5. 失効したキーはそれを使用しているすべてのアプリで機能しなくなり、復元することはできません。App Store Connectで古いキー(ステップ1のKey IDに対応するアクティブなキー)を失効させます。

Adaptyに有効なキーがない状態で購入したユーザーは、購入を復元するとアクセスが付与されます。