自訂號段 CSV 導入指南：格式規範、步驟詳解與最佳實踐

在出海獲客場景中，批量生成並篩選特定國家、特定號段的手機號碼是一項高頻需求。無論是針對美國 +1 號碼做 Telegram 篩號，還是聚焦中國 138/139 號段做 WhatsApp 驗證，手動逐個輸入號段不僅耗時，還容易出錯。KK-DATA 的 自訂號段 CSV 導入 功能允許你上傳一個包含國家代碼、前綴、長度等欄位的 CSV 檔案，系統自動依規則生成號碼，並與後續的篩號任務無縫銜接。本文將從格式規範、操作步驟到最佳實踐，完整拆解這一能力，助你高效完成「生成 → 篩選 → 匯出」流水線。

什麼是自訂號段 CSV 導入？它解決什麼場景問題？

簡單來說，自訂號段 CSV 導入是指使用者透過上傳一個結構化的 CSV 檔案，向平台指定需要生成的號碼範圍。檔案中的每一行代表一個號段規則（例如：國家代碼 1，前綴 2，總長度 10 位），系統會基於該規則批量生成該號段下的所有或指定數量的號碼。

這一功能解決的核心場景包括：

• 按區域定向獲客：需要在某個國家集中推廣，比如印度 +91，可以只上傳該國常用號段（如 98、99 開頭），避免生成無效號碼。
• 運營商或活動定向：有些活動只針對特定號段用戶（例如中國移動 138、139 號段），CSV 導入可精準限定。
• 大批量、多條件組合：需要同時生成多個國家、多種前綴、不同長度的號碼時，CSV 檔案比手動輸入高效百倍。
• 與後續篩號任務銜接：生成完成後，可直接將這些號碼提交到 Telegram/WhatsApp 篩號任務，利用去重倉庫避免重複檢測。

CSV 導入 是號碼生成模組的核心能力，與「自訂前綴」功能互補，更適合複雜、大批量的場景。

自訂號段 CSV 檔案的標準格式與欄位說明

一個標準的 CSV 檔案需要包含以下列（表頭嚴格區分大小寫，建議從 KK-DATA 文件下載官方範本）：

必填欄位詳解

欄位名	說明	資料類型	範例
country_code	國際區號（不含 +）	數字	1（美國）、86（中國）、44（英國）
prefix	號碼前綴（不含區號）	數字	138、2、7
length	號碼總位數（含區號？注意：不含國際前綴，即國家代碼+號碼總長，通常指去除國家代碼後的號碼位數？需要準確定義。根據 KK-DATA 文件，length 指手機號碼的總位數，不含國際區號。例如中國手機號 13812345678，去掉區號 86 後為 11 位，則 length=11；美國號碼 +1 234567890 去掉區號 1 後為 10 位，則 length=10。）	數字	11（中國）、10（美國）

說明：prefix 的長度不能超過 length。例如中國，prefix=138（3位），length=11，剩餘 8 位由系統隨機生成。

可選欄位與進階用法

欄位名	說明	資料類型	範例
start_range	指定前綴後可變數字的起始範圍（可選）	數字	0
end_range	指定前綴後可變數字的結束範圍（可選）	數字	9999
quantity	限定該號段生成的號碼總數（可選）	數字	5000

進階用法：若同時填寫 start_range 和 end_range，系統會生成該區間內的所有號碼（數量 = end_range - start_range + 1），此時 quantity 欄位無效。如果只填 quantity，系統會從完整範圍中隨機抽取指定數量。

例如：英國 +44，前綴 7，length=11，start_range=3000，end_range=4000，將生成號碼後四位 3000～4000 共 1001 個號碼。

常見欄位錯誤及避免方法

• 列名大小寫錯誤：必須為小寫（如 country_code 而非 CountryCode）。建議直接從官方範本複製。
• 欄位缺失：必填列不可缺少；可選列留空即可，不要填 null。
• 長度衝突：prefix 長度超過 length → 無法生成，系統提示錯誤。
• 非法字元：只允許數字、逗號、換行；不要添加空格、引號（除非按 CSV 標準轉義）。
• 編碼問題：必須為 UTF-8 無 BOM，避免中文亂碼（雖然欄位無中文，但編碼錯誤會導致解析失敗）。

三步完成自訂號段 CSV 導入與號碼生成

第一步：準備並校驗 CSV 檔案

使用 Excel 或任何文字編輯器製作 CSV。

• 推薦工具：Excel 編輯後另存為 CSV（逗號分隔）（*.csv），然後用記事本開啟確認列間分隔符為逗號，且無 BOM 頭。
• 行數限制：單次上傳最多 20 萬行（號段規則），每個號段生成數量不限，但單次任務生成的總號碼數建議不超過 100 萬條（超出可分多次）。
• 校驗範例：建立一個僅包含一行 country_code,prefix,length 頭，然後 1,2,10，儲存後上傳測試。

第二步：上傳 CSV 至 KK-DATA 生成模組

登入 KK-DATA 控制台，進入「號碼生成」頁面。

1. 選擇導入模式「CSV 導入」。
2. 點擊「選擇檔案」或拖拽 CSV 檔案。
3. 系統自動解析並預覽前 10 行資料，檢查欄位是否正確映射。如出現「列名不識別」錯誤，回到第一步核對表頭。
4. 確認後點擊「開始生成」。

第三步：設定篩選條件並提交任務

號碼生成成功後，頁面會自動跳轉到「號碼列表」或提供「繼續篩選」按鈕。

• 選擇後續篩號平台：Telegram / WhatsApp / iMessage / RCS。
• 設定檢測類型：例如「有效」或「活躍」（可指定 7/15/30 天活躍視窗）。
• 可選利用數據去重倉庫：系統會自動過濾已在倉庫中的號碼，避免重複扣費。
• 確認預估費用（見控制台即時價格），餘額充足則提交任務。

自訂前綴與自訂號段 CSV 導入的區別與選擇

KK-DATA 提供兩種號碼生成方式：自訂前綴（在介面中輸入一個前綴、選擇國家、設定數量，快速生成）和 CSV 導入。兩者的選擇決策如下：

維度	自訂前綴	CSV 導入
適用場景	少量、固定前綴（比如僅生成一個號段）	大批量、多號段、多國家、含範圍限制
操作複雜度	低，介面填寫	中等，需準備檔案
號段數量	一次最多 10 個前綴	一次最多 20 萬行號段
範圍控制	不支援 start_range/end_range	支援精確範圍或隨機數量
適合團隊	個人臨時測試	運營團隊批量生產

建議：當需要生成超過 10 個號段，或涉及多個國家、需控制範圍時，直接使用 CSV 導入。如果只是快速生成 1～10 個固定前綴號碼，自訂前綴更快捷。

實用範例：三個真實場景的 CSV 檔案範本

場景一：僅生成美國（+1）2 開頭的 10 位號碼

檔案內容：

country_code,prefix,length
1,2,10

生成規則：美國號碼去掉區號後是 10 位，前綴 2 是 1 位，系統隨機填充後 9 位。生成數量不限（若不指定 quantity 和 range，系統預設生成所有組合，數量極大。建議結合 quantity 欄位限制數量，如加 quantity,10000）。

場景二：生成中國（+86）多個號段（139、138、137）的 11 位號碼

檔案內容：

country_code,prefix,length
86,139,11
86,138,11
86,137,11

每行對應一個號段，系統會為每個號段分別生成號碼。如果希望限制每個號段的數量，可添加 quantity 列。

場景三：限定生成數量與範圍（英國 +44 7 開頭，只生成後四位 3000-4000）

檔案內容：

country_code,prefix,length,start_range,end_range
44,7,11,3000,4000

此例中，prefix=7（1位），length=11，系統會在號碼後 10 位中僅從 3000～4000 範圍生成，即生成 7xxxxx3000 至 7xxxxx4000 共 1001 個號碼，其中前 6 位（7xxxxx）隨機填充，後四位固定範圍。注意：當填寫 start_range/end_range 時，生成數量完全由範圍決定，無需再寫 quantity。

常見錯誤與排查指南

錯誤一：上傳後提示「列名不識別」

• 原因：表頭名稱大小寫或拼寫錯誤，或包含不可見字元（如 BOM、空格）。
• 解決：從官方範本複製表頭；用記事本開啟 CSV 檢查首行是否僅含 country_code,prefix,length（不含空格）。如果範本中有其他可選欄位，請嚴格保持列名一致。

錯誤二：生成數量為 0

• 原因：prefix 長度 + 預設範圍超出 length 限制。例如中國 11 位號碼，prefix=13812345678（11位），系統無法生成剩餘位數。
• 或缺少 country_code 欄位，或欄位值為空。
• 解決：確保 prefix 長度 < length；檢查 CSV 檔案每行是否有完整數據。

錯誤三：上傳後系統解析逾時

• 原因：檔案過大（超過 20 萬行），或單行欄位過多。
• 解決：分割成多個檔案上傳；檢查每行欄位數是否一致。

從 CSV 導入到多平台篩號：完整流水線操作

CSV 導入只是起點。最佳流程如下：

1. 生成號碼：上傳 CSV → 系統生成號碼列表。
2. 提交篩號任務：選擇 Telegram / WhatsApp 等平台 → 設定檢測類型（建議優先使用「活躍」檢測以獲得更高價值的號碼） → 綁定數據去重倉庫 → 提交。
3. 等待任務完成：可透過 Telegram 接收通知（在控制台設定）。
4. 匯出結果：任務完成後，匯出 CSV 或 TXT 檔案，包含篩選狀態（有效/活躍/性別等）及平台 ID（如 tgid、wsid）。
5. 數據歸檔：將結果號碼導入 CRM 或下一步行銷工具。

數據去重倉庫在此過程中自動工作：每次篩號完成後，檢測過的號碼會自動進入倉庫，後續任務中相同號碼不再重複檢測，節省費用。

最佳實踐：如何規劃 CSV 檔案以提升篩號效率與降低費用

• 分國家、分平台生成：不同國家的篩號單價可能不同（具體見控制台），且不同平台的活躍度分佈不同。建議一個 CSV 檔案只覆蓋一個國家的號段，便於後續為不同平台單獨提交任務。
• 優先使用「活躍」檢測而非「有效」：活躍號碼的獲客價值遠高於僅有效但長期不活躍的號碼。雖然活躍檢測通常單價略高（以控制台為準），但轉化率提升後整體 ROI 更優。
• 利用去重倉庫減少重複扣費：同一批號碼如果多平台篩號，可先做一次通用檢測（如有效），再分平台提交活躍檢測；去重倉庫會幫你過濾重複號碼。
• 控制單次任務數量：單次任務生成號碼建議不超過 100 萬條，超過此數量可分批上傳。大量號碼集中篩選可能延長任務等待時間，分次提交可提高靈活性。
• 保留原始 CSV 檔案：標記每次生成的任務 ID，方便後續回查或與篩號結果關聯。

常見問題

問：CSV 檔案最大支援多少行？
答：單次上傳最多支援 20 萬行號段，每個號段可生成複數號碼。建議單次任務生成號碼總數不超過 100 萬條，超出部分可分多次上傳。

問：如果 prefix 列填寫的號碼長度與 length 列不一致怎麼辦？
答：系統會提示錯誤並拒絕提交。請確保 prefix 長度 + 預留可變位數 ≤ length 總數。例如中國 11 位號碼，prefix 若填寫「138」，則 length 必須為 11，剩餘 8 位由系統隨機填充。

問：CSV 中的號碼會與之前任務重複嗎？
答：KK-DATA 提供數據去重倉庫，在篩選階段會自動過濾已在倉庫中的號碼。但生成階段不支援去重，建議生成後直接提交篩選任務，利用去重倉庫避免重複扣費。

問：是否支援匯出 CSV 導入時使用的原始號段列表？
答：支援。在「號碼生成」歷史記錄中，可下載包含原始號段及生成號碼的 CSV 檔案，方便二次分析與歸檔。

問：自訂前綴功能和 CSV 導入能否混用？
答：暫不支援在一次任務中混用。但你可以先生成自訂前綴號碼，匯出 CSV 後，再作為號段 CSV 導入新任務進行二次擴展。

---

立即體驗：登入 KK-DATA 控制台 嘗試自訂號段 CSV 導入功能，或查閱 使用文件 獲取最新格式範本。如有任何問題，歡迎聯繫客服 Telegram @kkdata_cc 獲取一對一指導。