> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adición de un valor de campo a una regla de estadística

> Guía sobre el uso de nombres de campo de evento frente a valores de campo en las plantillas de reglas de estadísticas basadas en eventos de XBOX Live para evitar instancias de estadísticas no deseadas.

En este tema se describe cómo, por lo general, debe agregar un nombre de campo, en lugar de un valor de campo, a una regla de estadística.

## El valor del evento se agrega al nombre de la estadística

Las plantillas de estadísticas son eficaces y flexibles, pero a veces pueden producir resultados no deseados si no se configuran correctamente. Las plantillas de estadísticas crean rutas de estadísticas variables, o instancias de estadísticas. Las plantillas de estadísticas dan como resultado nombres de estadísticas basados en variables que se derivan del nombre *y del valor* de los campos seleccionados en el evento de origen.
Así es como podría capturar algo como *cuánto* oro ganó un jugador en cada mapa.

No solo los *nombres* de los eventos se agregan al nombre de la estadística, sino también los *valores* de los eventos. Esto a menudo puede producir confusión y resultados no deseados.

## Ejemplo de una única regla de estadística

Supongamos que su juego envía un evento denominado `GameEnd`. Tiene un campo `int` denominado `Map` y un campo `int` denominado `Gold`.

Para capturar la puntuación máxima por mapa mediante una única regla de estadística, daría un nombre a la estadística, como `GoldByMap`, y agregaría un campo `Map` a la regla de estadística. En este ejemplo, el valor de `Map` es un identificador numérico.

Su parámetro (el campo que contiene el valor por el que desea incrementar la estadística) sería el campo `Gold` del evento `GameEnd`.

Supongamos que su juego envía un evento `GameEnd` a los servicios de XBOX. El valor del campo `Map` del evento es 1. El valor del campo `Gold` es 100.
El resultado es que la estadística se escribe en la ruta de estadística: `GoldByMap.Map.1`. El nuevo valor de esta ruta de estadística es 100.

En la tabla siguiente se muestra lo que tenemos hasta ahora.

| Elemento  | Tipo                | Notas                                        |
| --------- | ------------------- | -------------------------------------------- |
| `GameEnd` | Un evento           | Enviado por su juego a los servicios de XBOX |
| `Map`     | Un campo del evento | Un `int`                                     |
| 1         | `int`               | El valor del campo `Map`                     |
| `Gold`    | Un campo del evento | Un `int`                                     |
| 100       | `int`               | El valor del campo `Gold`                    |

La ruta de estadística tiene las partes que se muestran en la tabla siguiente.

| Elemento          | Tipo                     | Notas                                        |
| ----------------- | ------------------------ | -------------------------------------------- |
| `GoldByMap.Map.1` | Una ruta de estadística  | El valor de esta ruta de estadística es 100. |
| `GoldByMap`       | Un nombre de estadística | N/D.                                         |
| `Map`             | Una regla de estadística | Un identificador numérico.                   |

Si el siguiente evento llega con un valor de `Map` de 2, el campo `Gold` de ese evento se agrega a esa nueva ruta de estadística: `GoldByMap.Map.2`.

Supongamos que el campo `Gold` del evento tiene el valor 200.
Ahora también tendríamos lo que se muestra en la tabla siguiente.

| Elemento          | Tipo                    | Notas                                        |
| ----------------- | ----------------------- | -------------------------------------------- |
| `GoldByMap.Map.2` | Una ruta de estadística | El valor de esta ruta de estadística es 200. |

De esta forma, puede mantener los valores de las estadísticas separados, sin necesidad de definir una estadística para cada `Map`.

## Ejemplo de agregar por error un nombre de campo en lugar de un valor de campo a la regla de estadística

Con el ejemplo anterior, veamos qué resultados incorrectos se producen cuando también agrega el nombre de campo `Gold` a la regla de estadística `Map`, en lugar de agregar solo el valor del parámetro `Gold`. Esto daría como resultado el siguiente nombre de estadística: `GoldByMap.Map.1.Gold.100`.

Observe que el valor del oro ganado por el jugador (100) también está en el nombre de la estadística.
Esto significa que un jugador que gane 100 de oro en el mapa 1 obtendrá un valor de 100 para esta estadística: `GoldByMap.Map.1.Gold.100`.

Si un jugador ganara 101 de oro en ese mapa, esta configuración daría como resultado lo siguiente, que es un nombre de estadística diferente: `GoldByMap.Map.1.Gold.101`. El resultado es que estas estadísticas solo se incrementarían cuando el jugador gane la cantidad específica de oro definida en el nombre de la estadística, lo que probablemente no era la intención.


## Related topics

- [Configuración en el portal de estadísticas y tablas de clasificación basadas en eventos](/es/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [Configuración](/es/services/xbox-services/player-data/stats-leaderboards/event-based/config/index.md)
- [Configurar estadísticas y reglas de estadísticas de XBOX en Partner Center](/es/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-stats.md)
- [Creación de una estadística básica](/es/services/playfab/player-progression/statistics/create-basic-statistics.md)
- [Escrituras de transacción](/es/services/playfab/player-progression/statistics/transactional-writes.md)
