> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ggcircuit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🧙‍♂️ 向 ggLeap 导入用户（电子表格方法） ✨

本指南将引导您准备数据、确保格式正确，并使用 CSV 模板以实现平顺的导入过程。如有任何疑问或需要额外帮助，请随时联系[**ggCircuit 支持团队**](mailto:support@ggcircuit.com)。

---

---

## ✏️ 入门

🔒 **查看模式**  
原始文件处于"查看"模式。要开始编辑：

> 点击功能区中的"启用编辑"按钮。  
> 这将允许您在自己的电子表格副本中进行更改。

---

## ✏️ 重要注意：受保护的工作表和单元格

某些单元格受保护，以防止对公式的意外更改。如果您尝试编辑它们，您需要在功能区中对文档"启用编辑"。

* ✅ 如果您熟悉 Excel：点击"确定"继续。
* ⚠️ 如果您不熟悉公式：避免编辑受保护的字段以防止电子表格行为出错。

---

## ✏️ CSV 模板字段要求

### ✅ 必需字段

| 字段 | 描述 | 示例 |
| ---- |
| `Username` | 用户的唯一标识符 | `john_doe23` |
| `EmailAddress` | 必须是有效的电子邮件地址 | `user@example.com` |

### 🟡 可选字段

| 字段 | 描述 | 示例 |
| ---- |
| `FirstName` / `LastName` | 用户的名字（可以留空） | `John` / `Smith` |
| `Playtime` | 要记入的时间（以秒为单位） | `3600` |
| `Phone` | 联系电话（可选）– 4–20 个字符 | `+1 800-555-1234` |
| `CreatedAt` | 帐户创建日期，格式为 `MM.DD.YYYY` | `01.01.2025` |
| `Balance` | 数字余额（整数或以点为分隔符的小数） | `10`, `1500.45` |
| `Birthdate` | 用户的出生日期，格式为 `MM.DD.YYYY` | `03.26.2025` |

🔍 *您可以在"Senet 工作表"中找到完整模板的示例。*

---

## ✏️ 准备您的 CSV 模板

1. **设置必需的数据**

* 为每个条目输入 `Username` 和 `EmailAddress`。
* 这些不能留空。
2. **填写可选字段（如需要）**

* 根据需要添加数据，如 `Playtime`、`Phone` 或 `Birthdate`。
* 可选字段可以留空而不会造成错误。
3. **遵循数据格式规则**

* ✅ `Username`：仅使用字母、数字、下划线（`_`）和点（`.`）。
* ✅ `EmailAddress`：必须遵循标准格式，如 `example@mail.com`。
* ✅ `PlaytimeStartDate` / `PlaytimeEndDate`：如果使用，必须遵循 `MM.DD.YYYY` 格式，仅在定义了 `Playtime` 的情况下。
* ✅ `Birthdate` 和 `CreatedAt`：使用 `MM.DD.YYYY` 格式。
* ✅ `Balance`：小数点必须使用点（`.`）（例如，`10.75`）。
* ✅ `Phone`：可以包含数字、空格、`+`、`-`、`x`（例如，`+1 800-555-1234`），应该是 4–20 个字符。

---

## ✏️ 导出文件

完成数据填充后：

1. 转到 `文件 > 另存为 > CSV UTF-8（逗号分隔）(*.csv)`
2. 这将生成一个格式正确的 CSV 文件用于导入。