UDP パッケージを使用したアプリ内課金 (IAP) の実装
Unity は、UDP コンソールでアプリ内課金 (IAP) プロダクトを追加および管理することを推奨します。UDP コンソールの IAP Catalog (IAP カタログ) は、ストアのバックエンドシステムに提出する情報の信頼できる情報源です。さらに、UDP コンソールを使って、以下を行うことができます。
- 複数の IAP 価格と通貨の管理
- 複数の言語での説明を追加
- CSV ファイルを使ってアイテムを一括アップロード (複数の通貨と言語をサポート)
ノート: UDP パッケージのみを使用している場合でも、少なくとも 1 つの IAP アイテムを Unity エディターで作成して、UDP コンソールと正しく同期できることをテストする必要があります。 Unity IAP パッケージを使用している場合 (コードを使わない実装)、Unity エディターで各 IAP アイテムを追加し、それらすべてを UDP コンソールにアップロードする必要があります。Unity IAP パッケージを使用して、コードで IAP を実装した場合は、UDP コンソールで IAP アイテムを作成してください。
ゲームクライアントで IAP カタログを保存している場合、UDP は Unity エディターと UDP コンソール間で IAP カタログの同期を維持します。
UDP コンソールでのアプリ内課金の管理
UDP コンソール で、My Games ページを通してゲームに移動します。 Game Info ページで、EDIT INFO ボタンを選択して編集モードにします。変更を保存するには、SAVE を選択します。変更を破棄するには、CANCEL を選択します。 このセクションでは、UDP コンソールから IAP プロダクトを編集、作成、削除する方法について説明します。
新しい IAP アイテムの作成
UDP コンソールで新しい IAP アイテムを作成するには、以下を行います。
- Game Information ページで EDIT INFO を選択します。
- Add Item を選択し、新しいアイテムを作成します。
-
プロダクト情報 を指定して保存します。
- アプリストアで有効であるように、Product ID の要件に従います。
- ゲームで定義した IAP プロダクトに、IAP カタログで設定したものと同じ Product ID を使用してください。
-
Manage amounts and currencies を選択して、以下を行います。
- IAP 価格を USD (米ドル) から他の通貨に変換します。
- これらの通貨での価格を調整します。
- SAVE を選択して変更を保存します。
ノート: 作成する IAP アイテムが多数ある場合は、IAP 一括インポート機能 を使用して、ローカライズされた説明や複数の通貨での価格設定など、すべての IAP アイテムを一度に作成することを検討してください。
UDP パッケージを使用する場合、コンソールに追加した新しい IAP アイテムはすべて Unity プロジェクトに同期されます。それらのためにゲームを再ビルドする必要はありません。
IAP の説明を編集
IAP の説明を編集するには、以下の手順で行ってください。
- Game Information ページで EDIT INFO を選択します。
- ドロップダウン言語セレクターを使用して、説明を編集する言語を選択します。
- In-App Purchases セクションで、鉛筆アイコンを選択して既存の IAP アイテムを編集します。
- 以下の IAP アイテム情報を編集します。
- Product Name (IAP アイテムの名前)
- Description (IAP アイテムの簡潔な説明)
- SAVE を選択して変更を保存します。
ノート: 上の手順では、選択した言語の IAP アイテム情報のみを編集します。サポートする IAP アイテムと言語が多数ある場合は、IAP 一括インポート を使用してこれらの情報をインポートすることを検討してください。
IAP 価格と通貨の管理
- Game Information ページで EDIT INFO を選択します。
- IAP アイテムの Manage amounts and currencies を選択して、以下を行います。
- IAP 価格の変更
- IAP 価格を USD (米ドル) から他の通貨に変換
- これらの通貨での価格を調整します。
- SAVE を選択して変更を保存します。
ヒント: 通貨をお気に入りの通貨として設定するには、通貨コードの横にあるスターアイコンを選択します。これにより、通貨がリストの一番上に固定されます。 固定を解除するには、スターの選択を解除します。
ノート: サポートする IAP アイテムと通貨が多数ある場合は、Convert 機能を使用すると、各 IAP アイテムに設定された米ドル額に基づいてすべての IAP 価格をグローバル通貨に自動的に変換できます。これにより、以前設定した各国の価格が上書きされます。
または、IAP 一括インポート を使用して、すべての情報を一度にインポートします。
IAP アイテムの削除
- Game Information ページで EDIT INFO を選択します。
- IAP アイテムを削除するには、ゴミ箱アイコンを選択します。
- SAVE を選択して変更を保存します。
IAP アイテムの一括インポート
- Game Information ページで EDIT INFO を選択します。
- In-App Purchases ページの右上にある IMPORT CATALOG を選択します。
この機能の詳しい説明は、IAP 一括インポートを参照してください。 - SAVE を選択して変更を保存します。
Google Play からのゲーム情報のインポート
すでにゲームを Google Play で公開している場合は、ゲームの Google Play の URL を使用して基本情報をインポートできます。
- Import from Google Play を選択します。
- ゲームの Google Play URL を入力フィールドに貼り付けます。
- 具体的にインポートする言語を指定するには、言語のサフィックスを含む Google Play URL を使用します。例えば、イタリア語の場合は
&hl=itを使用します。
Google Play の URL に言語のサフィックスが含まれていない場合、UDP は (UDP コンソールが Google Play で設定されている場合)、現在 UDP コンソールで編集している言語の情報を取得します。 - Import を選択します。
- コンピュータの IP アドレスによって提供する言語が決定される場合があるため、結果を再確認してください。
IAP 一括インポート
IAP 一括インポート機能を使用すると、IAP アイテムが多数ある場合に、IAP カタログを簡単に管理できます。 これにより、標準の UDP 形式と Google Play 形式の CSV ファイルを、複数の通貨での価格や複数の言語での説明など、すべての IAP プロダクトの詳細とともに UDP コンソールにアップロードできます。
Unity は、サンドボックス環境で IAP アイテムを購入できることを確認するために、テスト目的で Unity エディターに IAP アイテムを追加することをお勧めします。
ノート: CSV ファイルに複数の言語が含まれている場合は、CSV ファイルをインポートする前にサポートされている言語を追加してください。
このセクションでは、CSV を使って IAP アイテムを一括でインポートする方法について説明します。
実装のための要件
新しい IAP プロダクトを加える
UDP が以下の方法で実装されている場合のみ、IAP 一括インポートを使って新しい IAP プロダクトを加えてください。
- UDP パッケージ使用
- Unity IAP (コードによる実装) 使用
Unity は、サンドボックス環境で IAP アイテムを購入できることを確認するために、テスト目的で Unity エディターに IAP アイテムを追加することをお勧めします。
ローカライズされた説明と価格を加える
すべての実装方法で、IAP 一括インポートを使用して、より多くの言語での説明とより多くの通貨での価格を既存の IAP プロダクトに割り当てることができます。
UDP パッケージを使用
Bulk IAP Import を使用すると、ゲームを再ビルドしなくても、ゲームの IAP カタログをすべて再定義できます。
正常に機能する UDP 実装が必要なだけです。
Unity IAP (コードによる実装) を使用
Unity IAP では、IAP カタログの同期はエディターから UDP コンソールにのみ行えます。
ゲームの IAP カタログを IAP 一括アップロードを使って UDP コンソールにアップロードする場合は、ゲームクライアントのデフォルトの IAP カタログからではなく、UDP コンソールから IAP プロダクト情報を取得するようにゲームを設定する必要があります。
ゲームが UDP コンソールから IAP カタログを取得できるようにするには、コードで IAP プロダクトの取得メソッドを呼び出さないでください。
詳細については、IAP インベントリのクエリ を参照してください。
CSV テンプレートのダウンロード
UDP には、IAP プロダクトの一括インポートに利用できる CSV テンプレートがあります。テンプレートは、CSV ファイル用の標準 UDP 形式です。
- Game Information ページの EDIT INFO を選択します。
- In-App Purchases ページに移動します。
- IMPORT CATALOG を選択します。
- Download Template を選択します。
CSV ファイルの記入
CSV ファイルでは、カンマ (,) とセミコロン (;) を使用してデータ値を区切ります。カンマは主データ値を区切り、セミコロンは補足的な値を区切ります。
各 IAP アイテムのすべてのデータが、CSV ファイル内の 1 行に表示される必要があります。
提供されたテンプレートどおりの 形式 でデータを入力する必要があります。
CVS ファイルのアップロード
- Game Information ページの EDIT INFO を選択します。
- In-App Purchases ページに移動します。
- IMPORT CATALOG を選択します。
- Upload CSV を選択するか、CSV ファイルを選択フィールドにドラッグアンドドロップします。
- IMPORT を選択して、IAP カタログを UDP コンソールにアップロードします。
ノート: CSV ファイルをアップロードすると、このリビジョンの IAP カタログが完全に上書きされます。UDP コンソールは、CSV ファイルに含まれる情報のみを使用します。以前に UDP コンソールを通して入力したその他の IAP 情報はすべて失われます。
CSV ファイルのエクスポート
既存の IAP カタログを再利用、または修正するには、以下を行います。
- Game Information ページで EDIT INFO を選択します。
- In-App Purchases ページに移動します。
-
EXPORT CATALOG を選択します。
これによって、既存の IAP カタログは標準 UDP 形式の CSV ファイルとしてエクスポートされます。 - CSV ファイルを修正します
- CSV ファイルをアップロードします
EXPORT CATALOG は、IAP カタログの中に IAP プロダクトがあり、かつ編集モードであるときにのみ表示されます。下の図では、In-App Purchases ページのこのボタンが表示されています。
Google Play 形式から IAP プロダクトをインポート
UDP は、Google Play 形式の CSV ファイルもサポートしています。
Google Play 形式の CSV ファイルを使って IAP プロダクトをインポートするには、以下を行います。
- Game Information ページの EDIT INFO を選択します。
- In-App Purchases ページに移動します。
- IMPORT CATALOG をクリックします。
- CSV file in Google Play format チェックボックスを選択します。
-
Upload CSV を選択するか、CSV ファイルを選択フィールドにドラッグアンドドロップします。
- Google Play default currency フィールドで、ゲームのデフォルト通過を選択します。
- IMPORT を選択して、IAP カタログを UDP コンソールにアップロードします。
価格設定
Google Play は国ごとに価格を設定し、UDP は通貨ごとに価格を設定します。したがって、インポートは国を通貨にマップします。 ある IAP プロダクトに対して、同じ通貨を使用して国ごとに異なる価格を設定されている場合 (例えば、ヨーロッパ諸国ではユーロ、EUR)、UDP は通貨リストの最初の国を使用します。USD (米ドル) でリストされている国が複数ある場合は、アメリカ合衆国が使用されます。
UDP は Google Play の価格設定テンプレートをサポートしていません。そのため、この設定は無視されます。UDP は、CSV ファイルで提供される現地価格のみを使用します。
デフォルト通貨
UDP はデフォルトの通貨として USD (米ドル) を使用します。Google Play に米ドルの価格が設定されていない場合、UDP は Google Play のデフォルトの価格と通貨を米ドルに変換し、これを UDP のデフォルト価格として使用します。
CSV ファイルに設定されている現地価格は、それぞれの通貨で維持されます。
CSV ファイルで明示的に設定されていない国の場合、UDP は Google Play のデフォルトの価格と通貨をそれぞれの通貨に変換します。
IAP プロダクト
IAP プロダクトのタイプ (消費型/非消費型) は、CSV ファイルから判別できません。各 IAP プロダクトのタイプを UDP に伝える必要があります。
UDP は自動翻訳をサポートしていません。そのため、自動翻訳設定は無視されます。UDP は、CSV ファイルで提供されるローカライズされた説明のみを使用します。