美国数据导出规范：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、gender、age 等。
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 获取操作指导。