优惠券和促销（旧版 Economy）

重要

经济 v1 API 处于维护模式，将不会收到任何新功能，只有 bug 修复。 v1 API 将在可预见的未来进行维护。 请参阅 经济 v2 概述 ，详细了解 PlayFab 经济的下一个版本！

优惠券是可生成的字符串令牌，供你的客户在游戏中兑换物品栏物品。 优惠券可与捆绑包或 CloudScript 配合使用，触发游戏中的几乎任何功能。

要求

• 熟悉目录、捆绑包和容器。
• 熟悉 Game Manager。
• 熟悉玩家物品栏。

生成和兑换优惠券的说明

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

从 Game Manager 中：

• 导航到您的游戏。
• 从左侧菜单中选择 Economy。
• 转到 Catalogs 选项卡。

“物品”、“捆绑包”和“容器”这三个选项卡部分中都包含“优惠券”链接。

可通过该链接打开一个窗口，可以在该窗口中为该部分的任何物品生成优惠券。 如果要为特定物品创建优惠券：

• 在 Items 选项卡中选择 Coupons。
• 捆绑包 Coupons 位于 Bundles 下，容器 Coupons 位于 Containers 下。

弹出窗口类似于我们在下面提供的窗口。 （物品列表应与你的游戏匹配。奖品表教程中介绍了显示的物品）。

完成优惠券生成：

• 选择要生成的 Coupons 数量。

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

• 然后，可以下载包含优惠券列表的 CSV 文本文件

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

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，然后调用 RedeemCoupon，客户就可以兑换优惠券了。

// 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);
}

示例案例：物品栏物品优惠券

使用优惠券的最简单方法是赠送物品栏物品。 创建目录后，您可以按照我们之前讨论过的说明为普通物品生成优惠券。 对于此案例，没有其他特殊步骤。

示例案例：虚拟货币优惠券或多物品优惠券

优惠券不能直接授予虚拟货币，并且只能授予单一物品。

但是，可以使用捆绑包将物品栏物品无缝转换为物品组或虚拟货币。 在 VC 示例中，您应该新建一个包含 VC 内容的捆绑包物品。

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

对于多物品，可以采取相同的方式：

• 创建包含多个物品（甚至奖品表）的捆绑包。
• 将其设置为 15 秒后过期。
• 优惠券可以生成捆绑包。
• 然后，捆绑包转换为多个物品。
• 中间捆绑包项消失。

使用场景

• 参加活动的实物奖励：
  • 可以将优惠券代码列表打印出来，在活动中作为奖励分发出去。
• 游戏外通信，例如论坛、推送通知、电子邮件等。
  • 作为挽回老玩家计划或其他社区推广活动的一部分，直接向玩家发送优惠券代码。
• 锦标赛：
  • 使用可重置的排行榜时，向排名靠前的玩家发送优惠券。

注意

在这种情况下，也可以直接发放物品栏物品，请挑选更适合您的游戏的方式。

最佳做法

使用 PlayFab 物品栏时，应保持相对较小的物品栏大小 - 每位玩家总计少于 100 件物品。 授予过多物品的捆绑包可能会受到限制。