プレイヤー セグメント全体に対する一括アクション

• 過去 2 週間にログインしたすべてのプレイヤーに、新年の特別なギフトを贈る。
• 過去 1 週間にお金を使ったプレイヤーに (支出の段階に基づいて) 報酬を与え、使った金額が多いほど価値の高いギフトを贈る。
• 最近のゲームのバグの影響を受けたすべてのプレイヤーについて、破損したプレイヤーの状態を修正する。

​

前提条件

​

手順 1 - セグメントを作成する

• 左側のメニューから PlayStream を選択します。
• [Segments] タブを選択します。
• 次に [New Segment] ボタンを選択します。
• [Segment Name] を High XP Players にします。
• [Player] として定義し、Total_XP Gained という [Statistic Value] が 2725 より大きいという条件にします。

​

手順 2 - このセグメントのタスクを作成する

• [Segments] タブを選択します。
• 次に [RUN TASK …] を選択します。

​

手順 3 - タスクにアクションを追加する

• 名前を Reward High XP Players に変更します。
• 説明として Give a gift to Players who are level 2 or higher を追加します。
• [ADD ACTION] を選択します。
  • 表示されたフィールドに Grant virtual currency と入力します。
  • [Virtual Currency] コード: GM (Gems の略)。
  • Amount: 20
• スケジュールは、今のところ [Manually] のままにします。
• [SAVE AND RUN] ボタンを選択してタスクを実行します。

​

手順 4 - タスクを監視する

• 処理されたプレイヤーの数。
• タスクが開始された日時。
• 完了までにかかった時間。
• 起動時のパラメーター。
• 実行したユーザー。
• 手動でスケジュールされたかどうか、など。

• [Players] タブに移動します。
• 対象の プレイヤー を選択します。
• 次に [Event History] タブを選択します。
• 一覧の最新のイベントは player_virtual_currency_balance_changed になっているはずで、プレイヤー のジェムが 20 増加したことが示されています。

​

次のステップ

​

タスクをスケジュールする

​

各プレイヤーに対して CloudScript を実行する

1. 毎週リセットされ、集計方法 Last を使用する新しい統計 Event_QuestsCompleted を作成します。
2. Total_QuestsCompleted が変更されるたびにこの Event_QuestsCompleted 統計をインクリメントする、新しい PlayStream アクションを作成します。
3. 一括アクション タスクによって呼び出される CloudScript 関数を作成します。この関数は、プレイヤーを順に処理し、最後の値に基づいて報酬を与えます。

// this function will be called as a bulk action by a scheduled task for players in a segment
handlers.GiveTieredReward = function (args, context) {
    var profile = context.playerProfile;

    var statVersion = 0;        // set to whatever version you need to use

    var getStatRequest = {};
    getStatRequest.PlayFabId = profile.PlayerId;
    getStatRequest.StatisticNameVersions = [{ "StatisticName": "Event_QuestsCompleted", "Version": statVersion }];

    try {
        getStatRequest.PlayerResult = server.GetPlayerStatistics(getStatRequest);
    } catch (e) {
    };

    if (getStatRequest.PlayerResult && getStatRequest.PlayerResult.Statistics.length > 0) {
        getStatRequest.lastScore = getStatRequest.PlayerResult.Statistics[0].Value
    }

    if (getStatRequest.lastScore && getStatRequest.lastScore > 2) {
        // give gift to all players with more than 2 quests completed in last event
        // in a real event we would want to use a lookup table of gifts
        // but here we are just hard-coding it
        var giftRequest = {};
        giftRequest.PlayFabId = profile.PlayerId;
        giftRequest.ItemIds = ["CrystalKey"];
        giftRequest.grantResult = server.GrantItemsToUser(giftRequest);
        return giftRequest;
    } else {
        return getStatRequest;
    }
}

4. 新しい CloudScript のバージョンを Live に設定し、すべてのプレイヤーに対して GiveTieredReward 関数を呼び出す新しいタスクを作成します。タスクの [Save] と [Run] を忘れずに行ってください。
5. このタスクからのイベントが PlayStream イベント デバッガーに表示されることがわかります。
6. (タイム スタンプを選択して) 任意の player triggered action executed CloudScript イベントを選択すると、各プレイヤーの CloudScript 実行の詳細な結果を確認できます。これには、CloudScript 実行時点のプレイヤー プロファイルのスナップショットなど、有用な診断情報が含まれます。