バッチジョブ | Staging Site

フリーゲームの「バッチジョブ」ページでは、バッチの割り当ておよびキャンセルの状況を簡単に確認できます。正常に割り当てられたプレイヤーや、ジョブ実行中に発生したエラーを把握できるほか、このページから直接バッチジョブのキャンセルや、キャンセル済みジョブの確認も行えます。

バッチジョブのフィルタ

フィルタを使用して検索条件を絞り込んでください。結果を表示するには「送信」ボタンをクリックし、フィルタをリセットして最初からやり直すには「フィルタをクリア」をクリックしてください。

フィルタ	説明
エンティティフィルタ	ヘッドオフィス、マスターエージェント、エージェントのフィルタを使用して、関連するエンティティのデータを表示できます。エンティティフィルタはすべて、単一選択であることに注意してください。メニューに選択肢が1つしかない場合は、その選択肢が自動で表示され、選択済み状態になります。
ファイルアップロード期間	利用可能なパラメータを使用して、ユーザーはレポートのファイルアップロード期間を定義することができます。デフォルトでは、開始日は現在の日時の24時間前に自動的に設定され、終了日は現在の日時に設定されます。
タイムゾーン	報告に表示されるデフォルトのタイムゾーンを変更します。タイムゾーンを設定することで、マスターエージェントとヘッドオフィスが、同じタイムゾーンにある全エージェントの財務データをまとめて見ることができます。デフォルトのタイムゾーンは、設定ページで設定されたタイムゾーンによって決定されます。ユーザーが設定ページでタイムゾーンを変更しない場合、デフォルトのタイムゾーンはGMT+0になります。
ファイルアップロード状態	レポートのフィルタリングを行うために、ユーザーはファイルのアップロード状況を「すべて」、「割り当て進行中」、または「割り当て完了」のいずれかから選択するオプションがあります。
オファー名	特定のオファーのデータを取得するために、レポートでは検索ボックスを使用したフィルタリングがサポートされています。検索機能は、名前の部分一致をサポートしており、名前の先頭が一致する限り、部分的に一致した結果を返します。たとえば、検索クエリとして"ABC"を入力した場合、システムは"ABC123"や"ABCD456"など、"ABC"で始まる名前を持つ結果を返します。
オファーID	特定のオファーのデータを取得するために、検索ボックスを使用して目的のオファーIDを入力し、レポートをフィルタリングできます。オファーIDには以下の制限があります: 最大36文字まで、文字、数字、および'-'文字のみが許可されます。オファーIDの形式はXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXXです。この検索機能は、IDの先頭が一致する限り部分一致をサポートしています。たとえば、検索クエリとして"ABC"を入力した場合、システムは"ABC123"や"ABCD456"など、"ABC"で始まるIDを持つ結果を返します。
バッチ参照番号	特定のバッチジョブのデータを取得するには、検索ボックスを使用してバッチ参照番号を入力し、レポートをフィルタリングすることができます。検索機能はIDの部分一致をサポートしており、IDの先頭部分が一致していれば結果を返します。例えば、検索クエリとして「ABC」と入力すると、システムは「ABC123」や「ABCD456」など、先頭が「ABC」で始まるIDの結果を返します。

バッチジョブの閲覧と管理

フィルターを適用すると、選択した条件に一致するバッチジョブが一覧表示されます。「リフレッシュ」をクリックすると、最新の割り当て期間数やエラー情報に基づいてテーブルが更新されます。

タブの概要
バッチジョブページには、以下の2つのタブがあります：

割り当て済み：現在割り当てられているバッチジョブを表示
キャンセル済み：キャンセルされたバッチジョブを表示

batch job list - Assigned - JP copy.png — バッチジョブのキャンセル

列名	説明
バッチ参照番号	バッチジョブの参照番号。
割り当て状況	ファイルのアップロード状況。「完了」または「進行中」。
割り当て済み件数	正常に割り当てられた件数を示します
エラーが見つかりました	バッチジョブのアップロードで見つかったエラーの数を示します。
アップロード開始時間	バッチジョブが開始された日時。
オファー名	フリーゲームのオファーの名前。
オファーID	フリーゲームオファーの識別子。
プレイヤーへの割り当て日付	オファー割り当て回数の開始日、または利用可能期間の開始。
アクション	ユーザーはアイコンの上にカーソルを合わせてツールチップを表示できます。 .CSVファイルをダウンロードするアイコンをクリックすると、ユーザーはアップロードした .CSV ファイルのコピーを取得できます。これにはオファーに関連するプレイヤーリストが含まれています。

バッチジョブのキャンセル

割り当て済みタブでは、ユーザーはバッチ割り当てをキャンセルできます：

1件以上のバッチジョブを選択します。
バッチジョブ一覧表の右上にある「キャンセル」ボタンをクリックします。
表示されるモーダルでキャンセルを確認します。

キャンセル状況の確認

キャンセル後、バッチジョブは「割り当て済み」タブから「キャンセル済み」タブに移動します。ユーザーは「キャンセル済み」タブで進捗状況を確認できます。

注：以下のいずれかに該当する場合、キャンセルは失敗します：部分的または完全に使用された割り当て、プレイヤーによる拒否、オファーの有効期限切れ、割り当てエラー、またはキャンセル API エラー。

batch job list - Cancelled - JP copy.png — キャンセルの進捗は「キャンセル済み」タブで確認できます。

列名	説明
バッチ参照番号	バッチジョブの参照番号。
キャンセル状況	キャンセルの進行状況。「進行中」または「完了」。
キャンセル済み割り当て	キャンセルされた割り当ての数を示します。
キャンセル不可割り当て	部分的または完全に使用された割り当て、プレイヤーによる拒否、オファーの有効期限切れ、または割り当て・キャンセル API エラーが発生した割り当ての数を示します。
オファー名	フリーゲームのオファーの名前。
オファーID	フリーゲームオファーの識別子。

バッチジョブの詳細を表示

「バッチジョブ」ページの「割り当て済み」タブまたは「キャンセル済み」タブの任意の行をクリックすると、「バッチジョブ詳細」ページにアクセスできます。このページでは、オファーの情報、進行状況、および関連するエラーを確認できます。

このページの内容は、バッチジョブの種類によって異なります：

バッチジョブの割り当て詳細

オファー情報
バッチ参照番号
割り当て済み： 正常に割り当てられた割り当ての数を示します。

バッチジョブでエラー、重複エントリ、または新たに検出されたプレイヤーが発生した場合、該当する問題の種類がリストに表示されます。問題の種類をクリックすると、影響を受けた「プレイヤーID」および「割り当てID」が表示されます。

batch job detail list - assignment complete - JP.png

オファー情報

列名	説明
オファー名	フリーゲームのオファーの名前。
オファーID	フリーゲームオファーの識別子。
オファー期間	オファーが利用可能な日付。
有効期間	プレイヤーがオファーを使用できる期間。
ラウンド数	オファーに含まれるラウンドの数。
オファーのステータス	オファーの現在のステータス。
通貨	オファーで使用される通貨の種類。

サマリーテーブル

列名	説明
ファイル名	アップロードされた.CSVファイルの名前
プレイヤー数	.CSVファイルで検出されたプレイヤーの合計数
エラーが見つかりました	割り当てプロセス中にエラーが発生したプレイヤーの数です。エラーのあるプレイヤーはオファーに割り当てられません。エラーのあるプレイヤーの詳細なリストを表示するには、ユーザーはサマリーテーブルの下にある「エラーが見つかりました」テーブルを参照できます。「エラーが見つかりました」表には、ユーザーに表の概要をエクセルの.CSVファイルで提供する「エクスポート」ボタンが含まれています。割り当て完了のステータスは、すべてのプレイヤーIDが正常に割り当てられたことを示すものではありません。例えば、APIが割り当てプロセス中にエラーを検出した場合、プレイヤーが「エラーが見つかりました」リストに表示されます。このような場合、ユーザーは失敗したプレイヤーIDのみを含む.CSVファイルを再アップロードする必要があります。
重複が見つかりました	システムがオファーへの重複割り当てを検出したプレイヤーの数です。プレイヤーIDが複数回表示される場合、各出現は1つのレコードを更新する代わりに、重複した割り当てとなります。
新しいプレイヤー	MG+システムに存在しないプレイヤーIDがリストされているため、新しく作成されてオファーに割り当てられたプレイヤーの数です。

バッチジョブキャンセルの詳細

オファー情報
バッチ参照番号
キャンセル済み割り当て：キャンセルが正常に完了した割り当ての数を示します。
キャンセル不可割り当て：キャンセルできなかった割り当てを示します。下の「キャンセル不可割り当ての詳細」テーブルには、その原因および影響を受けたプレイヤー ID と割り当て ID が表示されます。

batch job detail list - cancelled complete - JP copy.png

キャンセル不可割り当て詳細

列名	説明
キャンセルに失敗しました	システム／API エラーにより、キャンセルを完了できませんでした。
一部使用済み	プレイヤーは割り当てられたラウンドのうち、少なくとも1ラウンドを使用しています。
全て使用済み	プレイヤーは割り当てられたラウンドをすべて使用しました。
プレイヤー拒否	プレイヤーが「ゴミ箱」アイコンをクリックして割り当てを拒否しました。
期限切れ	プレイヤーは有効期間内にすべてのラウンドをプレイしませんでした。
割り当てエラー	割り当て処理に失敗しました。この場合、割り当てはまだ作成されていません。