> For the complete documentation index, see [llms.txt](https://www.oddle.me/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.oddle.me/docs/help-center/help-center-zh/zhang-hu/how-do-i-import-my-customer-data.md).

# 如何匯入我的顧客資料？

你可以隨時將完整的顧客名單匯入 Merchant Admin。這對以下用途很有幫助：

* 為電子郵件行銷活動建立受眾
* 了解所有渠道中的客人是誰
* 保留集中式的顧客資料副本

***

### 開始之前

請確保你的檔案符合以下要求：

| 要求       | 詳細資料                                                                                 |
| -------- | ------------------------------------------------------------------------------------ |
| **檔案格式** | CSV、XLS 或 XLSX。若使用含有多個工作表的 Excel，請在上傳時選取包含資料的工作表。                                    |
| **必填欄位** | 每位顧客至少必須具備下列其中一項：有效的 **電子郵件地址** 或 **電話號碼** （包含國碼，例如 `+65`).                          |
| **行銷狀態** | 該 `行銷狀態` 欄位必須包含 `true` 或 `false` 每一列。請設為 `true` 如果顧客已選擇接收行銷電子郵件； `false` 如果他們尚未選擇接收。 |
| **列數限制** | 最多 **50,000 列** 每個檔案。若超過此數量，請將資料分成多個檔案並一次匯入一個。                                       |

**提示：** 先下載 **顧客匯入範本** （可在匯入畫面中取得），再準備你的檔案。使用範本可確保欄位符合預期格式並減少錯誤。

***

### 逐步操作：匯入你的顧客

#### 1. 開啟匯入畫面

1. 登入 [Merchant Admin](https://panel.oddle.me/).
2. 如果你有多個品牌，請從左上角的下拉選單中選取相關品牌。
3. 前往 **顧客**.
4. 點擊 **更多** → **匯入顧客**.

#### 2. 準備並上傳你的檔案

1. 先下載 **顧客匯入範本** 從匯入畫面。
2. 將你的顧客資料填入範本中。請勿變更欄位標題。
3. 可將檔案拖曳到匯入方塊中、按一下瀏覽，或使用 **複製貼上表格資料** 選項。
4. 為你的匯入加上一段簡短說明（例如：「忠誠會員 — 2026 年 4 月」）。
5. 點擊 **下一步**.

#### 3. 對應你的欄位

1. 確認範本欄位與檔案中的欄位相符。Merchant Admin 會嘗試自動配對。
2. 如果任何欄位對應錯誤，請使用下拉選單重新指定。
3. 點擊 **下一步**.

#### 4. 檢閱並修正錯誤

1. 在驗證畫面中，任何無效資料都會以紅色標示。
2. 你可以 **直接編輯儲存格** 在此畫面中，或 **移除無效列** 再繼續。
3. 常見錯誤包括電話號碼缺少國碼、電子郵件格式無效，以及必填欄位空白。
4. 所有資料都有效後，請按一下 **送出**.

***

### 提交後

* **處理時間：** 視檔案大小而定，匯入可能需要幾分鐘到一至兩個工作天。
* **匯入的顧客在哪裡找：** 處理完成後，匯入的顧客會顯示在 **顧客** 分頁中。你可以使用可用的篩選條件來篩選和排序。
* **重複項目：** 如果已存在相同電子郵件地址或電話號碼的顧客，其記錄會以匯入的新資料更新，而不會建立重複項目。
* **使用匯入的顧客：** 匯入完成後，匯入的顧客會立即可作為電子郵件行銷活動的受眾。

***

### 常見問題

| 問題         | 解決方案                                                        |
| ---------- | ----------------------------------------------------------- |
| 電話號碼被標示為無效 | 請確保每個電話號碼都包含國碼（例如 `+65`, `+886`, `+60`）。請勿包含空格或連字號。         |
| 檔案無法上傳     | 請確認你的檔案格式為 CSV、XLS 或 XLSX。其他格式（例如 PDF、Google 試算表連結）不接受。     |
| 匯入比預期花更久時間 | 大型檔案（接近 50,000 列）可能最多需要兩個工作天。如果時間更久，請聯絡 <support@oddle.me>. |
| 欄位對應看起來有誤  | 請確保你的檔案使用與範本相同的欄位標題。重新命名或重新排序的欄位可能無法正確自動配對。                 |

***

### 需要協助嗎？

如果你的匯入遇到問題，請聯絡 <support@oddle.me> 並附上你的匯入檔案以及錯誤描述。

<br>

{% hint style="info" %}
請依照你所在地的資料保護義務處理這些資料（例如新加坡的 PDPA、歐洲的 GDPR）。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.oddle.me/docs/help-center/help-center-zh/zhang-hu/how-do-i-import-my-customer-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.