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

クイック定期購入を利用すると、Fire TVデバイスやアプリのECページで定期購入型アイテムを購入するために必要なクリック回数が減ります。クイック定期購入によって、ユーザーはアプリのダウンロード、定期購入型アイテムの購入、権限の作成を効率的に行うことができるようになります。

一般的なアカウント作成プロセスでは、ユーザーがアカウントを登録するためにクリックする回数は150回以上にも及びます。クイック定期購入では、アカウントの作成をワンクリックで行えるようになりました。クイック定期購入のワンクリックアカウント作成機能を使用すると、ユーザーは1回のクリックするだけで氏名、郵便番号、Eメールアドレスをアプリと共有できるため、アカウントを作成してサインインする際の手間が省けます。

• ユーザーフローの比較
• クイック定期購入のしくみ
• クイック定期購入のセットアップ
• 開発者コンソールでクイック定期購入を設定する方法
• 開発者コンソールでセキュリティプロファイルを設定する方法
• getPurchaseUpdatesの処理
• Acknowledge Receipt API
• RTNおよびRVSとの統合
• ワンクリックアカウント作成の統合
• LATによるクイック定期購入のテスト
• クイック定期購入に関するよくある質問（FAQ）

ユーザーフローの比較

次の画像は、クイック定期購入を使用せずに、Fire TVで定期購入に登録する場合の一般的なユーザーエクスペリエンスを示しています。

クイック定期購入を使用すると、ユーザーは最初の手順でアプリの詳細ページから直接定期購入できます。次の画像は、クイック定期購入のワンクリックアカウント作成を使用して、Fire TVで定期購入に登録する場合のユーザーエクスペリエンスを示しています。

ワンクリックアカウント作成では、Amazonからユーザーに同意画面が表示され、ユーザーはそこで詳細情報をアプリと共有することに同意できます。ユーザーが同意すると、アプリがダウンロードされて起動し、Amazonからユーザーの詳細情報を取得してアカウントを作成します。その後、アプリは認証情報入力の手順を介さずに、自動的にユーザーのサインインを完了します。

クイック定期購入を既に統合済みで、ワンクリックアカウント作成を未使用の場合は、自動的にサインインする代わりに、ユーザーはFire TVリモコンでアカウントの認証情報を入力します。このエクスペリエンスはユーザーフレンドリーとはいえず、平均して150回以上のクリックが必要です。次の画像は、クイック定期購入のワンクリックアカウント作成を使用せずに、Fire TVで定期購入に登録する場合のユーザーエクスペリエンスを示しています。

クイック定期購入のしくみ

次の手順では、Fireデバイス、Amazonアプリ内課金（IAP）、Login with Amazon（LWA）、アプリ、サーバーでクイック定期購入がどのように機能するかを説明します。

手順1： ユーザーがFire TVのアプリの詳細ページから定期購入型アイテムの購入を開始します。

手順2： Amazonは、ユーザーに氏名、郵便番号、Eメールアドレスをアプリと共有する権限を求める同意画面を表示します。

手順3： Amazonがユーザーに購入の完了を通知します。

手順4： アプリが自動的にダウンロードされ、ユーザーのデバイスで起動されます。

手順5： 起動時に、アプリはユーザーがサインインしているかどうかを判断します。ユーザーがサインインしていない場合、アプリはAmazon IAPからgetUserData()メソッドを呼び出し、Amazonはユーザーの同意ステータスを返します。

同意ステータスがCONSENTEDの場合、アプリは手順6～8に従います。それ以外の場合、アプリはデフォルトのサインイン操作にフォールバックします。

手順6： アプリはLWA SDKのauthorize()メソッドを呼び出してセッションを開始します。

手順7： アプリはLWAのUser.fetch()メソッドを使用して、氏名、郵便番号、Eメールアドレスなどのユーザーの詳細情報を取得します。

手順8： アプリは、ユーザーの詳細情報を使用して新しいアカウントを作成するか、既存のアカウントにマップして、自動的にユーザーをサインインします。

手順9： ユーザーがサインインすると、アプリはonResume()メソッドでAmazon IAPのgetPurchaseUpdates()メソッドを呼び出して、購入のレシートを取得します。

手順10： アプリはIAPのnotifyFulfillment()メソッドを呼び出して購入のレシートを確認し、ユーザーがコンテンツにアクセスできることを確認します。または、すでにAcknowledge Receipt APIを統合している場合、アプリはacknowledgeReceipt REST APIを呼び出して、ユーザーがコンテンツにアクセスしたことを確認します。

手順11： アプリはサーバーの購入データを更新し、verifyReceiptId REST APIを呼び出してレシート検証サービス（RVS）で検証します。

手順12： アプリはユーザーにコンテンツへのアクセスを許可します。

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

アプリでクイック定期購入をセットアップするには、次の手順を完了します。

1. Amazonの担当者に連絡してクイック定期購入を有効にします。
2. 開発者コンソールでクイック定期購入を設定します。
3. 開発者コンソールでセキュリティプロファイルを設定します。
4. IAP APIをまだ統合していない場合は統合し、アプリのonResume()メソッドでgetPurchaseUpdatesを処理します。
5. ユーザーがクイック定期購入での注文後にアプリにサインインしたら、notifyFulfillment() APIを呼び出します。ユーザーが購入後30日以内にアプリにサインインしなかった場合、その定期購入型アイテムは自動的にキャンセルされ、ユーザーに返金されます。notifyFulfillment() APIの詳細については、ユーザーへのアイテムの付与を参照してください。
6. リアルタイム通知（RTN）およびレシート検証サービス（RVS）と統合します。RTNとRVSを使用すると、より多くの通知が届くため、定期購入の管理を強化できます。
7. ワンクリックアカウント作成を統合します。

必要な手順の詳細については、以下のセクションを参照してください。

開発者コンソールでクイック定期購入を設定する方法

アプリのクイック定期購入を設定するには、次の手順を実行します。

1. 開発者コンソールにログインします。
2. アプリ一覧で、クイック定期購入を設定するアプリを探します。
3. [アプリ内課金（IAP）アイテム] 列内のリンクをクリックして、[アプリ内課金（IAP）アイテム] 画面を開きます。
4. [クイック定期購入を作成] を選択します。
5. オーバーレイのポップアップが表示されます。[デフォルトの定期購入型アイテムを選択] ドロップダウンに、既存のアプリ内課金（IAP）定期購入型アイテムが表示されます。クイック定期購入を有効にする定期購入型アイテムを選択します。
6. [期間を選択] ドロップダウンで、クイック定期購入の期間を選択します。
7. クイック定期購入でほかの定期購入型アイテムを提供する場合は、[別のクイック定期購入を追加] を選択します。クイック定期購入は最大4つまで追加できます。
8. クイック定期購入の対象デバイスを、チェックボックスをオンにして選択します。
9. [クイック定期購入を作成] を選択します。

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

開発者コンソールでセキュリティプロファイルを設定する方法

アプリのセキュリティプロファイルを設定するには、次の手順を実行します。

1. 開発者コンソールにログインします。
2. アプリ一覧を開き、アプリを選択します。
3. [アプリサービス] をクリックし、[セキュリティプロファイル] セクションまでスクロールします。
4. [既存のセキュリティプロファイルを選択、または新規作成する] をクリックしてオプションを展開します。
5. ドロップダウンを使用して、このアプリにマップするセキュリティプロファイルを選択し、[セキュリティプロファイルを有効化] をクリックします。または、[セキュリティプロファイルを作成] をクリックして新しいセキュリティプロファイルを作成することもできます。

getPurchaseUpdatesの処理

getPurchaseUpdates()メソッドを使用すると、ユーザーのレシートを取得できます。クイック定期購入は、getPurchaseUpdates()の情報を使用してユーザーの購入ステータスを検証し、使用権限のあるコンテンツにユーザーがアクセスできるようにします。

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

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

//...

  PurchasingService.getUserData();

//...

  PurchasingService.getPurchaseUpdates(false);
}

getPurchaseUpdates()メソッドの統合方法の詳細については、IAP APIに関する次のテクニカルドキュメントを参照してください。

• Android - getPurchaseUpdatesメソッドの実装
• ウェブアプリ - getPurchaseUpdates(reset)

Acknowledge Receipt API

Amazonでは、ユーザーが使用権限のない定期購入型アイテムの料金を払い続けなくて済むように、自動キャンセルを使用しています。ユーザーが購入後30日以内にアプリにログインしなかった場合、その定期購入型アイテムは自動的にキャンセルされ、ユーザーに返金されます。ユーザーが意図的に定期購入型アイテムを購入してアクセスした場合でも、確認通知がなかったり遅れたりすると、その定期購入型アイテムは購入日から30日後に自動的にキャンセルされ、ユーザーはアクセスできなくなります。Acknowledge Receipt APIを呼び出すと、このような状況を回避できます。

Acknowledge Receipt APIでは、acknowledgeReceiptオペレーションを使用して、定期購入型アイテムの購入でアイテムの付与が完了したことをAmazonに通知できるため、ユーザーがアクセスできなくなることはありません。

acknowledgeReceiptオペレーションは、RVSで使用されるverifyReceiptIdオペレーションとよく似たREST APIですが、GETリクエストではなくPUTリクエストを使用する必要があります。

PUT https://appstore-sdk.amazon.com/version/1.0/acknowledgeReceipt?developer={Shared_secret}&user={UserId}=&receiptId={ReceiptId}&fulfillmentResult={FulfillmentResult}

acknowledgeReceiptオペレーションのバージョン番号は1.0です。クエリパラメーターの詳細は、次の表のとおりです。

クエリパラメーター

Acknowledge Receipt APIのレスポンスでは、次のクエリパラメーターを使用します。

レスポンスコード

HTTPリクエストを行った後、Acknowledge Receipt APIは次のいずれかのコードで応答します。

Acknowledge Receipt APIに関するよくある質問（FAQ）

Acknowledge Receipt APIに関するよくある質問（FAQ）を以下に示します。

Q： Acknowledge Receipt APIの呼び出しは、更新のたびに必要ですか？それとも購入後にのみ必要ですか？

クイック定期購入が有効な購入の後に、Acknowledge Receipt APIを呼び出す必要があります。

Q： Acknowledge Receipt APIが確認済みの場合に、ステータスFULFILLEDで呼び出されると、どのような応答が返されますか？

Acknowledge Receipt APIをステータスFULFILLEDで何度も呼び出した場合、べき等のオペレーションであるため、毎回同じ応答が返されます。

Q： acknowledgeReceiptオペレーションを元に戻す方法はありますか？ acknowledgeReceiptのステータスが既に更新されてFULFILLEDになっている場合、UNAVAILABLEに設定することはできますか？

いいえ。acknowledgeReceiptのステータスは、UNAVAILABLEからFULFILLEDへの移行はできますが、FULFILLEDからUNAVAILABLEへの移行はできません。レシートにエラーがある場合は、こちらからお問い合わせください。

RTNおよびRVSとの統合

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

リアルタイム通知（RTN）は、アプリの外部で発生するトランザクションも含め、すべてのトランザクションの購入情報を提供します。AmazonのRTNサーバーから購入通知を受信したら、レシート検証サービス（RVS）を使用してレシートを検証します。RVSサーバーにリクエストを送信すると、返されるJSONレスポンスにはpurchaseMetadataMapフィールドが含まれます。クイック定期購入を使用して購入を開始した場合、次の例のように、purchaseMetadataMapは{"QuickSubscribe":true}となります。

{
  "autoRenewing": true,
  "betaProduct": false,
  "binCountryCode": null,
  "cancelDate": 1641131573000,
  "cancelReason": 2,
  "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になります。レスポンスオブジェクトの全フィールドについて次の表で説明します。

RVSの詳細については、アプリ内課金（IAP）アプリのレシート検証を参照してください。

ワンクリックアカウント作成の統合

このガイドでは、アプリをワンクリックアカウント作成機能と統合する方法を説明します。

前提条件

• Login with Amazon SDKと統合します。詳細については、Android用のLogin with Amazon SDKをインストールするを参照してください。
• Appstore SDKバージョン3.0.5以降と統合します。詳細については、Appstore SDKの統合を参照してください。

アプリのマニフェストの更新

アプリがワンクリックアカウント作成機能をサポートしていることをAmazonアプリストアに示すには、次のコードでアプリのマニフェストを更新します。

<uses-feature android:name="amazon.lwa.quicksignup.supported"/>

getUserDataの変更の実装とLogin with Amazonの統合

ユーザーがAmazonアカウントの詳細情報の共有に同意したかどうかを判断するには、アプリのメインアクティビティのonCreateメソッドで、UserDataRequest オブジェクトのsetFetchLWAConsentStatus()フラグをtrueに設定してgetUserData()メソッドを呼び出します。

次の例は、Login with Amazon（LWA）が詳細情報を取得することにユーザーが同意した場合に、UserDataRequestオブジェクトを作成し、それをgetUserData()に渡す方法を示しています。

@Override
protected void onCreate(Bundle savedInstanceState) 
{
  super.onCreate(savedInstanceState);

//...

  PurchasingService.registerListener(this.getApplicationContext(), purchasingListener);
  if (!isLoggedIn()) {
     PurchasingService.getUserData(UserDataRequest.newBuilder().setFetchLWAConsentStatus(true).build());
  }
//...
}

ユーザーが同意した場合、UserDataオブジェクトのLWAConsentStatusのステータスはCONSENTEDになります。ユーザーが同意していない場合、または同意トークンの有効期限が切れている場合、LWAConsentStatusのステータスはUNAVAILABLEになります。

次のコードは、UserDataResponseオブジェクトから受け取った同意データを処理する方法を示しています。

@Override
public void onUserDataResponse( final UserDataResponse response) {

 final UserDataResponse.RequestStatus status = response.getRequestStatus();

 switch (status) {
   case SUCCESSFUL:
     if (LWAConsentStatus.CONSENTED.equals(response.getUserData().getLWAConsentStatus())) {
        lwaManager.startAutoLoginWorkflow();
     }
     break ;

   case FAILED:
   case NOT_SUPPORTED:
     // 失敗時の処理を適切に行います。
     break ;
 }
}

ユーザーが同意した場合は、LWAからauthorize()メソッドを呼び出してセッションを開始し、User.fetch()メソッドを呼び出してユーザーの詳細情報を取得します。共有されたユーザー情報を使用して、バックエンドシステムにアカウントを作成します。

次のコードは、LWAManagerを使用して、同意したユーザーの自動サインインを有効にする方法を示しています。

//..
private RequestContext requestContext;
private Context context;
//..

LWAManager(RequestContext requestContext, Context context) {
   this.requestContext = requestContext;
   this.context = context;
   requestContext.registerListener(new AuthorizeListener() {
      //..
      @Override
      public void onSuccess(AuthorizeResult authorizeResult) {
           fetchUserProfileInfo();
      }
      
      //..
   });
}

public void startAutoLoginWorkflow() {
    AuthorizationManager.authorize(
          new AuthorizeRequest.Builder(requestContext)
                  .addScopes(ProfileScope.profile(), ProfileScope.postalCode())
                  .build()
   );
           
}

private void fetchUserProfileInfo() {
    User.fetch(context, new Listener<User, AuthError>() {
      //..
      
      @Override
      public void onSuccess(User user) {
          final String name = user.getUserName();
          final String email = user.getUserEmail();
          final String zipCode = user.getUserPostalCode();
          
          // バックエンドでアカウントを作成またはマッピングし、ユーザーのサインインを処理します。
      }
      
      //..
   });

}

ユーザーが同意しない場合は、[Login with Amazon] ボタンのあるサインイン画面を表示します。これにより、ユーザーはキーボードを使用して認証情報を入力するか、[Login with Amazon] ボタンを使用してアプリにサインインできます。

フロー図

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

説明を表示／非表示  

LATによるクイック定期購入のテスト

ライブアプリテスト（LAT）を使用してクイック定期購入をテストできます。これを行うには、LATアプリのASINに対してクイック定期購入を有効にするようにAmazonの担当者に依頼してください。クイック定期購入フローは、AmazonのECサイトまたはFire TVデバイスでテストできます。ライブアプリテストを開始するときに、テスターに招待Eメールを送信できます。テスターは、Amazonウェブサイトへのリンクが記載されたEメールを受信します。このサイトには、LATバージョンのアプリが登録されています。

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

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

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

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

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

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

通知からテストするには：

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

クイック定期購入に関するよくある質問（FAQ）

クイック定期購入に関するよくある質問（FAQ）を以下に示します。

Q： Amazonでクイック定期購入を利用する場合、開発者はアプリのアカウント作成を省く必要がありますか？

いいえ。クイック定期購入の初回起動では、アプリでのアカウント作成のスキップはサポートされません。

Q： 無料体験を提供している場合、クイック定期購入も提供できますか？

はい。1つの定期購入型商品でクイック定期購入と無料体験の両方を提供できます。ただし、クイック定期購入は60日間の無料体験に対応していません。

Q： ユーザーが以前に無料体験を利用していた場合はどうなりますか？

クイック定期購入では、以前にAmazonアプリストアで作成された無料体験を検出できます。これにより、ユーザーが追加の無料体験期間を開始することはできません。ただし、ユーザーがAmazon以外でトライアルを開始していた場合、クイック定期購入ではこの情報を検出できないため、ユーザーは追加の無料トライアルを開始できます。

Q： ユーザーがクイック定期購入で定期購入型アイテムを購入し、アプリを2台目のデバイスにダウンロードするにはどうすればよいですか？

定期購入型アイテムは、クイック定期購入で購入した後、ユーザーのアカウントに追加されます。「アプリのみ」のオプションを使用すると、ユーザーはアプリをほかのデバイスにダウンロードできます。これで、ユーザーが各デバイスで定期購入型アイテムにアクセスできるようになります。

Q： プロモーション価格を提供している場合、クイック定期購入も提供できますか？

はい。1つの定期購入型商品でクイック定期購入とプロモーション価格の両方を提供できます。ただし、クイック定期購入は、週単位または隔週単位のプロモーション価格に対応していません。

ワンクリックアカウント作成に関するよくある質問（FAQ）

Q： OAuth用にサーバーをLogin with Amazon（LWA）と統合する必要はありますか？

いいえ、アプリ内でLWAと統合するだけで済みます。アプリが取得したデータを使用して、ユーザーアカウントを作成します。その後のユーザーのサインインは、開発者側のアカウント管理システムで管理します。

Q： Acknowledge Receipt APIとnotifyFulfillment() APIの違いは何ですか？ 両方と統合する必要がありますか？

notifyFulfillment()メソッドは、Appstore SDKに含まれているクライアント側のAPIで、アイテムの付与を確認します。Acknowledge Receipt APIも同じ目的を達成しますが、これはacknowledgeReceiptオペレーションを使用するサーバー間の呼び出しによって行われます。Amazonアプリストアでは、アプリにnotifyFulfillment() APIを実装することを推奨しています。notifyFulfillment()を実装していない場合は、バックアップオプションとしてサーバー側でAcknowledge Receipt APIを使用できます。

Q： 携帯電話番号だけでLogin with Amazon（LWA）を使用するユーザーのエクスペリエンスはどのようになりますか？

ユーザーが携帯電話番号のみでLWAを使用している場合、LWAは空のEメールを返すため、アプリはデフォルトのサインインエクスペリエンスにフォールバックする必要があります。

Q： アカウントを作成するために、Eメールアドレス、名前、郵便番号以外の情報が必要な場合はどうすればよいですか？

追加情報が必要な場合、アプリは必要な情報をユーザーにリクエストする必要があります。

Q： IAP SDK v2.0はワンクリックアカウント作成をサポートしていますか？

いいえ。ワンクリックアカウント作成を使用するには、Appstore SDKと統合する必要があります。アプリがIAP SDK v2.0でクイック定期購入を使用している場合は、Appstore SDKにアップグレードする必要があります。ワンクリックアカウント作成は、Appstore SDK v3.0.5以降でサポートされています。

Q： ライブアプリテスト（LAT）でワンクリックアカウント作成をテストできますか？ LATテスターの同意をリセットして、テストを再び開始することはできますか？

はい、LATでワンクリックアカウント作成をテストできます。同意をリセットするには、LATテスターがAmazonログインを管理するに移動して、[接続の管理] 列の [アクセスを削除] をクリックする必要があります。同意ステータスを一括で取り消すオプションはありません。

Q： App Testerを使用してワンクリックアカウント作成をテストできますか？

App Testerを使用すると、getUserData() APIの同意ステータス属性を模擬的に設定できます。統合をテストするには、同意ステータスのレスポンスを CONSENTEDまたはUNAVAILABLEに設定します。返されたステータスがCONSENTEDの場合、アプリはLogin with Amazon APIを呼び出してユーザーデータを取得し、自動的にサインインする必要があります。返されたステータスがUNAVAILABLEの場合、アプリはデフォルトのサインインエクスペリエンスにフォールバックする必要があります。

Last updated: 2024年3月27日