デイリー報酬
仕組み
デイリー報酬は、無料アイテムを提供することでユーザーに毎日ストアへのログインを促します。以下の種類のデイリー報酬を作成できます。
- ログイン報酬 — ユーザーがストアに初めてログインした後に利用可能になる報酬。これは設定順にアンロックされ、設定で指定された固定時間に1日1つずつ提供されます。指定された時間を過ぎてからユーザーが初めてストアにログインした場合、最初の報酬は翌日から利用可能になります。
例
報酬開始：月曜日 10:00 AM、期間：7日間ストアにログイン 初回報酬の受け取り ユーザー1 月曜日 09:00 月曜日 10:00 AM以降 ユーザー2 月曜日 12:00 火曜日 10:00 AM以降 ユーザー3 火曜日 12:00 水曜日 10:00 AM以降 - 報酬カレンダー — 特定の日付にすべてのユーザー様が受け取れる報酬です。報酬は世界共通のスケジュールに従って同時にアンロックされ、ユーザーが初めてストアにログインしたタイミングには依存しません。
例
ユーザーがプロモーションの4日目に初めてストアにログインした場合、そのユーザーはチェーンの4日目の報酬を見ることになります。
以下のアイテムタイプを報酬として使用できます：
- 仮想アイテム
- 仮想通貨
- 仮想通貨パッケージ
- バンドル
デイリー報酬チェーン内では、以下のアイテム設定は無視されます：
- 個人用設定ルール
- 購入制限
- 公開スケジュール（開始日/終了日）
- プロモーションおよび割引
デイリー報酬は、ユーザーが順番にアンロックしていく「チェイン」形式で表示されます。最終日の報酬が完了した後に、自動的に再スタートするループ型のデイリー報酬チェインを開始できます。
デイリー報酬システムが正しく機能するには、ユーザー認証を有効にする必要があります。
認証されていないユーザーはデイリー報酬チェーン全体を見ることはできますが、報酬を受け取ることはできません。
ユーザーフロー
- ユーザーはストアを訪問します。
- ユーザーはデイリー報酬チェーンと本日のログインで獲得できる報酬を確認します。
- ユーザーがログインします。
- ユーザーはデイリー報酬チェーンでの現在の進捗状況を確認します。
- ユーザーはデイリー報酬を受け取ります。
パブリッシャーアカウント経由のセットアップ
アカウントで設定を行う
デイリー報酬チェーンを作成する前に、ユーザーがストアにログインした際に無料で獲得できるアイテムを作成する必要があります。
パブリッシャーアカウントのプロジェクト内で手動でアイテムを作成するには、アイテムカタログ > すべてのアイテムセクションに移動します。本機能およびその他のアイテム作成方法に関する詳細は、アイテムカタログドキュメントセクションでご確認いただけます。
アカウントのプロジェクト内で手動でアイテムを作成するには、カタログセクションに移動します。この方法や、その他のアイテム作成方法に関する詳細は、ドキュメントのカタログとアイテムセクションでご確認いただけます。
デイリー報酬の作成
デイリー報酬を作成するには：
- パブリッシャーアカウントでプロジェクトを開き、LiveOps > デイリー報酬セクションに移動します。
- パブリッシャーアカウントでプロジェクトを開き、LiveOps > デイリー報酬セクションに移動します。
- 「デイリー報酬を作成」をクリックします。
- 以下のパラメータを指定してください：
- デイリー報酬チェーンのタイトルを入力してください。
- 説明を入力してください（任意）。
- 「次へ」をクリックします。
- チェーンの該当日特定の日に報酬を追加します。これを行うには：
- 「報酬を追加」をクリックします。
- アイテムを選択し、ユーザーがこの日の報酬として受け取る数量を指定して、「保存」をクリックします。
- 全ての日付に報酬を追加した後、「次へ」をクリックします。
- デイリー報酬のタイプを、ログイン報酬または報酬カレンダーから選択してください。報酬タイプは作成段階で定義され、後から変更することはできません。
- デイリー報酬の開始日時を指定します。
- ログイン報酬タイプの場合、期限を追加するトグルをオンにし、プロモーションの終了日時を指定できます。
報酬カレンダータイプの場合、終了日は、報酬が作成された日数に基づいて自動的に計算されます。
- デイリー報酬チェーンが終了後に再開するようにしたい場合は、プロモーションを更新可能にするトグルをオンに設定してください。
- 更新ロジックは、チェーンのタイプによって異なります：
- ログイン報酬チェーンは、プロモーション期間が終了する前に、現在のサイクルが終了した後で再開します。
- 例： 5つの報酬からなるチェーンが10月1日から10月31日まで利用可能です。この設定が有効な場合、ユーザーは現在のサイクルが終了した後（5つの報酬を獲得した際、または進行状況をリセットした際に）に新しい報酬サイクルを開始できます。新しいサイクルはそれぞれ、チェーンの最初の報酬から始まります。プロモーション期間中、10月31日まで複数回更新できます。
- 報酬カレンダーチェーンは、報酬チェーンの長さと同じ頻度で、全てのユーザーに対して更新されます。
- 例： 5つの報酬からなるチェーンが10月1日から利用可能です。この設定が有効な場合、チェーンは全てのユーザーに対して5日ごと（10月6日、11日、16日など）に更新されます。
- ログイン報酬タイプの場合、ユーザーが少なくとも1日欠かした場合に進行状況をリセットするよう設定できます。これを行うには、「ユーザーが1日欠かした場合、進行状況をリセットする」のトグルをアクティブ化にします。この設定が無効の場合、ユーザーは日を空けて再度ログインした際に、中断したところから報酬の獲得を再開します。
- 例： 5つの報酬チェーンで、ユーザーが3日連続でログインし、4日目をスキップした場合、5日目には以下のようになります：
- リセット設定が有効の場合、ユーザーはチェーンの最初の報酬を受け取ります。
- リセット設定が無効の場合、ユーザーはチェーンの4番目の報酬を受け取ります。
- 「作成」をクリックします。
- パブリッシャーアカウントでプロジェクトを開き、LiveOps > デイリー報酬セクションに移動します。
- パブリッシャーアカウントでプロジェクトを開き、LiveOps > デイリー報酬セクションに移動します。
- デイリー報酬の行にある「•••」をクリックし、ドロップダウンリストから「アクティブ化」を選択してください。
デイリー報酬を編集する
デイリー報酬は、有効化、無効化、編集が可能です。ログイン報酬タイプの報酬の場合、現在のデイリー報酬サイクルにおける全ユーザーの進捗をリセットすることもできます。設定を変更するには、デイリー報酬の行にある「•••」をクリックし、目的のアクションを選択します。
アクティブなデイリー報酬チェーンは編集できません。変更を加えるには、まず無効化してください。
報酬チェーンのタイプ（ログイン報酬または報酬カレンダー）の編集はできません。このパラメータは、デイリー報酬の作成時にのみ設定可能です。
ログイン報酬チェーンの場合、以下の変更を行うと、全ユーザーの進行状況のリセットが必要となります：
- プロモーションを更新可能にする設定の変更
- ユーザーが1日欠かした場合、進行状況をリセットする設定の変更
- ステップの追加または削除
再有効化された後、このチェーンはプロモーション開始日以降にストアにログインしたすべてのユーザーに対して再開されます。すでにすべての報酬を獲得したユーザーも含まれます。
タイトル、報酬、説明、日付、時刻、またはタイムゾーンの変更は、進行状況のリセットを必要としません。ユーザーは中断した日から継続します。
報酬カレンダーチェーンの場合、変更を行ってもユーザーの進行状況をリセットする必要はありません。
API経由での設定
APIコールを使用してデイリー報酬のセットアップと管理を行うには、デイリー報酬グループの「管理者」セクションにある以下のコールを使用してください：
| タスク | APIコール |
|---|---|
| デイリー報酬を作成します。 | デイリー報酬を作成する。 |
| デイリー報酬をアクティブ化します。 | デイリー報酬を作成するまたはデイリー報酬を更新するのコールに“is_enabled”: trueパラメータを渡してください。また、デイリー報酬を切り替えるのコールを使用することも可能です。 |
| デイリー報酬を更新します。 | デイリー報酬を更新する。 |
| デイリー報酬を非アクティブ化します。 | デイリー報酬を切り替える。 |
| デイリー報酬を削除します。 | デイリー報酬を削除する。 |
ストアでのデイリー報酬の表示
エクソーラで作成したウェブサイトでの表示
サイトにデイリー報酬を表示するには：
- パブリッシャーアカウントのプロジェクトで、ストアフロント > ウェブサイトセクションに移動します。
- 対象サイトを選択し、「サイトビルダーを開く」をクリックします。
- アカウントでプロジェクトを開き、ストアフロント > ウェブサイトセクションに移動します。
- サイトのペインをクリックします。
- アカウントでプロジェクトを開き、ストアフロント > ウェブサイトセクションに移動します。
- サイトのペインをクリックします。
- アカウントでプロジェクトを開き、ストアフロント > ウェブサイトセクションに移動します。
- サイトのペインをクリックします。
- アカウントでプロジェクトを開き、ウェブショップセクションに移動します。
- サイトのペインをクリックします。
- サイトに複数のページが含まれている場合は、必要なページを選択してください：
- ビルダー上部にある現在のページタイトルをクリックします。
- ドロップダウンリストから必要なページを選択してください。
- ビルダーのメインエリアで、新しいブロックを追加したい場所を選び、「ブロックを追加」をクリックします。
- デイリー報酬ブロックを選択します。
- サイドメニューで、ブロック設定に移動します。
- ドロップダウンリストから、デイリー報酬チェーンを選択します。
- デイリー報酬チェーンをプレビューするには、ビルダーの右上隅にある「プレビュー」をクリックしてください。
- 変更を適用するには、ウェブサイトを公開します：
- サイトビルダーの右上隅で「公開」をクリックします。
- 公開したいページ名の横にあるチェックボックスをオンにします。
- 「公開」をクリックします。
サイトを公開できない場合は、以下の条件がすべて満たされているか確認してください：
- ビルダー内に空のセクション（赤いインジケーターでマークされた部分）はありません。
- エクソーラとのライセンス契約が締結締結されました。
- メインページが公開済みであるか、公開対象として選択されていること。メインページが公開される前に、子ページを公開することはできません。
ユーザーには、デイリー報酬チェーンが有効化され、その有効期間が開始されるまで表示されません。
有効期限が切れている、またはまだ開始されていないデイリー報酬チェーンは、サイトビルダーのプレビューモードで表示されます。このモードでは、非アクティブなチェーンを含む、未公開のすべての変更を確認できます。
自分のUIでの表示
- アプリケーションのUIに、デイリー報酬チェーンのステップを表示するための要素を実装します。
- デイリー報酬グループにある以下のクライアントサイドAPIコールを使用して、チェーンを操作するためのロジックを実装してください：
- アイテムがユーザーに正しく付与されていることを確認してください。
仕組み
デイリー報酬は、無料アイテムを提供することでユーザーに毎日ストアへのログインを促します。以下の種類のデイリー報酬を作成できます。
ログイン報酬 — ストアに初めてログインした後にユーザーが受け取れる報酬です。これらは設定で指定された固定時間に1日1つずつ順次アンロックされます。ユーザーが指定された時間以降に初めてストアにログインした場合、最初の報酬は翌日に利用可能になります。
例
報酬開始: 月曜日, 10:00 AM. 期間: 7日間。ストアにログイン 最初の報酬請求 2番目の報酬利用可能 ユーザー 1 月曜日, 09:00 月曜日, 10:00 AMから 火曜日, 10:00 AMから ユーザー 2 月曜日, 12:00 火曜日, 10:00 AMから 水曜日, 10:00 AMから ユーザー 3 火曜日, 12:00 水曜日, 10:00 AMから 木曜日, 10:00 AMから
報酬カレンダー — 特定の日付にすべてのユーザーが受け取れる報酬です。報酬は世界共通のスケジュールに従って同時にアンロックされ、ユーザーが初めてストアにログインしたタイミングには依存しません。
例
ユーザーがプロモーションの4日目に初めてストアにログインした場合、チェーンの4日目の報酬が表示されます。
以下のアイテムタイプが報酬として利用可能です。
- 仮想アイテム
- 仮想通貨パッケージ
- バンドル
デイリー報酬チェーンでは、以下のアイテム設定は無視されます。
- 個人用設定ルール
- 購入制限
- 公開スケジュール（開始日/終了日）
- プロモーションおよび割引
デイリー報酬は、ユーザーが順番にアンロックしていく「チェイン」形式で表示されます。最終日の報酬が完了した後に、自動的に再スタートするループ型のデイリー報酬チェインを開始できます。
デイリー報酬システムが正しく機能するには、ユーザー認証を有効にする必要があります。
認証されていないユーザーはデイリー報酬チェーン全体を見ることはできますが、報酬を受け取ることはできません。
ユーザーフロー
- ユーザーがストアを訪れます。
- ユーザーはデイリー報酬チェーンと今日のログインで利用可能な報酬を確認します。
- ユーザーがログインします。
- ユーザーはデイリー報酬チェーンの現在の進行状況を確認します。
- ユーザーがデイリー報酬を請求します。
前提条件
デイリー報酬チェーンを作成する前に、ユーザーがストアにログインした際に無料で獲得できるアイテムを作成する必要があります。
デイリー報酬を作成する
デイリー報酬を作成するには：
- パブリッシャーアカウントでプロジェクトを開き、LiveOps > Canvas セクションに移動します。
- モバイルゲームのアカウントでプロジェクトを開き、Operation > LiveOpsセクションに移動します。
- アカウントのプロジェクトで、LiveOps > Canvasセクションに移動します。
- アカウントのプロジェクトで、LiveOps > More > Canvasセクションに移動します。
- 次のいずれかの方法でデイリー報酬を作成します。
- ツールバーで**+**アイコンをクリックし、デイリー報酬を選択します。
- デイリー報酬リストエリアで**+**アイコンをクリックします。
- キャンバス上の任意の場所でコンテキストメニューを開き、デイリー報酬を選択します。
以下のパラメータを指定してください。
- デイリー報酬チェーンのタイトルを入力してください。
- 説明を入力してください（任意）。
次へをクリックします。
デイリー報酬のタイプをログイン報酬または報酬カレンダーから選択してください。報酬タイプは作成段階で定義され、後から変更することはできません。
デイリー報酬の有効期間を指定します。ログイン報酬タイプの場合、デイリー報酬チェーンの終了日を省略できます。そのためには、終了日なしトグルをオンにします。
デイリー報酬チェーンを終了後に再開したい場合は、デイリー報酬を更新可能にするトグルをオンにします。
更新ロジックはチェーンタイプに依存します。
ログイン報酬チェーンは、現在のサイクルが終了した後、プロモーションが終了する前に再開されます。
例: 5つの報酬からなるチェーンが10月1日から10月31日まで利用可能です。この設定が有効になっている場合、ユーザーは現在のサイクルが終了した後に新しい報酬サイクルを開始できます（5つの報酬を獲得するか進行をリセットした後）。各新しいサイクルはチェーンの最初の報酬から始まります。プロモーション期間中、10月31日まで複数回の更新が可能です。
報酬カレンダーチェーンは、報酬チェーンの長さ（日数）に応じて、すべてのユーザーに対して頻繁に再開されます。
例: 5つの報酬からなるチェーンが10月1日から利用可能です。この設定が有効になっている場合、チェーンはすべてのユーザーに対して5日ごとに更新されます — 10月6日、11日、16日など。
ログイン報酬タイプの場合、ユーザーが1日でも欠かした場合に進行をリセットする設定を構成できます。これを行うには、1日欠かした場合にユーザーの進行をリセットするトグルをオンにします。この設定が無効になっている場合、ユーザーは1日欠かした後にログインした際に、進行を中断したところから報酬を再開します。この設定はデイリー報酬の作成時にのみ構成でき、後から編集することはできません。
例: 5つの報酬からなるチェーンで、ユーザーが3日連続でログインし、4日目を欠かした場合、5日目には次のようになります。
- リセット設定が有効な場合、ユーザーはチェーンの最初の報酬を受け取ります。
- リセット設定が無効な場合、ユーザーはチェーンの4番目の報酬を受け取ります。
次へをクリックします。
チェーンの各日に報酬を追加します。1日の報酬を追加するには、次の手順を行います。
報酬を追加をクリックします。
アイテムを選択し、この日にユーザーが報酬として受け取る数量を指定し、報酬を追加をクリックします。
チェーン内の報酬の順序を変更するには、☰アイコンを使用して行を希望の位置にドラッグします（任意）。
すべての日付に報酬を追加した後、次へをクリックします。
プロモーション設定を確認します。
プロモーションをすぐにアクティブにする場合（任意）、アクティブステータスで作成トグルをオンにします。
作成をクリックします。
作成したデイリー報酬チェーンをサイトに追加するには（オプション）:
- 編集フォームのバナーでOpenまたはOpen in Site Builderをクリックして、ビルダーでサイトを開きます。
- ストアでデイリー報酬を表示セクションの指示に従います。
キャンバス上では、プロモーションカードとプロモーション内のアイテムの間にビジュアルリンクが表示されます。
表示を管理するには、プロモーションアイテムカードの右側にある
アイコンの隣にある→または←アイコンをクリックします。アイテムが複数のプロモーションに含まれている場合、一度に表示できるリンクは1つだけです。
デイリー報酬を編集する
デイリー報酬をアクティブ化、非アクティブ化、および編集できます。
次のいずれかの方法でプロモーションを編集に進むことができます。
- プロモーションカードから
- プロモーションリストから
プロモーションをアクティブ化する方法は次のとおりです。
- プロモーションカードから
- プロモーションリストから
- プロモーションを編集中
ログイン報酬タイプの報酬では、現在のデイリー報酬サイクル内で全ユーザーの進行をリセットすることも可能です。進行をリセットするには、デイリー報酬チェーンを編集中に
アイコンをクリックします。
報酬チェーンの編集に関する制限事項。
- アクティブなデイリー報酬チェーンは編集できません。変更を加えるには、まず無効化してください。
- ログイン報酬タイプのチェーンは一度に1つしかアクティブにできません。チェーンをアクティブ化すると、有効期間が重複するチェーンの無効化に関する警告が表示されます。
- 報酬チェーンタイプ（ログイン報酬または報酬カレンダー）の編集はできません。このパラメータはデイリー報酬の作成時にのみ設定できます。
- 1日欠かした場合にユーザーの進行をリセットする設定をログイン報酬タイプのチェーンで変更することはできません。
ログイン報酬チェーンの場合、次の変更には全ユーザーの進行リセットが必要です。
- プロモーションを更新可能にする設定の変更
- ステップの追加または削除
再有効化された後、このチェーンはプロモーション開始日以降にストアにログインしたすべてのユーザーに対して再開されます。すでにすべての報酬を獲得したユーザーも含まれます。
タイトル、報酬、説明、日付、時刻、またはタイムゾーンの変更は、進行状況のリセットを必要としません。ユーザーは中断した日から継続します。
報酬カレンダーチェーンの場合、変更を行ってもユーザーの進行状況をリセットする必要はありません。
ストアでのデイリー報酬の表示
エクソーラで作成したウェブサイトでの表示
サイトにデイリー報酬を表示するには：
- パブリッシャーアカウントのプロジェクトで、ストアフロント > ウェブサイトセクションに移動します。
- 対象サイトを選択し、「サイトビルダーを開く」をクリックします。
- アカウントでプロジェクトを開き、ストアフロント > ウェブサイトセクションに移動します。
- サイトのペインをクリックします。
- アカウントでプロジェクトを開き、ストアフロント > ウェブサイトセクションに移動します。
- サイトのペインをクリックします。
- アカウントでプロジェクトを開き、ストアフロント > ウェブサイトセクションに移動します。
- サイトのペインをクリックします。
- アカウントでプロジェクトを開き、ウェブショップセクションに移動します。
- サイトのペインをクリックします。
- サイトに複数のページが含まれている場合は、必要なページを選択してください：
- ビルダー上部にある現在のページタイトルをクリックします。
- ドロップダウンリストから必要なページを選択してください。
- ビルダーのメインエリアで、新しいブロックを追加したい場所を選び、「ブロックを追加」をクリックします。
- デイリー報酬ブロックを選択します。
- サイドメニューで、ブロック設定に移動します。
- ドロップダウンリストから、デイリー報酬チェーンを選択します。
- デイリー報酬チェーンをプレビューするには、ビルダーの右上隅にある「プレビュー」をクリックしてください。
- 変更を適用するには、ウェブサイトを公開します：
- サイトビルダーの右上隅で「公開」をクリックします。
- 公開したいページ名の横にあるチェックボックスをオンにします。
- 「公開」をクリックします。
サイトを公開できない場合は、以下の条件がすべて満たされているか確認してください：
- ビルダー内に空のセクション（赤いインジケーターでマークされた部分）はありません。
- エクソーラとのライセンス契約が締結締結されました。
- メインページが公開済みであるか、公開対象として選択されていること。メインページが公開される前に、子ページを公開することはできません。
ユーザーには、デイリー報酬チェーンが有効化され、その有効期間が開始されるまで表示されません。
有効期限が切れている、またはまだ開始されていないデイリー報酬チェーンは、サイトビルダーのプレビューモードで表示されます。このモードでは、非アクティブなチェーンを含む、未公開のすべての変更を確認できます。
自分のUIでの表示
- アプリケーションのUIに、デイリー報酬チェーンのステップを表示するための要素を実装します。
- デイリー報酬グループにある以下のクライアントサイドAPIコールを使用して、チェーンを操作するためのロジックを実装してください：
- アイテムがユーザーに正しく付与されていることを確認してください。
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
