> ## 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.

# Cupones y promociones en Economy (heredada)

> Genere y canjee cupones de PlayFab Legacy Economy desde Game Manager y combínelos con lotes o CloudScript para impulsar promociones dentro del juego.

# Cupones y promociones (Economía heredada)

<Info>
  Las API de Economy v1 están en modo de mantenimiento y no recibirán nuevas características, solo correcciones de errores. **Las API v1 se mantendrán en el futuro previsible.** Consulte la [Información general de Economy v2](/services/playfab/economy-monetization/economy-v2/overview) para obtener más información sobre la próxima versión de PlayFab Economy.
</Info>

Los cupones son tokens de cadena que puede generar para que sus clientes los usen para canjear artículos de inventario en su juego. Combinados con lotes o CloudScript, estos cupones podrían usarse para desencadenar casi cualquier funcionalidad de su juego.

## Requisitos

* Estar familiarizado con los [Catálogos](/services/playfab/economy-monetization/economy/items/catalogs), los lotes y los contenedores.
* Estar familiarizado con [Game Manager](/services/playfab/live-service-management/gamemanager).
* Estar familiarizado con el [Inventario del jugador](/services/playfab/player-progression/player-data/player-inventory).

## Instrucciones para generar y canjear cupones

Todos los ejemplos que siguen comparten el primer paso básico de generar un cupón. Esto se hace en Game Manager.

Desde **Game Manager**:

* Vaya a su **título**.
* Seleccione **Economy** en el menú de la izquierda.
* Vaya a la pestaña **Catalogs**.

En cualquiera de las tres secciones de pestañas: **Items**, **Bundles** y **Containers**, hay un vínculo **Coupons**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=01c2a878fe4e703656b294f53ee70c21" alt="Game Manager - Economy - Artículos del catálogo - Botón Coupons" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png" />

El vínculo abre una ventana que le permite generar cupones para cualquiera de los artículos de la sección. Si desea crear cupones para un artículo específico:

* Seleccione **Coupons** en la pestaña **Items**.
* Los **Coupons** de lotes en **Bundles** y los **Coupons** de contenedores en **Containers**.

La ventana emergente es similar a la que proporcionamos a continuación. (Su lista de artículos debería coincidir con su título. Los artículos mostrados se describen en nuestro tutorial de [Tablas de botín](/services/playfab/economy-monetization/economy/tutorials/drop-tables)).

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=ca852ef6cb03a6bc62d187fa93dca085" alt="Game Manager - Generar cupones" width="1053" height="733" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png" />

Para completar la generación de cupones:

* Seleccione una cantidad de **Coupons** para generar.

* Después, seleccione el **artículo** que deben generar los **Coupons**.

* A continuación se puede descargar el archivo de texto **CSV** con una lista de **Coupons**.

Al seleccionar uno de los vínculos del ejemplo, se generan los siguientes diez **Coupons** separados por comas.

```xml theme={null}
65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz
```

Finalmente, el cliente puede canjear un cupón si usted proporciona una GUI que le permita escribir el código, que después llama a [RedeemCoupon](xref:titleid.playfabapi.com.client.playeritemmanagement.redeemcoupon).

```csharp theme={null}
// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}
```

### Caso de ejemplo: cupón de artículo de inventario

La manera más sencilla de usar cupones es regalar un artículo de inventario. Una vez creado el catálogo, puede generar cupones para artículos normales siguiendo las instrucciones anteriores que ya hemos comentado. No hay otros pasos especiales para este caso.

### Caso de ejemplo: cupón de moneda virtual *o* cupón de varios artículos

Los cupones no pueden conceder [moneda virtual](/services/playfab/economy-monetization/economy/tutorials/currencies) directamente, y solo pueden conceder un único artículo.

Sin embargo, los lotes se pueden usar para convertir artículos de inventario sin problemas en grupos de artículos o en moneda virtual. En el ejemplo de moneda virtual, debe crear un nuevo artículo de lote con contenido de moneda virtual.

Configure el lote para que expire en **15 segundos**. De esta manera, el jugador verá inmediatamente la moneda virtual en cuanto abra el lote, y no verá el artículo intermedio.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=1811ef16679c9be97687ef51cc436fc0" alt="Game Manager - Economy - Editar lote del catálogo" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png" />

Los artículos múltiples funcionan de la misma manera:

* Cree un lote con varios artículos, o incluso con [tablas de botín](/services/playfab/economy-monetization/economy/tutorials/drop-tables).
* Configúrelo para que expire en **15 segundos**.
* El cupón puede generar el lote.
* El lote se convierte entonces en varios artículos.
* El artículo de lote intermedio desaparece.

## Escenarios de uso

* Recompensas físicas en convenciones:
  * Puede imprimir su lista de códigos de cupón y repartirlos como obsequios en convenciones.
* Comunicación fuera del juego, como foros, [notificaciones push](/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart) y correo electrónico.
  * Envíe a sus jugadores códigos de cupón *directamente*, como parte de campañas de readquisición u otras iniciativas de contacto con la comunidad.
* Torneos:
  * Envíe cupones a los jugadores mejor clasificados cuando use [tablas de clasificación restablecibles](/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).

<Note>
  En este caso también puede entregar artículos de inventario directamente, así que elija lo que sea más relevante para su juego.
</Note>

## Procedimientos recomendados

Al usar el inventario de PlayFab, debe mantener los tamaños de inventario relativamente pequeños: *menos de 100 artículos en total* por jugador. Un lote que conceda *demasiados artículos* puede sufrir limitaciones de velocidad o restricciones.


## Related topics

- [Administrar monedas virtuales en Economy (heredada)](/es/services/playfab/economy-monetization/economy/tutorials/currencies.md)
- [Tablas de botín en Economy (heredada)](/es/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Tiendas personalizadas para segmentos de jugadores en Economy (heredada)](/es/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
- [Procedimientos recomendados para la segmentación de tiendas en Economy (heredada)](/es/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation.md)
- [Documentación de PlayFab Economy](/es/services/playfab/economy-monetization/economy/index.md)
