篩號匯出欄位表完整指南：資料字典與術語說明（KK-DATA 平台）

當你從 KK-DATA 平台下載篩選結果時，看到的 CSV 或 TXT 檔案中每一列都有特定含義。不理解這些欄位，很容易誤判號碼品質、浪費行銷預算。本文為你系統梳理 篩號匯出欄位表，涵蓋 Telegram、WhatsApp、iMessage、RCS 等平台的常見欄位、狀態值定義與使用場景，幫助你像資料運營專家一樣快速讀懂匯出結果。

無論你正在進行出海獲客、社群運營還是私訊推廣，掌握這份 資料字典 都能提升後續資料處理效率，避免因術語混淆導致的決策失誤。

---

一、為什麼需要理解篩號匯出欄位？

篩選結果不是簡單的「有效/無效」二元判斷。一個號碼可能已註冊 Telegram 但長期未活躍，也可能註冊了 WhatsApp 卻未綁定 iMessage。如果直接使用未篩選的資料進行群發，可能導致：

• 大量訊息發送失敗，影響帳號信譽
• 觸達的並非目標活躍用戶，轉換率低下
• 無法精準區分性別導向的行銷內容

匯出欄位表就是將原始檢測資料轉化為可讀、可分析的結構化資訊。理解每個欄位的含義，才能基於真實狀態做後續操作，例如將「tg有效」的號碼匯入群發工具，將「tg活躍30天」的號碼用於高價值活動通知。

---

二、匯出欄位速查總覽

KK-DATA 的匯出資料通常分為四大類欄位，下表概述了常見欄位群組：

分類	欄位範例	說明
平台標識	platform、country_code、number	號碼歸屬平台、國家代碼、原始號碼
狀態檢測	telegram_status、whatsapp_status、active_level	各平台註冊/有效/活躍檢測結果
用戶屬性	tgid、wsid、gender、last_active_days	用戶唯一標識、性別預測、活躍天數
輔助資訊	task_id、detect_time、dedup_key、estimated_cost	任務溯源、去重標記、費用預估

不同檢測類型下，匯出欄位的命名和數量可能有所不同，但核心邏輯一致。接下來逐類詳解。

1. 平台標識欄位

• number：原始手機號碼，通常包含國家代碼（如 +8613800138000）。
• country_code：國家代碼（如 86），用於篩選特定國家號碼。
• platform：檢測的平台類型，列舉值如 telegram、whatsapp、imessage、rcs。注意：一次篩號任務可能針對某一平台，但匯出結果中該欄位統一標記平台。

2. 狀態檢測欄位

• telegram_status：是否在 Telegram 註冊（開通/未開通）。
• telegram_effective：是否可被搜尋/聯繫（有效/無效）。
• telegram_active：活躍等級（如活躍7天/15天/30天）。
• whatsapp_status：是否註冊 WhatsApp（開通/未開通）。
• imessage_status：是否啟用 iMessage（啟用/未啟用）。
• rcs_status：是否支援 RCS（支援/不支援）。
• active_level：綜合活躍度指標（如 high/medium/low）。

3. 用戶屬性欄位與輔助資訊

• tgid：Telegram 用戶唯一 ID（數字串），可用於精準定向。
• wsid：WhatsApp 用戶唯一標識（Base64 編碼字串）。
• gender 或 predicted_gender：基於頭像和暱稱預測的性別（male/female/unknown）。
• last_active_days：最近活躍距離檢測時的天數（如 5 表示5天前活躍）。
• detect_time：檢測任務完成時間戳（UTC）。
• task_id：所屬任務編號，用於跨任務資料關聯。
• dedup_key：去重倉庫中的記錄鍵，便於識別重複號碼。
• estimated_cost：任務提交前的預估費用（數值，單位元）。
• actual_cost：任務完成後的實際扣費金額。

---

三、平台標識欄位詳解

1. Telegram 相關欄位

Telegram 篩號是出海行銷最常見場景，匯出欄位也最豐富。

• telegram_status：取值「開通」或「未開通」。開通僅表示該號碼在 Telegram 註冊過，但不保證當前可聯繫（如已登出或封號）。
• telegram_effective：取值「有效」或「無效」。有效表示號碼當前可被搜尋並發送訊息（未登出、未因違規被限制）。注意：有效不一定活躍。
• telegram_active：基於登入時間判斷的活躍等級。常見窗口：7天、15天、30天。例如「active_7d」表示7天內有登入行為。該欄位僅在提交了活躍檢測任務時出現。
• tgid：Telegram 用戶唯一數字 ID，可用來匯入 TG 群發工具進行精確發送，避免號碼格式錯誤導致失敗。
• telegram_gender：透過頭像、暱稱等公開資訊推測的性別，欄位名為 telegram_gender 或統一 gender。取值 male、female、unknown。

2. WhatsApp 相關欄位

• whatsapp_status：取值「有效」或「未檢測」。有效表示該號碼已在 WhatsApp 註冊並能接收訊息（未過期、未登出）。
• wsid：WhatsApp 用戶內部標識符（通常為 Base64 字串）。匯出後可將其與號碼綁定，用於跨裝置或跨會話的精準推送，避免因號碼變更導致的遺失。

3. iMessage 與 RCS 相關欄位

iMessage 和 RCS 的檢測欄位命名類似，但狀態值略有不同。

• imessage_status：取值「啟用」或「未啟用」。啟用表示該 Apple ID/號碼已啟用 iMessage 功能。
• rcs_status：取值「支援」或「不支援」。RCS（富通訊服務）是運營商提供的增強簡訊協定，部分國家已普及。此外可能包含 operator_info 欄位，顯示運營商名稱（如 T-Mobile、Verizon），方便判斷號碼歸屬運營商。

---

四、狀態檢測欄位詳解

理解「開通」「有效」「活躍」三者的差異，是高效使用篩號工具的關鍵。

1. 開通狀態 vs 有效狀態

欄位	含義	典型場景
telegram_status = 開通	號碼在 Telegram 註冊過	初步篩選，批量加好友
telegram_effective = 有效	當前可被搜尋並發送訊息	向已驗證號碼發起冷啟動私訊
whatsapp_status = 有效	可接收 WhatsApp 訊息	匯入 WhatsApp 群發工具

注意：一個號碼可能顯示開通但無效（例如已登出帳戶），也可能有效但長期不活躍。行銷時應優先使用有效欄位，若追求高觸達率則再疊加活躍度過濾。

2. 活躍度狀態與窗口設定

活躍檢測需要指定時間窗口，常見選項有7天、15天、30天。匯出結果中的欄位 last_active_days 直接給出具體天數，而 active_window 欄位（如果存在）則記錄任務中設定的窗口值。

• 若窗口設為15天，則只有15天內有登入行為的號碼會被標記為「活躍15天」。
• 7天窗口的活躍號碼轉換率通常高於30天窗口，但數量更少。可根據行銷目的選擇：高轉換活動用7天活躍，品牌曝光類活動可用30天活躍。

3. 性別識別狀態

性別預測欄位 gender 或 predicted_gender 的準確率取決於 Telegram 公開資訊（頭像、暱稱）的豐富程度。一般來說，有清晰頭像和典型姓名的號碼準確率可達70%~80%，但不應作為唯一判定標準。建議結合活躍度與目標市場特性綜合使用。

---

五、用戶屬性欄位與輔助資訊

1. TGID 與 WSID 的匯出意義

• TGID（Telegram ID）：每個 Telegram 用戶擁有唯一數字 ID。匯出後，你可以用這個 ID 直接向用戶發送訊息（透過 Bot API），而不依賴手機號碼。這對於號碼已更換或無法發送 SMS 的用戶場景非常有用。
• WSID（WhatsApp ID）：WhatsApp 用戶內部標識符。同樣可用於精準發送，尤其在 WSID 綁定後即使號碼變更也能定位到同一用戶。將 WSID 和號碼一併匯出，匯入群發工具時不僅能提高到達率，還能減少因號碼格式錯誤導致的失敗。

2. 性別預測與活躍天數

• 性別欄位取值：male、female、unknown。注意：部分號碼因資訊不足會返回 unknown，不應視為無效資料。
• 活躍天數欄位 active_days 表示距最近一次登入的天數。例如 active_days=3 意味著該號碼3天前有登入行為。該欄位比窗口等級更精確，可用於按天數區間做二次篩選。

3. 資料去重倉庫與匯出標記

如果你多次提交篩號任務，重複的號碼會被自動去重，避免重複扣費。匯出結果中的 dedup_key 欄位表示去重倉庫中的記錄標識，task_id 則標記該條記錄所屬的任務。你可以透過這兩個欄位追溯資料來源，或在後續處理中合併多個任務的結果。

---

六、匯出欄位與計費的關係

KK-DATA 採用按條計費模式，不同檢測類型單價不同。匯出資料中通常包含費用相關欄位：

• estimated_cost：任務提交前顯示的預估費用（單位：元），實際扣費可能因去重等因素略有變化。
• actual_cost：任務完成後實際扣除的餘額。可在匯出 CSV 中查看每條號碼的檢測成本（部分任務可能不逐條記錄，僅顯示合計）。

重要：免費號碼生成（全球號碼生成）不扣費，只有線上篩號任務按檢測條數扣費。提交任務前務必在控制台確認預估費用，確保餘額充足。

---

七、欄位誤讀與注意事項

常見誤區總結如下，避免你在資料分析中走彎路：

1. 有效 ≠ 活躍：一個號碼有效（可聯繫）但可能已半年未登入，收到訊息的概率很低。應同時參考活躍度欄位。
2. 性別預測僅作參考：頭像和暱稱可能具有誤導性（如用卡通形象），建議對高價值行銷活動組合使用活躍度等其他維度。
3. tgid 與號碼並非一對一：用戶可能更換手機號碼，但 tgid 不變。匯出 tgid 後應以此為準進行後續操作，而非依賴號碼。
4. 去重倉庫的 dedup_key 不可跨任務複用：每條任務都有獨立去重邏輯，不同任務間 dedup_key 不保證唯一。
5. 活躍天數計算基於平台登入記錄：如果用戶在線但不發送訊息，可能仍會被記錄為活躍，這是正常現象。

---

常見問題

問：tg有效和tg活躍有什麼區別？

答：tg有效檢測判斷該號碼是否已在 Telegram 註冊且當前可被搜尋或聯繫；tg活躍檢測則在有效基礎上進一步判斷用戶在過去指定窗口（如7天/15天/30天）內是否有登入行為。活躍檢測消耗的餘額通常更高，適用於需要高觸達率的行銷場景。

問：如何判斷一個號碼是否開通了 WhatsApp？

答：在匯出結果中查看 whatsapp_status 欄位，取值為「開通」或「有效」表示該號碼已註冊 WhatsApp 並可接收訊息；若為「未開通」或「未檢測」，則需要重新提交檢測任務。

問：WSID 匯出有什麼作用？

答：WSID 是 WhatsApp 用戶的內部唯一標識符，可用於精準定向發送訊息，避免號碼變更後無法定位同一用戶。將 WSID 匯入群發工具可提高訊息到達率，減少因號碼格式問題導致的發送失敗。

問：匯出 CSV 中的 last_active_days 欄位如何解讀？

答：該欄位表示距離檢測完成時間最近一次活躍的天數。例如 last_active_days=3 表示該號碼 3 天前有登入行為。該資料來自平台提供的最後在線時間戳，精確到天。如果欄位為空或 null，可能意味著號碼有效但無法獲取具體活躍天數（如隱私設定限制）。

問：性別欄位準確率有多高？對行銷有幫助嗎？

答：性別預測基於 Telegram 公開的頭像和暱稱文字分析，準確率約 70%~80%，具體因地區和文化差異而異。可作為輔助參考，但不建議作為唯一篩選條件。對於需要精準性別定向的行銷（如女性用品、男性服飾），建議先用活躍度過濾出高品質用戶，再結合性別欄位做最後分組。

---

下一步行動

• 登入 應用控制台 查看你的篩號任務匯出資料，對照本文理解每個欄位。
• 查閱完整 使用文件 獲取更多欄位範例。
• 如果你還有疑問，可直接聯繫客服 Telegram @kkdata_robot 獲得幫助。

---

本文幫助你理清篩號匯出欄位表的完整資料字典與術語說明。掌握這些概念，你將能更高效地利用篩選結果，提升出海獲客的 ROI。