美國資料匯出規格：CSV/TXT 列名、編碼與下游匯入指南

當你在 KK‑DATA 平台完成美國號碼篩號，匯出清洗後的美國資料時，檔案的列名意義、編碼格式和分隔符號選擇直接影響下游工具能否正確載入。一次規範匯出，能避免 CRM 匯入亂碼、群發工具辨識錯誤、去重失敗等問題。本文詳解美國資料匯出字段釋義、格式設定、下游導入步驟及常見避坑方法，協助出海獲客團隊將清洗後的美國獲客資料順暢接入業務系統。

什麼是美國資料匯出規格？為何重要？

匯出規範指篩選號結果檔案的欄位列名定義、字元編碼和分隔符標準。缺乏規範，例如：

• 欄位列名不統一，匯入 CRM 時無法自動對應；
• 編碼非 UTF‑8，Excel 打開中文亂碼；
• 分隔符號含歧義（如號碼含逗號），導致列錯位。

規範的導出能確保：下游系統（CRM、EDM、群發工具）正確解析每一行數據，避免重複勞動和數據失效。對於批量處理美國號碼資料的團隊，標準化匯出是高效營運的基礎。

KK‑DATA 美國資料匯出的核心列名詳解

以官網 https://kkdata.cc/ 的「美國號碼篩選」任務為例，匯出 CSV 通常包含以下常見欄位。 注意：不同檢測平台（Telegram、WhatsApp、Line 等）傳回的欄位集有差異，最後列名以控制台任務結果頁預覽為準。

平台與狀態字段

列名	意義	範例值
phone	國際格式美國號碼	+14155551234
country	國家代碼（ISO 2位元）	US
platform	檢測平台（如 tg、wa）	tg
detect_type	檢測類型（開通/活躍）	status
status	號碼在該平台是否開通/有效	開通 / 無效

• status 判定邏輯：對 Telegram 而言，「開通」表示該號碼已註冊 Telegram；對 WhatsApp 表示已註冊 WhatsApp 且可能可發送訊息。
• platform 值：tg（Telegram）、wa（WhatsApp）、line（Line）、zalo（Zalo）等。

活躍度與性別字段

列名	意義	範例值
active	活躍狀態（可指定時間窗口）	近7天活躍 / inactive
gender	性別（部分平台可偵測）	male / female
age	年齡層（僅作人群趨勢解讀）	30

• active：在任務設定時可選擇「近7天活躍」「近30天活躍」等，匯出時精確反映該視窗。
• age：來自平台公開資料或行為推斷，反映的是年齡段趨勢（如「約30歲」），非身分證級精確資料。適合用於人群畫像粗略篩選。
• 有些平台也會回傳 tgid（Telegram 使用者 ID）、wsid（WhatsApp 識別碼）等，用於去重或額外對接。

匯出格式設定：CSV vs TXT，編碼與分隔符

在 KK‑DATA 控制台 https://app.kkdata.cc/ 執行匯出時，可選擇兩種格式。核心區別：

特性	CSV	TXT
內容	完整欄位（含列名行）	純號碼列表，每行一個號碼
列名	首行為列名行	無
編碼	UTF‑8 with BOM（建議）	UTF‑8
分隔符號	英文逗號	無（每行一個號碼）
適用場景	匯入 CRM、資料庫、Excel 分析	直接匯入群發工具、號碼池

請務必確認：輸出編碼建議選擇 UTF‑8 with BOM（位元組順序標記），這能幫助 Excel 辨識中文。分隔符號固定為英文逗號。

CSV 格式（建議）及欄位順序

• CSV 首行為列名行，後續每行對應一筆記錄。
• 欄位順序與控制台預覽保持一致。 可在匯出前取消勾選不需要的欄位，以減少檔案體積和下游清洗成本。
• 適用於結構化分析：匯入 Excel 後可用透視表、公式；匯入資料庫時可快速建立表。

TXT 格式（純號碼清單）及適用場景

• TXT 每行一個號碼，無任何額外資訊。
• 適用於直接灌入第三方群發機器人（如 Telegram 發信外掛程式），並規避欄位對映步驟。
• 注意：某些群發工具要求號碼不含 + 號，可在匯出前以公式或文字編輯器批次取代。

如何將美國資料匯出結果匯入下游工具？

根據不同業務場景，匯入操作略有差異。

匯入 CRM（如 HubSpot、Salesforce）－欄位對應步驟

1. 登入 CRM 後台，選擇「匯入聯絡人/客戶」。
2. 選擇 CSV 檔案上傳，CRM 會自動辨識列名（如 phone → 手機號，country → 國家）。
3. 手動修正映射：例如將 status 對應為自訂欄位「是否開通 TG」。
4. 處理重複號碼：多數 CRM 提供去重選項，以 phone 為唯一識別。
5. 確認匯入規則（更新已有記錄還是僅新增）。

導入郵件行銷平台－CSV 清理與分割

• 美國資料匯出可能包含 phone、gender 等非郵箱字段，匯入前刪除無關列（僅保留 B2C 場景所需 email 等，但若做簡訊/WhatsApp 行銷則可保留 phone）。
• 若單次匯入量超過平台限額（如 10 萬行），分批次匯入。
• 檢查郵箱格式（如果有 email 欄位）：部分平台要求郵箱欄位列名為 Email，且每個郵箱唯一。

匯入 Telegram/WhatsApp 群發工具－號碼列擷取

• 從 CSV 匯出後，複製 phone 列，貼上到新 TXT 檔案（每行一個號碼）。
• 查看群發工具要求：有些工具需要純號碼（無國家代碼前綴，如 14155551234），可批量刪除開頭的 +；有些工具支持國際格式 +14155551234，則保留。
• 若需要 tgid 或 wsid，則直接匯出 CSV，將對應列複製到工具 API 的請求體中。

美國資料匯出常見錯誤與避免方法

常見錯誤	現象	解決方案
編碼亂碼	Excel 開啟 CSV 中文顯示「錟斤拷」	匯入時選 UTF‑8 編碼；或記事本儲存為 UTF‑8 with BOM
欄位缺失	匯入 CRM 後 gender 列為空	匯出前確認偵測平台支援性別辨識；預覽列名是否被勾選
分隔符號錯誤	號碼含 , 導致列錯位	檢查 CSV 是否在號碼中意外包含逗號；如必要用引號包裹
空白值行冗餘	CSV 結尾有空行	匯出後用文字編輯器刪除最後空白行；或匯入時跳過空白行

檢查清單：

• 匯出前預覽列名，確認所需欄位已勾選。
• 匯出後先用文字編輯器開啟首行，確認列名正確，無 BOM 亂碼。
• 用 Excel 測試導入（資料→自文字/CSV，編碼 65001），驗證格式。

美國數據導出最佳實踐：從篩選編號到導出完整流程

1. 產生美國號碼：使用 KK‑DATA 的「全球號碼產生」模組，選擇國家 United States，產生前綴或隨機號段。生成免費。
2. 選擇國家/平台篩號：在篩號任務中指定 platform（如 Telegram）、國家 US，提交約每日不超過 10 萬行的任務（平衡效率與耗時）。
3. 設定導出列：在任務結果頁，取消勾選不需要的列（如 country 如果已經明確是美國資料），保留 phone、status、active、⟦§2222⟧§⟦§⟧§222222325。
4. 選擇格式：若後續需分析，選擇 CSV（UTF‑8 with BOM）；若只給群發工具，選擇 TXT。
5. 下載校驗：先下載 100 筆小樣，用 Excel 或 Notepad++ 驗證列名、編碼、分隔符號。確認無誤後下載完整文件。

每日批次建議：單次任務建議不超過 10 萬行，避免大型檔案處理緩慢。匯出後先做小樣驗證，再合併到最終資料集。

常見問題

**問：美國資料匯出的 CSV 檔案用 Excel 開啟中文亂碼怎麼辦？ ** 答： 原因是 CSV 預設編碼為 UTF‑8（無 BOM）。解決方案：先用記事本開啟 CSV，另存為「UTF‑8 with BOM」格式；或進入 Excel 使用「資料 → 自文字/CSV」匯入，編碼選 65001。

**問：TXT 匯出只包含號碼嗎？能否自訂分隔符號？ ** 答： 標準 TXT 匯出每行一個號碼，無額外欄位。若需要其他分隔符號（如製表符），建議選擇 CSV 格式並在下游工具中按列拆分。

**問：美國資料中的 age 欄位準確嗎？可以當真實年齡嗎？ ** 答： age 欄位來自平台公開資料或行為推斷，反映的是年齡層趨勢（如「約 30 歲」），非身分證層級精確資料。建議僅用於人群畫像的粗略篩選。

**問：匯出結果中包含的國家代碼是否統一為國際格式？ ** 答： 是。所有號碼以國際格式儲存（如 +1xxxxxxxxxx），確保跨平台解析一致。若業務系統需要純數字，可簡單批次刪除 + 號。

**問：不同平台（Telegram / WhatsApp / Line）的匯出欄位是否一樣？ ** 答： 字段集因平台而異。例如 Telegram 可能回傳 tgid，WhatsApp 可能回傳 wsid，Line 可能回傳 uid。具體以控制台預覽為準。建議 參考文檔 了解各平台欄位說明。

---

希望以上規範能幫助你有效率地完成美國資料的匯出與下游導入。如需立即開始篩號，請登入控制台：

👉 登入控制台開始篩選號 或透過雙向聯繫客服 https://t.me/kkdata_robot 取得操作指導。