​

使用自定义属性进行高级分段（公共预览版）

使用自定义属性（公共预览版）进行高级分段，可以使用你自己的商业、参与度和自定义数据实现动态玩家分段。你可以使用自定义属性存储和管理玩家的自定义信息，然后使用它来根据这些特定属性创建分段。这些属性可以通过 API、Game Manager 或 PlayStream 规则在玩家上设置，并可用于定义根据共享特征对玩家进行分组的分段。一旦创建了这些分段，就可以用它们对玩家生成操作。此外，这些分段还可用于定义计划任务或手动任务。

​

使用玩家自定义属性创建分段

你可以通过 API 或 Game manager 使用玩家自定义属性创建分段。

​

通过 API

• 使用 Create Segment API 创建分段。
• 使用 Update Segment API 添加自定义属性谓词。

​

通过 Game Manager

• 登录到 Game Manager。
• 前往 Players 页面。
• 前往 Segments 选项卡。
• 创建或更新分段。
• 通过在 Player 下选择 Add filter 添加自定义属性谓词。
• 保存分段。

​

从带有自定义属性的分段导出玩家

1. 创建一个引用自定义属性谓词的分段。
2. 使用 ExportPlayersInSegment API 导出玩家配置文件

​

计划任务

1. 使用自定义属性谓词在分段上运行计划任务。

​

快速入门场景

​

设置 Economy V2 目录和库存

1. 创建 Gold Bar 货币作为道具。
2. 创建 Chocolate Bar 货币作为道具。
   • 必需参数： Friendly ID、Title 和 Start Date（3 月 1 日）
3. 创建目录道具 Chocolate Bar： 3a. 导航到 Settings -> Economy (V2) -> Catalog (V2)。 3b. 在 Catalog Settings 下，添加新的 Content Type - Chocolate Bar 并选择 Save。 3c. 前往 Engage -> Economy -> Catalog (V2) -> Items，然后选择 New item 添加。 3d. 在 ContentType 下选择 Chocolate Bar，设置 Start date、Time 和 Title，然后选择 Save and Publish。

---

​

1. 为消费 25-50 Gold Bars 的用户创建分段（虚拟货币消费）

1. 在 Automation -> Rules 下导航到 PlayStream Rules 页面。
2. 为 items_subtracted 事件创建一个规则，配置如下： 条件：
   • Payload.ItemId == <id of Gold Bar currency>
   • 可选：Payload.Amount 介于 25 到 50 之间，以防止覆盖其他数量
   操作：
   • 更新自定义属性
     • AmountSpent = Payload.Amount
     • ItemName = Payload.ItemId
   
3. 在 Players -> Segments 下导航到 Segments 页面。
4. 使用以下配置创建一个新分段：
   • 自定义属性（字符串）ItemName 为 <Gold Bar id>
   • 自定义属性（数值）AmountSpent >= 25
   • 自定义属性（数值）AmountSpent <= 50
   

---

​

2. 为在 2025 年 4 月 1 日之后被授予 Chocolate Bars 并全部使用完（10 个）的用户创建分段（库存授予）

1. 在 Automation -> Rules 下导航到 PlayStream Rules 页面。
2. 为 playfab.inventory.items_granted 事件创建一个规则，配置如下： 条件：
   • Payload.ItemId == <Chocolate Bars id>
   操作：
   • 更新玩家自定义属性
     • AmountSpent = Payload.Amount
     • ItemUpdateDate = Timestamp
   
3. 在 Players -> Segments 下导航到 Segments 页面。
4. 使用以下配置创建一个分段：
   • 自定义属性（字符串）ItemName = <Chocolate Bars id>
   • 自定义属性（日期时间）ItemUpdateDate > 4/1/2025
   • 自定义属性（数值）ItemAmountSpent >= 10
   
5. 工作方式： 规则将使用每个单独事件中的值更新玩家自定义属性——它不会随时间累积或求和值。例如，如果玩家在 10 个不同的时间点各消费 1 块巧克力棒，ItemAmountSpent 属性每次都会设置为 1，而不是 10。因此，玩家将不会被包含在过滤 ItemAmountSpent >= 10 的分段中。如果你需要跟踪累积或聚合的值（例如跨多个事件的总消费道具数），我们建议使用 Azure Function 或 CloudScript 实现自定义逻辑来计算和更新总数。
6. 注意： 场景 1 中的 Gold Bars 和场景 2 中的 Chocolate Bars 都写入同一属性 ItemName。如果你想跟踪多个值，则需要多个属性名称以防止玩家在 2 个分段之间反复切换。

---

​

3. 为在一次购买中购买 1 块 Chocolate Bar 的用户创建分段（目录购买）

1. 在 Automation -> Rules 下导航到 PlayStream Rules 页面。
2. 为 playfab.inventory.items_purchased 事件创建一个规则，配置如下： 条件：
   • Payload.ItemType == ChocolateBar
   • Payload.Amount >= 1
   • Timestamp >= 5 minutes ago
   操作：
   • 更新自定义属性
     • ChocolateBarPurchased = Payload.Amount
   
3. 在 Players -> Segments 下导航到 Segments 页面。
4. 使用以下配置创建一个分段：
   • 自定义属性（数值）ChocolateBarPurchased >= 1
   
5. 工作方式： 每当玩家购买 Chocolate Bar 时，规则条件被触发，执行添加自定义属性的操作。然后，玩家进入分段并可以接收配置的奖励或通知。