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

​

前提条件

• Appstore IAPライブラリのバージョン2.12.2以降と統合します（@amazon-devices/keplerscript-appstore-iap-lib": "~2.12.2"）。
• アクティブなアプリ内課金（IAP）アイテムを用意します。

​

考慮事項

• ダウンロードとインストールの時間を短縮するために、アプリのサイズを最適化してください。 一般に、アプリのサイズは50MB以下に抑えることをお勧めします。アプリのサイズを小さくすると、入手しやすさが向上し、より多くのユーザーがインストールできるようになります。また、インストール時と初回使用時にかかる時間も短縮されます。さらに、アプリが小さいほど、ストレージが不足したときにアンインストールされる可能性が低くなります。
• クイック定期購入を通じて提供するオファーは、有料の定期購入型アイテムに最も適しています。 クイック定期購入は、無料体験を提供するアプリをサポートしています。ただし、ユーザー獲得のためにアプリでフリーミアムモデルを使用している場合は、クイック定期購入がアプリに最適であるとは限りません。フリーミアムモデルでは、アプリ自体は無料で提供され、ユーザーは有料の定期購入なしで基本的なコンテンツやサービスにアクセスできますが、追加コンテンツや高度な機能は有料で提供されます。
• クイック定期購入による購入の処理はアプリの外部で行われます。 クイック定期購入を使用しない標準のIAPフローでは、ユーザーはアプリにサインインし、アプリ内から購入を行います。一方、クイック定期購入では、ユーザーはまずアプリの外部で購入を行い、その後アプリを開いてサインインします。 このため、クイック定期購入の実装には、標準のIAP実装との違いがいくつかあります。クイック定期購入を統合するには、このページの手順を使用してください。

​

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

1. 開発者コンソールのダッシュボードに移動してアカウントにログインします。
2. ナビゲーションバーから [マイアプリ] をクリックします。
3. 一覧で目的のアプリを見つけ、その行を展開します。
4. [アプリ内課金（IAP）アイテム] 列内のリンクをクリックして、[アプリ内課金（IAP）アイテム] 画面を開きます。
5. [クイック定期購入を作成] を選択します。
6. 次の画像のようなオーバーレイポップアップが表示されます。

   

   [デフォルトの定期購入型アイテムを選択] ドロップダウンに、既存のアプリ内課金（IAP）定期購入型アイテムが表示されます。クイック定期購入を有効にする定期購入型アイテムを選択します。
7. [期間を選択] ドロップダウンで、クイック定期購入の期間を選択します。
8. クイック定期購入でほかの定期購入型アイテムを提供する場合は、[別のクイック定期購入を追加] をクリックします。
9. クイック定期購入の対象デバイスを、チェックボックスをオンにして選択します。
   • Fire TVデバイスの場合、Fire OSデバイスとVega OSデバイスのいずれかまたは両方をターゲットとして明示的に選択できます。
     • Fire OSデバイスのみをターゲットにするには、[Fire TV (Fire OS)] をオンにします。
     • Vega OSデバイスのみをターゲットにするには、[Fire TV (Vega)] のみをオンにします。
     • Fire OSデバイスとVega OSデバイスの両方をターゲットにするには、[Fire TV (Fire OS)] と [Fire TV (Vega)] の両方をオンにします。
10. ライブアプリテスト（LAT）用にのみクイック定期購入を作成するか、LATと公開アプリの両方のためにクイック定期購入を作成するかを選択します。
    • LAT用にのみクイック定期購入を作成するには、[テスト用のクイック定期購入を作成] をクリックします。
    • LATと公開中のアプリの両方のためにクイック定期購入を作成するには、[テスト・公開用のクイック定期購入を作成] をクリックします。

​

手順2：セキュリティプロファイルを構成する

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

​

手順3：getPurchaseUpdatesを実装する

​

実装要件

​

手順4：RVSと統合する

{
  "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
}

​

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

​

実装要件

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

​

自動キャンセル

​

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と統合する

​

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

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

​

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

​

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

​

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

​

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

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] をクリックし、アプリをダウンロードします。

​

関連トピック

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