クイック定期購入のセットアップ

クイック定期購入の概要については、クイック定期購入の概要を参照してください。開始する準備ができたら、Amazonの担当者に連絡して、アカウントでクイック定期購入を有効にするように依頼します。次に、このページの手順に従います。

• 前提条件
• 手順1： 開発者コンソールでクイック定期購入を構成する
• 手順2： getPurchaseUpdatesを実装する
• 手順4： RVSと統合する
• 手順5： アイテム付与の結果をAmazonに送信する
• 手順6： RTNと統合する
• 手順7： ワンクリックアカウント情報共有を統合する
• 手順8： LATを使用してクイック定期購入をテストする
• 関連トピック

前提条件

クイック定期購入は、Amazonアプリストアのアプリ内課金（IAP）APIに含まれている機能です。

クイック定期購入を設定する前に、次の操作を行う必要があります。

• Appstore SDKバージョン3.0.6以降と統合します。詳細については、Appstore SDKの統合を参照してください。
• アクティブなアプリ内課金（IAP）アイテムを用意します。

考慮事項

作業を始める前に、以下の考慮事項と推奨事項を確認してください。

• ダウンロードとインストールの時間を短縮するために、アプリのサイズを最適化してください。

  一般に、アプリのサイズは50MB以下に抑えることをお勧めします。アプリのサイズを小さくすると、入手しやすさが向上し、より多くのユーザーがインストールできるようになります。また、インストール時と初回使用時にかかる時間も短縮されます。さらに、アプリが小さいほど、ストレージが不足したときにアンインストールされる可能性が低くなります。

• クイック定期購入を通じて提供するオファーは、有料の定期購入型アイテムに最も適しています。

  クイック定期購入は、無料体験を提供するアプリをサポートしています。ただし、ユーザー獲得のためにアプリでフリーミアムモデルを使用している場合は、クイック定期購入がアプリに最適であるとは限りません。フリーミアムモデルでは、アプリ自体は無料で提供され、ユーザーは有料の定期購入なしで基本的なコンテンツやサービスにアクセスできますが、追加コンテンツや高度な機能は有料で提供されます。

• クイック定期購入による購入の処理はアプリの外部で行われます。

  クイック定期購入を使用しない標準のIAPフローでは、ユーザーはアプリにサインインし、アプリ内から購入を行います。一方、クイック定期購入では、ユーザーはまずアプリの外部で購入を行い、その後アプリを開いてサインインします。

  このため、クイック定期購入の実装には、標準のIAP実装との違いがいくつかあります。クイック定期購入を統合するには、このページの手順を使用してください。

手順1： 開発者コンソールでクイック定期購入を構成する

アプリのクイック定期購入を構成するには

1. 開発者コンソールのダッシュボードに移動してアカウントにログインします。
2. [アプリ＆サービス] > [マイアプリ] を選択し、アプリを選択します。
3. [アプリ内課金（IAP）アイテム] 列内のリンクをクリックして、[アプリ内課金（IAP）アイテム] 画面を開きます。
4. [クイック定期購入を作成] を選択します。
5. 次の画像のようなオーバーレイポップアップが表示されます。

   

   [デフォルトの定期購入型アイテムを選択] ドロップダウンに、既存のアプリ内課金（IAP）定期購入型アイテムが表示されます。クイック定期購入を有効にする定期購入型アイテムを選択します。

6. [期間を選択] ドロップダウンで、クイック定期購入の期間を選択します。
7. クイック定期購入でほかの定期購入型アイテムを提供する場合は、[別のクイック定期購入を追加] をクリックします。
   重要：​ クイック定期購入は最大4つまで追加できます。
8. クイック定期購入の対象デバイスを、チェックボックスをオンにして選択します。
9. ライブアプリテスト（LAT）用にのみクイック定期購入を作成するか、LATと公開アプリの両方のためにクイック定期購入を作成するかを選択します。
   • LAT用にのみクイック定期購入を作成するには、[テスト用のクイック定期購入を作成] をクリックします。
   • LATと公開中のアプリの両方のためにクイック定期購入を作成するには、[テスト・公開用のクイック定期購入を作成] をクリックします。
   注： LATの詳細と、LATを使用してクイック定期購入をテストする方法については、LATを使用してクイック定期購入をテストするを参照してください。

クイック定期購入の作成後、アイテムを削除または変更する場合は、そのクイック定期購入アイテムの横にある [アクション] をクリックします。

手順2： getPurchaseUpdatesを実装する

getPurchaseUpdates()メソッドはユーザーのレシートを取得します。ユーザーがクイック定期購入を通じて購入した場合、購入処理はアプリの外部で行われます。このため、クイック定期購入では、アプリからgetPurchaseUpdatesを呼び出してユーザーの購入ステータスを検証する必要があります。この呼び出しにより、アプリが開いたときに、購入されたコンテンツがユーザーに確実に付与されます。getPurchaseUpdates()を適切に実装しないと、ユーザーが購入したコンテンツにアクセスできなくなる可能性があります。

getPurchaseUpdates()は、onResume()メソッド内で呼び出します。getPurchaseUpdates()メソッドは、resetというブール型のパラメーターを1つ受け取ります。resetをfalseに設定すると、前回の呼び出し以降に発行された新しいレシートのみが返されます。resetをtrueに設定すると、このユーザーのレシートがすべて返されます。

次のコードは、getPurchaseUpdates()メソッドを呼び出す方法を示しています。

@Override
protected void onResume() {
  super.onResume();

//...

  PurchasingService.getUserData();

//...

  PurchasingService.getPurchaseUpdates(false);
}

getPurchaseUpdates()メソッドの統合方法の詳細については、IAP APIのドキュメントのgetPurchaseUpdatesメソッドの実装を参照してください。

実装要件

getPurchaseUpdates()メソッドを正しく実装するには、以下の要件に従ってください。

• AndroidアクティビティのonResume()ライフサイクルメソッドで、getPurchaseUpdates()を呼び出す必要があります。
• 最新のレシートのみを取得するために、onResume()でgetPurchaseUpdates()を呼び出すときは常にfalseフラグを使用します。trueフラグを使用すると、レシートのすべての履歴が返されるため、レスポンスを処理するためのフィルタリングロジックを追加することが必要になります。
• アプリに [購入タイトルを復元] オプションを追加します。ユーザーがこのオプションを選択したら、getPurchaseUpdates()をtrueフラグと共に呼び出します。
• getPurchaseUpdates()を通じて受け取ったレシートは常に保持し、アプリのログインIDにマッピングする必要があります。このマッピングを使用して、ユーザーがアプリを開いたときに定期購入済みのコンテンツのロックを解除します。

手順4： RVSと統合する

レシート検証サービス（RVS）を使用すると、アプリのユーザーが行った購入を検証できます。RVSの詳細については、 Appstore SDK IAP用レシート検証サービスを参照してください。RVSサーバーにリクエストを送信すると、返されるJSONレスポンスにはpurchaseMetadataMapフィールドが含まれます。クイック定期購入を使用して購入を開始した場合、次の例のように、purchaseMetadataMapは{"QuickSubscribe":true}となります。

{
  "autoRenewing": true,
  "betaProduct": false,
  "binCountryCode": null,
  "cancelDate": 1641131573000,
  "cancelReason": 2,
  "countryCode": "US",
  "deferredDate": null,
  "deferredSku": null,
  "freeTrialEndDate": null,
  "fulfillmentDate": 1641131345000,
  "fulfillmentResult": "FULFILLED",
  "gracePeriodEndDate": null,
  "parentProductId": null,
  "productId": "IntroFreeTrial.sku",
  "productType": "SUBSCRIPTION",
  "promotions": null,
  "purchaseDate": 1641131345000,
  "purchaseMetadataMap": {
      "QuickSubscribe": "true"
  },
  "quantity": null,
  "receiptId": "k9om1rUS7gZJIg8RMfw7AlbxA3aP56ay-vdgeLU40zw=:3:11",
  "renewalDate": null,
  "term": "1 Month",
  "termSku": null,
  "testTransaction": false
}

購入がクイック定期購入を使用して開始されたものでない場合、purchaseMetadataMapはnullになります。レスポンスオブジェクトの全フィールドについて次の表で説明します。

手順5： アイテム付与の結果をAmazonに送信する

アイテム付与の結果を送信すると、ユーザーが購入したコンテンツにアクセスできるかどうかをAmazon側で確認できるようになります。必ずアイテム付与の結果をAmazonに送信してください。これには、Appstore SDKに含まれているnotifyFulfillment()メソッドを使用します。アイテム付与の結果を送信しないと、Amazonは、付与が完了していない定期購入型アイテムの料金をユーザーが払い続けることがないように、自動的に定期購入型アイテムをキャンセルします。

ユーザーがサインインした後、定期購入型アイテムが付与されたら、ステータスをFULFILLEDとしてnotifyFulfillment()を呼び出します。ユーザーが既にAmazon以外から入手した定期購入型アイテムを所有している場合は、ステータスをUNAVAILABLEとしてnotifyFulfillment()を呼び出して、ユーザーはサインインしているものの購入は適用できないことを通知します。notifyFulfillment()メソッドの詳細については、Amazonへのアイテム付与の結果の送信とユーザーへのアイテム付与を参照してください。

既にAcknowledge Receipt APIを統合している場合は、引き続きnotifyFulfillment()メソッドの代わりに使用できます。アイテム付与の結果をAmazonに通知するには、アプリ内でnotifyFulfillment()メソッドかAcknowledge Receipt APIのいずれかを使用する必要があります。

実装要件

notifyFulfillment()メソッドを正しく実装するには、以下の要件に従ってください。

• アイテム付与ステータスをAmazonに通知するために、PurchaseUpdatesResponseオブジェクトからレシートが処理されたら、そのたびにnotifyFulfillment()を呼び出す必要があります。
• notifyFulfillment()を呼び出すときは、以下の要件に従います。
  • 次の条件に該当する場合は、FULFILLEDを送信します。
    • ユーザーが正常にレシートにマッピングされ、ユーザーの定期購入済みコンテンツのロックが解除された。
  • 次のいずれかの状況が発生した場合は、UNAVAILABLEを送信します。
    • ユーザーがAmazon以外で購入した既存の定期購入型アイテムを所有している。
    • ユーザーにサービスのアカウントにサインアップする資格がない。

自動キャンセル

Amazonでは、付与が完了していない定期購入型アイテムの料金をユーザーが払い続けなくて済むように、自動キャンセルを使用しています。購入から14日以内にnotifyFulfillment()またはAcknowledge Receipt APIを使用して購入レシートのステータスをFULFILLEDに更新しないと、Amazonアプリストアは自動的に定期購入型アイテムをキャンセルし、返金を行います。ただし、購入後14日以内に購入レシートのステータスをUNAVAILABLEに更新すると、Amazonアプリストアは直ちに定期購入をキャンセルして返金します。

Acknowledge Receipt API

Acknowledge Receipt APIの詳細を表示／非表示  

PUT https://appstore-sdk.amazon.com/version/1.0/acknowledgeReceipt?developer={shared-secret}&user={user-id}&receiptId={receipt-id}&fulfillmentResult={fulfillment-result}

手順6： RTNと統合する

クイック定期購入では、ユーザーはアプリの外部でAmazonを通じてアプリを定期購入します。そのため、ユーザーの購入ステータスに関する情報の一部がアプリに保存されない可能性があります。getPurchaseUpdates()メソッドは、アプリが開かれている場合にのみデータを送信します。

リアルタイム通知（RTN）は、アプリの外部で発生するトランザクションも含め、すべてのトランザクションの購入情報を提供します。AmazonのRTNサーバーから購入通知を受信したら、レシート検証サービス（RVS）を使用してレシートを検証します。

RTNを使用すると、ユーザーが購入、更新、キャンセルなどを行ったときに、ユーザーの定期購入イベントに関する更新通知がAmazonから届きます。この情報はクイック定期購入を使用するアプリにとって重要です。これにより、ユーザーの定期購入型アイテムに関する最新情報を常にアプリに反映できます。

RTNの設定方法の詳細については、リアルタイム通知（RTN）を使用する方法を参照してください。

手順7： ワンクリックアカウント情報共有を統合する

アプリをワンクリックアカウント情報共有機能と統合するには、ワンクリックアカウント情報共有の統合ガイドに従います。

次の図は、ワンクリックアカウント情報共有を使用したクイック定期購入のコードフローを示しています。

図の説明を表示／非表示  

ワンクリックアカウント情報共有を設定するための大まかな手順は次のとおりです。

1. アプリのマニフェストを更新します。
2. getUserData()を実装します。
3. ユーザーの同意ステータスを確認します。
   • ユーザーが同意していない場合は、標準のアカウント作成プロセスを使用します。
   • ユーザーが同意している場合は、次の手順に進みます。
4. Appstore IAPのGet Access Token REST APIを使用して、アクセストークンを取得します。
5. Appstore IAPのGet User Profile REST APIを使用して、ユーザーのプロフィールデータを取得します。
   • ユーザーのEメールを取得します。
   • ユーザーのEメールを使用して、サービスのアカウントを作成します。

手順8： LATを使用してクイック定期購入をテストする

Amazonのライブアプリテスト（LAT）サービスを利用すると、Amazonアプリストアでアプリを公開する前に、事前に設定したテスターグループにアプリを配信することができます。テスターは、Amazonの本番環境下で用意された全サービスを試して、アプリが適切に動作するかどうかを確認できます。

クイック定期購入のためのLATの設定

ライブアプリテスト（LAT）でクイック定期購入をテストするには、まず、開発者コンソールでクイック定期購入を構成するの手順を使用して、開発者コンソールでLAT用のクイック定期購入を構成します。クイック定期購入は、次の画像に示すように、LAT用にのみ構成することも、公開アプリとLATアプリの両方のために構成することもできます。

LAT用にのみクイック定期購入を構成した場合でも、次の画像に示すように [アクション] > [公開中へ昇格] を選択すると、後から構成を公開中のアプリに昇格できます。

LATアプリ用のクイック定期購入の構成が公開アプリ用と異なる場合は、次の画像に示すように、LATアプリ用のクイック定期購入の詳細に [テスト] というラベルが表示されます。

クイック定期購入フローは、AmazonのECサイトまたはFireデバイスでテストできます。ライブアプリテストを開始するときに、テスターに招待Eメールを送信できます。テスターは、Amazonウェブサイトへのリンクが記載されたEメールを受信します。このサイトには、LATバージョンのアプリが登録されています。

ウェブサイトでのクイック定期購入のテスト

LATの招待Eメールから、対象のマーケットプレイスのAmazonウェブサイトを選択します。アプリの詳細ページで、定期購入オプションを選択します。これは、月額20.00 USDのように、定期購入型アイテムの期間に対する有料オプションとして表示されます。次に、配信先のデバイスを選択し、[Get App] をクリックします。

デバイスでのクイック定期購入のテスト

デバイスでクイック定期購入のテストを開始するには、LATの招待Eメールまたはデバイスの通知を使用できます。

LATの招待Eメールからテストするには

1. 招待Eメールに記載されているリンクを使用して、Amazonウェブサイトのアプリの詳細ページに移動します。
2. [App Only] オプションをクリックします。
3. アカウントに複数のデバイスが関連付けられている場合は、次の手順を実行します。
   1. [Deliver to <デバイス名>] で、デバイス名をクリックします。
   2. [Deliver to] ダイアログで、アプリを配信するデバイスを選択します。
4. [Get App] をクリックします。
5. Amazonアカウントに関連付けられているFire TVデバイスで、[マイアプリ・チャンネル] のアイコンをクリックします（アイコンはナビゲーションバーに3つの四角形とプラス記号で表示されます）。
6. アプリアイコンにTESTバナーが表示されているLATバージョンのアプリを探します。アプリを表示するには、[アプリライブラリ] をクリックする必要のある場合があります。
7. デバイスで、アプリアイコンをクリックしてアプリの詳細ページを開きます。
8. [Subscription Options] をクリックし、アプリをダウンロードします。

通知からテストするには

LATの招待Eメールを送信すると、テスターEメールに関連付けられているテストデバイスに通知が届きます。通知が表示されたときに開くと、LATアプリの詳細ページに移動します。この通知は5～10秒間表示されます。通知が最初に表示されたときに見逃した場合は、設定アイコン（歯車アイコン）をクリックし、[通知] をクリックすることで確認できます。ここで通知を読み、アプリの詳細ページに移動できます。[Subscription Options] をクリックし、アプリをダウンロードします。

関連トピック

• クイック定期購入のワンクリックアカウント情報共有
• クイック定期購入のテストケース
• クイック定期購入の概要
• クイック定期購入に関するよくある質問（FAQ）

Last updated: 2025年8月13日