仮想通貨
クイックスタート
仮想通貨をエンドツーエンドでセットアップする：トークン通貨の作成、サブスクリプションによるトークン付与、サーバーサイドAPIを通じた消費。
バーチャル通貨の作成
Adaptyでバーチャル通貨を作成し、プロダクトにリンクして購入時にクレジットが付与されるよう設定します。また、クレジットの有効期限も設定できます。
初期残高を付与する
サーバーサイド API を使って新規ユーザーに仮想通貨の初期残高を付与し、新しい通貨を導入する際に既存ユーザーへのバックフィルも行えます。
バーチャル通貨残高
ユーザープロファイルでバーチャル通貨の残高を確認し、残高変更の履歴をイベント履歴で確認できます。
ユーザーがプロダクトを購入したりサブスクリプションを更新したりしたときに、AIトークン、クレジット、コインなどのバーチャル通貨を付与できます。通貨を一度定義してプロダクトに紐付けると、Adaptyが自動的に各ユーザーへ付与し、残高を管理します。アプリはサーバーサイドAPIを通じてその残高を読み取ったり消費したりできます（たとえば、生成ごとにトークンを消費するといった用途に活用できます）。
仕組み
- 仮想通貨を作成する: Products を開き、Virtual currency タブをクリックします。New virtual currency をクリックし、コード、名前、任意で説明を設定して通貨を定義します。
- 通貨をプロダクトに紐付ける: 通貨を買い切り購入またはサブスクリプションプロダクトにマッピングし、各購入で付与されるクレジット数を設定します。
- クレジットは自動的に付与される: ユーザーが紐付けられた買い切りプロダクトを購入するか、紐付けられたサブスクリプションが更新されると、Adaptyは設定されたクレジットをユーザーの残高に追加します。
- 残高の確認と消費: アプリはサーバーサイドAPIを通じて各ユーザーの残高を参照し、クレジットの付与や消費を行います。同じAPIを使って、まだ何も購入していないユーザーに初期残高を付与することもできます。
- すべての変更を追跡する: 残高の変更はそれぞれユーザーのプロファイルに一覧表示されます。
通貨の設定からAPIを使ったクレジット消費まで、すべての手順を確認するには、バーチャル通貨クイックスタートを参照してください。
ユースケース
| アプリの種類 | バーチャル通貨の活用方法 |
|---|---|
| AI アプリ（画像・動画・テキスト生成） | 生成ごとにクレジットを消費。サブスクリプションに毎月のクレジット付与を含め、クレジットパックを買い切り商品として販売する。 |
| ショートドラマ・動画アプリ | エピソードのアンロックにコインを消費。サブスクライバーには定期的なコイン付与を行い、コインパックを買い切り商品として販売する。 |
| 語学学習・教育 | サーバーサイド API を通じて無料ユーザーにハートやライフの限定付与を行う。有料プランではより多く付与するか、残高チェック自体をスキップする。 |
| モバイルゲーム | ソフト通貨とハード通貨を併用：サーバーサイド API でゲームプレイ報酬としてゴールドを付与し、ジェムは課金販売し、単一のアトミックトランザクションで相互交換できるようにする。 |
| 生産性アプリ | OCR やエクスポートなどコストの高い操作をクレジットで計量。無料ユーザーには少量を付与し、サブスクリプションではより多く付与し、まとめ作業向けにクレジットパックを販売する。 |
サブスクリプションの利用枠には、クレジットの有効期限を有効にしてください。未使用のクレジットが更新のたびにリセットされることで、利用枠がサブスクリプションを継続する動機になり、ヘビーユーザーはストックを使い切るのではなく、クレジットパックを購入するようになります。
制限事項
- デバイス間でのアクセスには識別が必要: 残高は1つのプロファイルに紐付きます。匿名ユーザーは、残高を獲得したインストール環境でのみ残高を保持するため、アプリを再インストールしたり別のデバイスで開いたりすると残高が失われます。すべてのデバイスおよび再インストール後も残高を利用できるようにするには、ユーザーを識別してください。詳しくは残高、プロファイル、デバイスをご覧ください。
- サーバーサイドのみ: 残高の読み取りや消費を行うSDKメソッドはまだないため、アプリにはバックエンドが必要です。バックエンドでは、サーバーサイドAPIを通じて残高を読み取り、クレジットの付与や消費を行います。
- アプリごとに最大20通貨: 1つのアプリで最大20種類のバーチャル通貨を作成できます。