獲客資料匯出規格：格式、欄位對應與下游工具對接完整指南

出海團隊從平台匯出獲客資料後，常遇到字段亂碼、格式不相容、重複號碼等問題。這些問題看似微小，卻直接導致下游CRM無法匯入、EDM發送失敗、社媒工具提示非法格式，甚至因號碼重複觸達而被封鎖。本文將詳解獲客資料匯出標準，包括CSV/TXT欄位對映規則、批次去重機制、與CRM/EDM/社媒工具的對接建議，助你提升資料利用效率，降低下游出錯風險。

什麼是獲客資料匯出規格？為什麼它直接影響獲客效率？

導出規格是指從篩選號平台匯出資料時，檔案格式、欄位結構、編碼、去重邏輯、命名規則等要素的統一約定。 缺乏規範的導出，可能帶來以下問題：

• 重複偵測浪費餘額：同一號碼以不同格式（如帶國家號/不帶國家號）出現在多個任務中，平台無法自動識別為重複，導致多次扣費。
• 下游導入報錯：CSV欄位中混入逗號或換行，導致Excel或CRM解析時列錯位；編碼不一致造成中文亂碼。
• 人群定向失效：性別、活躍度等欄位未正確映射，導致篩選條件名不副實，發送給錯誤的使用者群體。

因此，規範導出是連接「篩號」與「觸達」的關鍵樞紐。

常見匯出混亂場景：欄位錯位、編碼不一致、空值處理

• 逗號衝突：CSV以逗號分隔，但欄位值內也包含逗號（如公司名稱「KK Data, Ltd.」），導致列錯位。
• Excel自動轉換：號碼「8613800138000」被辨識為科學計數法或數字，遺失後幾位；日期「01/02」轉為Excel內部日期格式。
• 編碼問題：系統預設UTF-8，但使用者用GBK編碼的Excel打開，中文顯示亂碼。
• 空值處理：性別、活躍度等欄位為空時，匯出檔案可能保持空白或填入“N/A”，而下游工具若不辨識則會報錯。

規範化導出的三個核心維度：格式、欄位、結構

維度	關鍵要素	作用
格式	CSV、TXT	決定檔案是否能被下游工具直接讀取
欄位	號碼、平台、狀態、活躍度、性別、ID	確保每筆記錄攜帶可用的業務資訊
結構	列頭固定、行尾無多餘空格、欄位引用規則	確保解析一致性，減少手動清理

建議在每次匯出前確認這些維度，避免重複勞動。

CSV 與 TXT 匯出格式：各適用哪個場景？如何選擇？

兩種格式各有優勢，選擇取決於下游工具的性質。

對照項	CSV (Comma-Separated Values)	TXT (純文字)
結構	多列，每列有標籤	單列或多列，無固定標籤
適用場景	CRM匯入、EDM群發、廣告平台上傳受眾	Telegram群發、黑名單過濾、腳本批次處理
欄位保留	可同時匯出號碼、狀態、性別等多欄位	通常只含號碼，或每行一個欄位
編碼問題	UTF-8編碼最通用，Excel開啟需指定	無列結構，亂碼影響較小
解析複雜度	需處理列對映與轉義字元	簡單，行即記錄

選擇建議：

• 下游是CRM（如Salesforce、HubSpot）或行銷自動化平台 → CSV
• 下游是腳本或命令列工具 → TXT
• 只需純號碼清單 → TXT
• 需同時匯出號碼+性別+活躍度 → CSV

獲客資料的導字段映射規則－每個欄位在對接時代表什麼？

以KK-DATA典型匯出欄位為例，解釋每個欄位的意義與下游工具中常見對應方式。

核心必導欄位：號碼、平台、狀態

欄位名稱	意義	對應範例
phone	帶國家區號的完整號碼（如8613800138000）	直接作為CRM的phone字段
platform	號碼所屬平台（如Telegram、WhatsApp、Line）	用於分流至不同通路工具
status	檢測結果：valid 或 invalid	篩選條件：只匯入valid的記錄

價值：這三個欄位決定「號碼是否可用、在哪個管道可用」。匯出時應確保phone字段格式統一（如全部E.164格式），避免因前綴缺失導致下游發送失敗。

進階篩選欄位：活躍度、性別、年齡、ID（tgid/wsid/uid）

字段名	意義	作用
activeness	活躍度，如3天内活跃、7天内活跃、30天内活跃	用於定向「近期活躍」用戶，優先觸達
gender	性別認同結果，如男、女、未知	用於性別定向行銷
age	性別檢測結果中的年齡字段，可解讀為約30歲等	用於人群畫像，篩選特定年齡段
tgid	Telegram用戶唯一識別	跳過號碼驗證，直接對應到已註冊用戶
wsid	WhatsApp用戶標識	同上，降低無效發送率
uid	Line/Zalo用戶標識	用於精確推播或再次偵測

映射建議：若下游工具支援條件過濾，可將activeness轉換為邏輯條件（如「只匯入活躍度標記為3天內的號碼」）；若不支援，可先以腳本產生「活躍天數」數位欄位再對應。 tgid和wsid這類ID欄位建議在匯出時勾選，攜帶它們匯入群發工具可跳過號碼驗證，大幅降低無效發送率。

批次匯出時如何保證資料唯一性？去重機制如何生效？

重複號碼不僅浪費偵測餘額，還容易導致下游重複觸達，引發用戶抱怨甚至封號。

去重倉庫工作原理： 在KK-DATA中，去重倉庫是一個跨任務的號碼池。當你提交新任務時，平台會自動比對倉庫中已有的號碼記錄：

• 若號碼已偵測且狀態未變更 → 不再重複偵測，不扣費。
• 若號碼是新出現 → 正常偵測並扣費。
• 若號碼之前檢測為invalid，但本次提交時狀態變為valid → 重新檢測並扣費。

匯出時，你可以選擇「保留最新檢測結果」或「去重後只留一條」。建議選擇去重後只留一條，並優先保留狀態為valid的記錄。

匯出資料對接下游工具時常見的 3 個報錯及解決方法

1. 號碼前綴不匹配

• 表現：CRM匯入後顯示“號碼格式無效”，或Telegram群發工具提示“號碼未註冊”。
• 原因：導出號碼為E.164格式（帶+），但下游要求無+或不帶國際前綴。
• 解決方法：
  1. 在匯出前確認下游工具的號碼格式要求。
  2. 若已匯出，可用腳本或文字替換功能去除+（如sed 's/^+//'），或補上缺失的00前綴。

2. 日期欄位被Excel篡改

• 表現：活躍度欄位中的「2024-03-15」會自動轉換為「45121」或「2024/3/15」。
• 原因：Excel自動識別文字為日期並轉換格式。
• 解決方法：
  1. 匯入Excel前將目標列格式設為「文字」。
  2. 若已竄改，在Excel中使用「分列」功能將欄位改為文字格式後重新匯入。
  3. 建議使用支援UTF-8的編輯器（如VS Code、Notepad++）查看CSV，而非Excel。

3. CSV欄位包含回車換行導致解析失敗

• 表現：一行記錄被拆為多行，導致CRM報錯「列數不符」。
• 原因：字段值內部包含\r\n（如公司名稱含多行文本），但CSV未用雙引號包裹。
• 解決方法：
  1. 匯出時確認使用雙引號引用的CSV格式（標準RFC 4180）。
  2. 若已匯出，請使用文字編輯器尋找未包裝的多行字段，手動新增雙引號。
  3. 簡單方案：用腳本將欄位內的換行替換為空格。

如何驗證匯出的獲客資料品質？一份簡單的核驗清單

在將資料導入下游工具前，請花5分鐘執行以下核驗：

• 總記錄數是否與預期一致（如任務結果顯示“有效號碼10000條”，匯出檔案行數應為10001含表頭）。
• 字段數是否完整（CSV檔案以文字編輯器打開，確認每個分隔符號後都有值）。
• 號碼格式是否正確（全部為E.164格式，無亂入漢字或字母）。
• 空值比例是否可接受（若activeness字段有80%為空，可能需重新檢測）。
• 重複率是否低於5%（可在Excel中透過「刪除重複項」功能快速檢視）。

從匯出到落地：一份獲客資料對接最佳實務流程

1. 產生 → 使用全球號碼產生功能（240+國家/地區）或自訂號段CSV匯入，產生目標號碼池。此步驟免費。
2. 篩選 → 提交篩號任務，選擇需要檢測的平台和類型（開通、活躍、性別等）。任務提交前預估費用，餘額不足需先儲值（USDT TRC20，最低約50 USDT）。
3. 匯出 → 在控制台選擇CSV或TXT格式，勾選所需欄位（號碼、狀態、活躍度、性別、tgid/wsid等）。建議使用帶有時間戳記的文件命名，如export_20250220_valid.csv。
4. 去重 → 在匯出前使用「去重倉庫」清理重複號碼，減少下游重複觸達風險。
5. 驗證 → 執行上述核驗清單，檢查欄位對應和空值比例。必要時先抽出10%資料做測試導入。
6. 導入 → 依照下游工具要求調整CSV編碼（UTF-8 without BOM最通用），將欄位名稱與下游對應欄位一一對應。若下游不支援「活躍天數」文字過濾，可先生成數字欄位再映射。

額外建議：

• 保留一次匯出記錄作為原始備份，以便於後續校準。
• 定期清理“去重倉庫”，保持號碼池健康，避免過期號碼影響檢測準確性。
• 對於獲客資料的量級較大（如超50萬條），建議分批次匯出，避免Excel載入卡頓。單次任務最多約100萬條，超出時可分批提交。

常見問題

**問：匯出 CSV 時號碼顯示為科學計數法怎麼辦？ ** 答：在 Excel 中開啟前先將列格式設為“文字”，或使用 TXT 格式匯入。若已匯出，可在文字編輯器中貼上後轉置。部分工具支援「在號碼前加單引號」保持原樣。

**問：匯出後的活躍度欄位（如「3天內活躍」「7天內活躍」）如何對應到下游篩選？ ** 答：建議在下游工具中將該欄位轉換為邏輯條件，例如「只匯入活躍度標記為 3 天內的號碼」。若下游不支援文字過濾，可先用腳本產生「活躍天數」數字欄位再映射。

**問：一次任務最多可匯出多少條資料？匯出檔案有大小限制嗎？ ** 答：單次任務支援約 100 萬條號碼。匯出檔案大小受格式影響，建議大於 50 萬條時分批匯出，避免 Excel 開啟卡頓。詳見控制台匯出提示。

**問：匯出檔案中的「tgid」和「wsid」是什麼？如何利用它們做更精準的觸達？ ** 答：tgid 是 Telegram 用戶唯一標識，wsid 是 WhatsApp 用戶標識。攜帶這些 ID 導入群發工具可跳過號碼驗證，直接對應到已註冊用戶，降低無效發送率。建議匯出時勾選對應欄位。

**問：導出的獲客資料能否多次使用？平台會重複扣費嗎？ ** 答：已經偵測並匯出的號碼不會重複扣費。若將匯出資料再次提交偵測（例如補充偵測性別），KK-DATA 的去重倉庫會自動辨識重複號碼，僅對新增或狀態變更的記錄扣費。具體規則請見控制台計費頁。

看完這篇規範指南，你可能會想立即嘗試規範的獲客資料匯出流程。現在登入控制台建立一次篩選號任務，或聯絡雙向客服以取得匯出範本與對接建議。

👉 登入控制台開始篩選號 雙向聯絡客服：https://t.me/kkdata_robot 官網：https://kkdata.cc/ 文件：https://docs.kkdata.cc/