# 幸运转盘活动

本指南演示如何在带计划开始与结束日期的 stream 中设置完整的 **Spin the Wheel** 游戏 — 这是限时促销的常见配置。

## 场景

您希望运行一场 **7 天促销活动**，客户可转动奖品转盘赢取兑换码或折扣。活动应：

- 在特定日期开始（例如 2026 年 6 月 1 日上午 9:00）
- 在特定日期结束（例如 2026 年 6 月 7 日晚上 11:59）
- 每位玩家仅允许 **一次转动**
- 从已配置的奖品池发放奖品

## 第 1 步：创建幸运转盘游戏

1. 前往组织面板
2. 点击 **Create Game**
3. 选择 **Spin the Wheel** 模板
4. 配置转盘：
   - 添加 **3–10 个奖品扇区**（例如「10% Off」「Free Shipping」「Try Again」）
   - （可选）为每个扇区上传自定义图片
   - 定制转盘背景、指针与中心装饰
5. 设置奖品：
   - 为每个中奖扇区分配 **voucher**、**item** 或 **external link**
   - 失败扇区使用 **"No Prize"**
6. **Publish** 游戏

<!-- prettier-ignore -->
:::tip
Spin the Wheel 至少需要 3 个奖品扇区，最多支持 10 个。每个扇区必须链接到奖品配置。
:::
## 第 2 步：创建 Stream

1. 在侧边栏导航到 **Streams**
2. 点击 **Create Stream**
3. 填写详情：
   - **Name**：`Summer Spin Promo`
   - **Description**：`Spin to win exclusive summer discounts`

## 第 3 步：安排 Stream

设置活动窗口，使 stream 仅在促销期间可玩：

1. 打开 stream 设置
2. 将 **Start date** 设为 `June 1, 2026 — 9:00 AM`
3. 将 **End date** 设为 `June 7, 2026 — 11:59 PM`
4. 选择您的 **timezone**（例如 `Asia/Tokyo`）

在 6 月 1 日之前，访问 stream 链接的玩家会看到**倒计时**。6 月 7 日之后，他们会看到**活动已结束**消息。

## 第 4 步：将游戏添加到 Stream

1. 打开您的 stream
2. 点击 **Add Games**
3. 选择第 1 步中创建的 **Spin the Wheel** 游戏
4. 将 **Max plays per user** 设为 `1`（每位玩家一次转动）

## 第 5 步：配置分享

1. 复制 stream URL：
   ```
   https://app.dailyplay.ai/stream/org-slug/summer-spin-promo
   ```
2. （可选）：
   - 为 VIP 访问**密码保护** stream
   - 若嵌入网站，**限制域名**
   - 若与应用认证集成，**要求 session tokens**

## 第 6 步：连接 Webhooks（可选）

要在 CRM 或邮件平台中追踪结果：

1. 前往 **Connections** 并创建 webhook 连接
2. 将连接附加到您的 stream
3. `game.completed` 与 `prize.won` 等事件将发送到您的端点

奖品中奖的示例 webhook 载荷：

```json
{
  "event": "prize.won",
  "stream_id": "abc-123",
  "game_id": "spin-wheel-456",
  "player": {
    "id": "player-789",
    "email": "player@example.com"
  },
  "prize": {
    "type": "voucher",
    "name": "10% Off Summer Sale",
    "code": "SUMMER10"
  },
  "timestamp": "2026-06-03T14:22:00Z"
}
```

## 第 7 步：上线

1. 将 stream 状态设为 **Scheduled**（若已过开始日期则设为 **Active**）
2. 通过营销渠道分享 stream URL：
   - 邮件通讯
   - 社交媒体帖子
   - 网站横幅
   - 印刷物料上的二维码

## 时间线摘要

| 日期 | 发生什么 |
| ---------------- | -------------------------------------------- |
| 6 月 1 日之前 | 玩家看到倒计时 |
| 6 月 1 日上午 9:00 | Stream 上线，玩家可转动转盘 |
| 6 月 1–7 日 | 活动进行中，发放奖品 |
| 6 月 7 日晚上 11:59 | Stream 关闭，不再允许转动 |
| 6 月 7 日之后 | 玩家看到「活动已结束」消息 |

## 提示

- **上线前测试** — 使用草稿模式在安排前测试完整玩家体验
- **实时监控** — 活动期间查看 stream 分析中的游玩次数与完成率
- **设置奖品限制** — 若兑换码数量有限，配置奖品数量限制以避免超额发放
- **使用 UTM 参数** — 添加 `utm_source`、`utm_medium` 与 `utm_campaign` 以追踪哪些渠道带来最多游玩