Actions en bloc pour un segment de joueurs entier

• Offrir un cadeau spécial du Nouvel An à tous les joueurs qui se sont connectés au cours des 2 dernières semaines.
• Récompenser les joueurs qui ont dépensé de l’argent au cours de la dernière semaine (en fonction de paliers de dépenses), le cadeau étant d’autant plus précieux qu’ils ont dépensé davantage.
• Corriger l’état corrompu des joueurs pour tous les joueurs affectés par un bogue récent du jeu.

​

Prérequis

​

Étape 1 - Créer le segment

• Sélectionnez PlayStream dans le menu de gauche.
• Choisissez l’onglet Segments.
• Sélectionnez ensuite le bouton New Segment.
• Définissez le Segment Name sur High XP Players.
• Définissez-le comme Player, où la Statistic Value nommée Total_XP Gained est supérieure à 2725.

​

Étape 2 - Créer une tâche pour ce segment

• Sélectionnez l’onglet Segments.
• Sélectionnez ensuite RUN TASK …

​

Étape 3 - Ajouter des actions à la tâche

• Remplacez le nom par Reward High XP Players
• Ajoutez cette description : Give a gift to Players who are level 2 or higher.
• Sélectionnez ADD ACTION
  • Tapez Grant virtual currency dans le champ prévu à cet effet.
  • Code de Virtual Currency : GM (abréviation de Gems).
  • Montant : 20
• Laissez la planification sur Manually pour l’instant.
• Sélectionnez le bouton SAVE AND RUN pour exécuter la tâche.

​

Étape 4 - Surveiller votre tâche

• Le nombre de joueurs traités.
• L’heure de démarrage de la tâche.
• La durée nécessaire à son exécution.
• Les paramètres dont elle disposait lors de son lancement.
• La personne qui l’a exécutée.
• Si elle a été planifiée manuellement, etc.

• Accédez à l’onglet Players.
• Sélectionnez votre Player.
• Choisissez ensuite l’onglet Event History.
• L’événement le plus récent de la liste doit être un player_virtual_currency_balance_changed, qui doit montrer une augmentation de 20 gemmes pour votre Player.

​

Étapes suivantes

​

Planifier vos tâches

​

Exécuter CloudScript pour chaque joueur

1. Créez une nouvelle statistique Event_QuestsCompleted, qui se réinitialise chaque semaine et utilise la méthode d’agrégation Last.
2. Créez une nouvelle action PlayStream qui incrémente cette statistique Event_QuestsCompleted chaque fois que Total_QuestsCompleted est modifiée.
3. Écrivez une fonction CloudScript destinée à être appelée par une tâche d’action en bloc, qui parcourra les joueurs et accordera des récompenses en fonction de la dernière valeur.

// 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. Définissez la nouvelle version de CloudScript sur Live, puis créez une nouvelle tâche qui appelle la fonction GiveTieredReward pour tous les joueurs. N’oubliez pas d’enregistrer (Save) et d’exécuter (Run) la tâche.
5. Vous devriez voir apparaître les événements de cette tâche dans le débogueur d’événements PlayStream.
6. Vous pouvez sélectionner n’importe quel événement « player triggered action executed CloudScript » (en sélectionnant l’horodatage) et voir le résultat détaillé de l’exécution de CloudScript pour chaque joueur. Cela inclut des informations de diagnostic utiles, comme l’instantané du profil du joueur au moment de l’exécution de CloudScript.