美国有效TG号码导出完全指南：CSV/TXT 列名规范、编码设置与下游导入最佳实践

在出海获客与社群运营中，美国有效TG号码（即Telegram已开通且可触达的账号）是精准营销的基础资源。然而，很多团队在完成筛号后，却因为导出格式不匹配、编码错误、字段映射混乱等问题，导致数据无法顺利导入CRM、群发工具或自动化脚本，白白浪费了筛选成本。本文将以KK-DATA平台为例，详细解析美国TG有效号码的导出规范，涵盖CSV/TXT列名含义、编码与分隔符选择，以及下游导入的实操注意事项，帮助您实现从“筛号”到“用号”的无缝衔接。

什么是美国有效 TG 号码？筛选结果包含哪些数据字段？

所谓美国有效TG号码，是指归属国家为美国（国家代码+1）且在Telegram平台已完成注册（即“开通”）的账号。KK-DATA的多平台筛号功能支持对Telegram号码进行开通检测、活跃度检测、性别识别等，并输出结构化数据。筛选结果通常以表格形式呈现，让您不只拿到一串数字，还能掌握每个号的质量与画像。

基础字段：手机号、国家与TGID

• 手机号（phone）：国际格式，如+12025551234，方便直接拨号或添加联系人。
• 国家代码（country_code）：自动识别为US，便于按国家筛选。
• tgid：Telegram用户唯一标识，用于后续精准操作（如拉群、私信），比手机号更稳定。

状态字段：开通检测与活跃度

• 开通（status_registered）：布尔值，true表示该号码已注册Telegram；false表示未注册。美国有效TG号码即此字段为true。
• 活跃度（status_active）：根据最近上线时间判断，例如“7天内活跃”“30天内活跃”。活跃度越高，触达成功率越大。
• 性别（gender）与年龄（age）：部分号码可通过性别识别模型推测性别和年龄段（如“male”“30-40”），用于人群定向。请注意，年龄字段为模型估算，非身份证级精度，可用于粗略分析。

KK-DATA 导出格式详解：CSV 与 TXT 的差异与最佳设置

在KK-DATA控制台完成筛号任务后，您可以选择CSV或TXT格式导出结果。两种格式各有优劣，适用场景不同。

CSV 导出：列名、编码与分隔符

CSV（逗号分隔值）是结构化数据的标准格式，每一列都有英文列名，适合导入Excel、WPS、CRM系统等。

• 推荐设置：

  • 编码：UTF-8 with BOM。BOM（字节顺序标记）可让Excel/WPS直接识别UTF-8，避免中文乱码。
  • 分隔符：逗号（,）。若号码字段或备注中含有逗号，列名会错位——KK-DATA默认已对内容做转义，一般无问题。
  • 包含标题行：勾选后，首行为列名（如phone,country_code,tgid,status_registered），便于字段对应。

• 常见列名（以控制台实际导出版本为准）：

  列名	中文含义	示例
  phone	手机号（国际格式）	+12025551234
  country_code	国家代码	US
  tgid	Telegram UID	123456789
  status_registered	是否开通（true/false）	true
  status_active	活跃度描述（如7d_active）	7d_active
  gender	性别推测（male/female/unknown）	male
  age	年龄区间	30-40

TXT 导出：逐行导出号码的适用场景

TXT 文件每行一个手机号，无标题行、无额外字段。适合只关注号码列表的场景，例如：

• 批量导入Telegram群发Bot（仅接受纯号码）。
• 导入短信平台进行验证。
• 用作“白名单”或“黑名单”列表。

导出列名含义对照表（快速查阅）

以下是KK-DATA控制台常见导出列名及其说明，方便您在导入下游工具时快速映射字段。实际字段以控制台任务详情页为准，不同检测类型（如仅开通、或开通+活跃+性别）会输出差异列。

英文列名	中文释义	数据类型 / 示例
phone	手机号（含国家代码）	字符串，如 +8613800138000
country_code	国家二位代码	字符串，如 US、CN
tgid	Telegram用户ID	数字，如 123456789
status_registered	是否已注册Telegram	布尔，true / false
status_active	最近活跃时间段	字符串，如 7d_active、30d_active、inactive
gender	推测性别	字符串，male / female / unknown
age	推测年龄区间	字符串，如 18-24、25-34、35-44
wsid	WhatsApp ID（仅筛WhatsApp时有）	数字
uid	平台UID（如Line、Zalo）	字符串

下游导入注意事项：CRM、邮件群发与 Telegram 自动操作

拿到规范导出的美国有效TG号码后，下一步就是导入各类运营工具。不同工具对数据格式要求各异，下面列举常见场景及应对方案。

CRM 导入：字段映射与批量追加

• 字段映射：将 phone 映射到CRM的“电话”字段；将 gender 映射到“性别”或“分类”字段；将 status_active 映射为“活跃度标签”（如“7天活跃”可设为“高活跃”）。
• 格式统一：CSV中的手机号带+号，但某些CRM系统要求纯数字或去掉+，请提前批量替换。可先用Excel或脚本处理。
• 批量追加：避免一次性导入超大文件导致超时，建议分批（如每批5000条）导入。

Telegram Bot 或社群运营工具导入

• 优先使用 tgid：大多数高级Telegram Bot（如节码群发、欢迎机器人）支持通过tgid添加用户或发送消息，而非手机号。因为手机号可能变更或用户隐私设置阻止通过手机号查找。您可以从CSV中提取tgid列单独导出一份tgid.txt。
• 日期解析：若导出文件含时间戳列（如任务创建时间），注意导入工具是否支持yyyy-MM-dd格式，避免乱码。
• 活跃度筛选：配合 status_active 列，仅导入“7天活跃”用户，提高消息打开率。

常见导出问题排查：乱码、字段缺失、分隔符冲突

即使严格按照推荐设置，实际操作中仍可能遇到问题。以下是几个高频故障及解决方法。

• Excel 打开 CSV 出现乱码：未选择 UTF-8 编码。解决方法：用记事本打开CSV，另存为“UTF-8 with BOM”格式；或直接修改Excel导入时的编码选项（数据→从文本/CSV导入→选择UTF-8）。
• 手机号带空格或特殊符号：部分国家号码在导出时可能包含空格（如+1 202 555 1234）。解决：使用Excel“查找替换”删除空格。
• CSV 列错位：若某条数据内容包含逗号，且未正确引号包裹，会导致列偏移。验证方法：用纯文本编辑器打开CSV，检查每一行逗号数量是否一致。若不一致，排查该条数据并手动修正。
• 字段缺失：可能原因是筛号任务检测类型未勾选该字段。请返回控制台检查任务配置，确保“导出字段”包含所需列。
• TXT 文件每行不是纯号码：若选择了“包含标题行”导出TXT，实际输出的仍是带列名的CSV格式。请确认导出时选择“纯文本”或“无标题行”。

如何验证导出数据质量？小批量测试方法论

在将全部美国有效TG号码投入正式营销前，强烈建议先进行小批量验证。

1. 抽取样本：从筛号结果中随机选取50-100条号码，单独导出小文件。
2. 导入目标工具：按上述流程导入CRM或Bot，检查字段是否完整、手机号格式是否正确、活跃度标签是否被正确解析。
3. 对比预览：对比控制台中的“任务结果预览”与导出文件，确保数据一致。例如，预览中显示1000条开通，导出后数量应相同。
4. 发送测试：用2-3个号码发送一条测试消息（如“你好，这是测试”），确认能成功投递，并观察反馈（送达、已读、被屏蔽等）。

若测试通过，再对全量数据进行正式导入。此步骤可避免因格式或编码问题导致的批量失败，节省大量排查时间。

总结：用标准格式释放美国有效 TG 号码的价值

从筛号到导出，再到下游应用，每一步的数据规范都直接影响最终的营销效率。本文详细介绍了美国有效TG号码的导出格式、列名含义、编码设置以及常见问题排查方法，帮助出海团队避免因数据格式错误而返工。KK-DATA平台提供了灵活的CSV/TXT导出选项，配合数据去重仓库，可高效完成从“生成号码→筛号→导出→去重→导入”的完整链路。

掌握规范导出技巧，您手中的美国TG有效号码才能真正转化为可触达的客户资产。现在就登录控制台，体验一次标准化导出吧。

👉 登录控制台开始筛号
👉 双向联系客服：https://t.me/kkdata_robot

常见问题

问：导出的 CSV 文件中，那一列是手机号码？
答：列名为 phone，格式通常为国际格式，如 +1xxxxxxxxxx；建议在导入下游工具前检查是否包含国家代码。

问：用 Excel 打开 CSV 文件出现中文乱码怎么办？
答：请确认导出时选择了“UTF‑8 with BOM”编码；若仍乱码，可先用记事本打开 CSV，另存为“带 BOM 的 UTF‑8”格式后再用 Excel 打开。

问：导出的 TXT 文件每行是一个号码吗？是否包含其他信息？
答：纯 TXT 导出时，每行仅一个手机号，无标题行或其他字段。若您勾选了“包含标题行”再选 TXT，实际会输出 CSV 格式内容。建议导出时选择“无标题行”以得到纯号码列表。

问：筛选结果中的性别和年龄字段准确吗？
答：性别与年龄字段基于模型推测，非身份证级精度，可用于人群画像分析，但不建议作为精准定向的唯一依据。建议结合活跃度等字段综合判断。

问：导出后能否直接用日期字段排序？
答：如果任务结果包含时间戳列（如 created_at），格式为 yyyy-MM-dd HH:mm:ss，多数工具可直接识别并排序。若需按活跃天数排序，可使用 status_active 列做分组筛选。