クーポンとプロモーション (レガシ エコノミー)

Important

Economy v1 API はメンテナンス モードであり、新機能は受け取らず、バグ修正のみを受け取ります。 v1 API は、当面維持されます。 次のバージョンの PlayFab エコノミーの詳細については、「エコノミー v2 の概要」をご覧ください。

クーポンとは、顧客用に生成する文字列トークンです。顧客はゲーム内でクーポンを使用して、インベントリ アイテムと引き換えることができます。 バンドルまたは CloudScript と組み合わせることで、これらのクーポンを使用して、ゲーム内でほとんどあらゆる機能をトリガーできます。

要件

クーポンの生成と使用の手順

以下のすべての例は、クーポン生成の最初の基本的な手順を説明しています。 これはゲーム マネージャーで実行します。

ゲーム マネージャーから:

  • [タイトル] に移動します。
  • 左のメニューから、[Economy] (エコノミー) を選択します。
  • [カタログ] タブに移動します。

[アイテム][バンドル][コンテナー] の 3 つのタブ セクションのいずれかにクーポンのリンクがあります。

ゲーム マネージャー - エコノミー - カタログ アイテム - クーポン

リンクのウィンドウが開き、セクション内の任意のアイテムに対してクーポンを生成できます。 特定のアイテムに対してクーポンを作成する場合は以下を実行します。

  • [Items] (アイテム) タブで [クーポン] を選択します。
  • [バンドル]クーポン をバンドル化し、[コンテナー] でクーポンをコンテナー化します。

以下に似たポップアップ ウィンドウが表示されます (項目のリストはタイトルと一致します。表示される項目については、「ドロップ テーブルのチュートリアル」を参照してください)。

ゲーム マネージャー - クーポンを生成する

クーポンの生成を完了するには以下を実行します。

  • 生成するクーポンの数量を選択します。

  • 次に、クーポンが生成するアイテムを選択します。

  • クーポンのリストを含む CSV テキスト ファイルをダウンロードできます

例の中のいずれかのリンクを選択すると、以下のコンマ区切りのクーポンが 10 個生成されます。

65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz

最後に、コードを入力可能な GUI を顧客に提供し、それによって RedeemCouponが呼び出されると、顧客はクーポンを使用できます。

// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}

例: インベントリ アイテムのクーポン

クーポンの最も簡単な使用方法は、インベントリ アイテムをプレゼントすることです。 カタログを作成したら、前に説明した手順に従って、通常アイテムに対するクーポンを生成できます。 この場合、その他の特別な手順は必要ありません。

事例:仮想通貨クーポンまたは複数アイテムのクーポン

クーポンで直接仮想通貨を直接付与することはできず、付与することができるアイテムは 1 つのみです。

ただし、バンドルを使用して、インベントリ アイテムをシームレスにアイテムのグループまたは仮想通貨に変更できます。 仮想通貨の例では、仮想通貨を含む新しいバンドル アイテムを作成します。

バンドルの有効期限を 15 秒間にします。 こうすることで、プレイヤーがバンドルを開けるとすぐに仮想通貨が表示されることになります。中間のアイテムは表示されません。

ゲーム マネージャー - エコノミー - カタログ バンドルの編集

複数のアイテムも同じように機能します。

  • 複数のアイテムを含むバンドルを作成します。ドロップ テーブルでもかまいません。
  • 有効期限を 15 秒間に設定します。
  • クーポンによってバンドルが生成されます。
  • バンドルは、複数のアイテムに変換されます。
  • 中間のバンドル アイテムは表示されなくなります。

使用のシナリオ

  • コンベンションにおける物理的な報奨
    • クーポン コードのリストを印刷し、コンベンションでのプレゼントとして手渡すことができます。
  • フォーラム、プッシュ通知、電子メールなどのゲーム外のコミュニケーション。
    • ユーザーの再呼び込みキャンペーンなど、コミュニティへの取り組みの一環としてプレイヤーにクーポンを直接送信します。
  • トーナメント

注意

この場合は、インベントリ アイテムを直接付与することもできます。そのため、ゲームに適しているほうを選択してください。

ベスト プラクティス

PlayFab のインベントリを使用する場合、インベントリのサイズを比較的小規模にしておくことをお勧めします (プレイヤーごとに合計 100 アイテム未満)。 付与するアイテムが多すぎるバンドルは、調整またはレート制限される場合があります。