# ゲーム内通貨の概要

> React Native アプリのニーズに基づいて最適なものを選択して設定できるよう、Tapjoy Offerwall の自己管理および Tapjoy 管理のゲーム内通貨について説明します。

Tapjoy は、アプリケーションにゲーム内通貨を組み込むために、2 つの方法を提供しています。Tapjoy 管理通貨と自己管理通貨です。

## Tapjoy 管理通貨 (推奨)

Tapjoy 管理通貨を使用すると、Tapjoy のサーバー上にユーザーの通貨残高を保存できます。この無料サービスは、Tapjoy のパブリッシャー SDK を利用する開発者向けに提供されており、ゲーム内通貨データを管理するためのバックエンド基盤が不要になります。

> **Note:**
>
> **Tapjoy 管理通貨** を利用するアプリケーションでは、追加の Tapjoy 通貨をサポートできません。

## 自己管理通貨

自己管理通貨を使用すると、自社のサーバー上にユーザーの通貨残高を保存して管理できます。この方法はより細かく制御できますが、バックエンドの保存処理や通貨管理をすべて自分で運用する必要があります。

> **Note:**
>
> 1 つのアプリケーション内で、複数の自己管理通貨を実装できます。複数の Tapjoy 通貨を使用するには、セルフマネージオプションを選択する必要があります。管理通貨と自己管理通貨を組み合わせて使用することはサポートされていません。

## 通貨管理タイプの選択

推奨されるベストプラクティスは、追加機能を利用できる自己管理通貨を使用することです。以下の表は、2 つの通貨オプションの特徴を比較したものです。

| 通貨の特徴                    | Tapjoy 管理 | 自己管理 |
| ------------------------ | :-------: | :--: |
| 複数の通貨                    |    いいえ    |  はい  |
| ユーザー残高のコントロール            |    いいえ    |  はい  |
| トラブルシューティングのためのゲーム内報酬 ID |     なし    |  はい  |
| トランザクションの可視性             |    いいえ    |  はい  |
| 設定が簡単                    |     はい    |  はい  |
| SDK 呼び出しの減少              |     はい    |  いいえ |

## ゲーム内通貨の設定

> **Note:**
>
> ゲーム内通貨は、一度作成すると削除できません。通貨リストが乱雑にならないように注意してください。プラットフォーム (iOS と Android) ごとに別の通貨を作成する必要があります。

### ダッシュボードの設定

![Offerwallダッシュボードのゲーム内通貨設定。](/api/media?file=/grow/media/images/virtual-currency-config.png)

Tapjoy ダッシュボードインターフェースからゲーム内通貨を直接設定するには、以下のステップを実行します。

1. 右上のリストからアプリを選択します。

2. 左側のナビゲーションから **Virtual Currency** (ゲーム内通貨) を選択します。

3. 右上の **Add Virtual Currency** (ゲーム内通貨を追加) を選択します。

4. フォームに入力します。以下の通貨設定に関するベストプラクティスを参照してください。

**Set a currency exchange rate with enough granularity:**粒度を持たせた通貨交換レートの例は、`100 = $1` です。`2 = $1` のようなレートにすると、フィルレートが低下する可能性があります。これは、一部のオファーが通貨 1 単位に満たない価値しか持たない場合があるためです。**Avoid high exchange rates:**過度に高い交換レートの例は、`100,000,000 = $1` です。Android の場合、ゲーム内通貨残高の上限は 2,147,483,647 です。 この上限を超えてしまい、残高を取得できなくなるような交換レートは避けてください。

システムは 15 分以内に通貨を有効化します。その間は、デバイスがテストデバイスでない限り、オファーは表示されません。テストオファーを有効化するには、左側メニューの **Settings** (設定) > **App Settings** (アプリ設定) > **Test Devices** (テストデバイス) に移動します。

## Tapjoy 管理通貨から自己管理通貨への移行

アプリがまだリリースされていない場合は、Tapjoy ダッシュボードでアプリの通貨を切り替えることができます。コールバック URL フィールドには、正しい形式の URL を入力してください。

アプリが公開中の場合は、以下の対応を行います。

* 旧バージョンで報酬が失われないように、新しいアプリと SDK キーを作成します。
* ユーザー残高は、以下の方法で移行します。
  * 以前の SDK キーを使用して `getCurrencyBalance` を呼び出します (初回起動時の場合)。
  * 取得した残高をシステムに反映します。
  * それ以降の起動時では、SDK キーを交換します。
* 以前の広告キャンペーンを使用不可にし、新しいアプリ ID で再作成します。
* 実施前に、Tapjoy のアカウントマネージャーに相談してください。

> **Note:**
>
> Tapjoy 管理通貨へ戻すことはできません。

外部のゲーム内通貨サーバーソリューションを使用する場合は、Parse や UrbanAirship などのプラットフォームを検討してください。