Acciones masivas para todo un segmento de jugadores

• Dar un regalo especial de Año Nuevo a todos los jugadores que iniciaron sesión durante las últimas 2 semanas.
• Recompensar a los jugadores que gastaron dinero en la última semana (según niveles de gasto), de modo que cuanto más dinero gastaron, más valioso sea el regalo.
• Corregir el estado dañado de los jugadores para todos los jugadores afectados por un error reciente del juego.

​

Requisitos previos

​

Paso 1: Crear el segmento

• Seleccione PlayStream en el menú de la izquierda.
• Elija la pestaña Segments.
• A continuación, seleccione el botón New Segment.
• Establezca el Segment Name: High XP Players.
• Defínalo como Player, donde el Statistic Value llamado Total_XP Gained sea mayor que 2725.

​

Paso 2: Crear una tarea para este segmento

• Seleccione la pestaña Segments.
• A continuación, seleccione RUN TASK …

​

Paso 3: Agregar acciones a la tarea

• Cambie el nombre a Reward High XP Players
• Agregue esta descripción: Give a gift to Players who are level 2 or higher.
• Seleccione ADD ACTION
  • Escriba Grant virtual currency en el campo proporcionado.
  • Código de Virtual Currency: GM (abreviatura de Gems).
  • Cantidad: 20
• Por ahora, deje la programación establecida en Manually.
• Seleccione el botón SAVE AND RUN para ejecutar la tarea.

​

Paso 4: Supervisar la tarea

• Cuántos jugadores se procesaron.
• Cuándo se inició la tarea.
• Cuánto tiempo tardó en completarse.
• Los parámetros que tenía cuando se inició.
• Quién la ejecutó.
• Si se programó manualmente, etc.

• Vaya a la pestaña Players.
• Seleccione su Player.
• A continuación, elija la pestaña Event History.
• El evento más reciente de la lista debería ser un player_virtual_currency_balance_changed, que debería mostrar que las gemas de su Player aumentaron en 20.

​

Pasos siguientes

​

Programar las tareas

​

Ejecutar CloudScript para cada jugador

1. Cree una nueva estadística Event_QuestsCompleted, que se restablezca semanalmente y use el método de agregación Last.
2. Cree una nueva acción de PlayStream que incremente esta estadística Event_QuestsCompleted cada vez que cambie Total_QuestsCompleted.
3. Escriba una función de CloudScript para que la llame una tarea de acción masiva, que recorrerá los jugadores y dará recompensas según el último valor.

// 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. Establezca la nueva versión de CloudScript en Live y cree una nueva tarea que llame a la función GiveTieredReward para todos los jugadores. No olvide seleccionar Save y Run en la tarea.
5. Debería ver que los eventos de esta tarea aparecen en el depurador de eventos de PlayStream.
6. Puede seleccionar cualquier evento de CloudScript ejecutado por una acción desencadenada por un jugador (seleccionando la marca de tiempo) y ver el resultado detallado de la ejecución de CloudScript para cada jugador. Esto incluye información de diagnóstico útil, como la instantánea del perfil del jugador en el momento de la ejecución de CloudScript.