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 (selon des niveaux de dépenses) : plus ils ont dépensé, plus le cadeau est précieux.
• Corriger l’état de joueur corrompu pour tous les joueurs touché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 : High XP Players.
• Définissez-le comme Player, où la Statistic Value appelé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

• Changez le nom pour 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.
  • Code de Virtual Currency : GM (abréviation de Gems).
  • Montant : 20
• Laissez la planification à 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.
• Le moment où la tâche a démarré.
• Le temps qu’elle a pris pour se terminer.
• Les paramètres qu’elle avait au moment 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 devrait être un player_virtual_currency_balance_changed, qui devrait montrer que les gemmes de votre Player ont augmenté de 20.

​

Prochaines étapes

​

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 change.
3. Écrivez une fonction CloudScript qui sera appelée par une tâche d’action en bloc, laquelle parcourra les joueurs et leur donnera 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, et 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 d’exécution de CloudScript déclenché par une action de joueur (en sélectionnant l’horodatage), et voir le résultat détaillé de l’exécution de CloudScript pour chaque joueur. Cela comprend des renseignements de diagnostic utiles, comme l’instantané du profil du joueur au moment de l’exécution de CloudScript.