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

# Economy（旧版）中的优惠券和促销

> 在 Game Manager 中生成和兑换 PlayFab 旧版 Economy 优惠券，并将其与捆绑包或 CloudScript 配合使用来驱动游戏内促销活动。

# 优惠券和促销（旧版 Economy）

<Info>
  Economy v1 API 处于维护模式，不会接收任何新功能，只有 bug 修复。\*\*v1 API 在可预见的将来将持续维护。\*\*参见 [Economy v2 概览](/services/playfab/economy-monetization/economy-v2/overview)，了解有关 PlayFab Economy 下一版本的更多信息！
</Info>

优惠券是你可以为客户生成的字符串令牌，用于兑换游戏中的库存物品。与捆绑包或 CloudScript 结合使用，这些优惠券几乎可以触发你游戏中的任何功能。

## 要求

* 熟悉[目录](/services/playfab/economy-monetization/economy/items/catalogs)、捆绑包和容器。
* 熟悉 [Game Manager](/services/playfab/live-service-management/gamemanager)。
* 熟悉[玩家库存](/services/playfab/player-progression/player-data/player-inventory)。

## 生成和兑换优惠券说明

以下所有示例都共享生成优惠券的第一个基本步骤。这在 Game Manager 中完成。

从 **Game Manager**：

* 导航到你的 **Title**。
* 从左侧菜单中选择 **Economy**。
* 转到你的 **Catalogs** 选项卡。

在 **Items**、**Bundles** 和 **Containers** 这三个选项卡部分中，都有一个 **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 - Catalog Items - Coupons button" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png" />

该链接会打开一个窗口，让你可以为该部分中的任何物品生成优惠券。如果你希望为特定物品创建优惠券：

* 在 **Items** 选项卡中选择 **Coupons**。
* 在 **Bundles** 下选择 Bundle **Coupons**，在 **Containers** 下选择 Container **Coupons**。

弹出窗口类似于我们下面提供的窗口。（你的物品列表应与你的游戏匹配。所显示的物品在我们的[掉落表](/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 - Generate Coupons" width="1053" height="733" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png" />

要完成优惠券生成：

* 选择要生成的 **Coupons** 数量。

* 然后选择 **Coupons** 应生成的 **Item**。

* 然后可以下载包含 **Coupons** 列表的 **CSV** 文本文件。

选择示例中的一个链接会生成以下十个逗号分隔的 **Coupons**。

```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
```

最后，如果你提供了一个让客户输入代码的 GUI，客户就可以兑换优惠券，该 GUI 会调用 [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);
}
```

### 示例场景：库存物品优惠券

使用优惠券最直接的方式是赠送一个库存物品。创建目录后，你可以按照我们已经讨论过的说明为常规物品生成优惠券。此情况没有其他特殊步骤。

### 示例场景：虚拟货币优惠券*或*多物品优惠券

优惠券无法直接授予[虚拟货币](/services/playfab/economy-monetization/economy/tutorials/currencies)，并且它们只能授予单个物品。

不过，捆绑包可以无缝地将库存物品转换为物品组或虚拟货币。在 VC 示例中，你应创建一个新的捆绑物品，内容为 VC。

将捆绑包设置为在 **15 秒**内过期。这样，玩家打开捆绑包后会立即看到 VC，而不会看到中间物品。

<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 - Edit Catalog Bundle" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png" />

多物品的工作方式相同：

* 创建一个包含多个物品的捆绑包 - 甚至[掉落表](/services/playfab/economy-monetization/economy/tutorials/drop-tables)。
* 将其设置为在 **15 秒**内过期。
* 优惠券可以生成该捆绑包。
* 然后捆绑包被转换为多个物品。
* 中间的捆绑物品消失。

## 使用场景

* 展会上的实物奖励：
  * 你可以打印你的优惠券代码列表，并作为展会上的赠品分发。
* 游戏外通信，如论坛、[推送通知](/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart)和电子邮件。
  * 作为再获客活动或其他社区推广的一部分，*直接*向你的玩家发送优惠券代码。
* 锦标赛：
  * 在使用[可重置排行榜](/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards)时向排名靠前的玩家发送优惠券。

<Note>
  在这种情况下，你也可以直接发放库存物品，因此选择哪种更适合你的游戏。
</Note>

## 最佳实践

使用 PlayFab 库存时，你应将库存大小保持相对较小——每个玩家*总共不超过 100 个物品*。授予*过多物品*的捆绑包可能会受到节流或速率限制。


## Related topics

- [Economy（旧版）中的商店和促销](/zh-CN/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [什么是 PlayFab？](/zh-CN/services/playfab/get-started/what-is-playfab.md)
- [Economy（旧版）快速入门](/zh-CN/services/playfab/economy-monetization/economy/quickstart.md)
- [PlayFab Economy 文档](/zh-CN/services/playfab/economy-monetization/economy/index.md)
- [Economy（旧版）中的玩家分组自定义商店](/zh-CN/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)