GEO 数据导出的场景

GEO 数据导出适用于：

• BI 分析：导出到 Tableau/Power BI 做深度分析
• 数据备份：定期备份历史诊断数据
• 内部系统对接：导入 CRM/数据仓库
• 归因分析：结合销售数据做归因，参考GEO 归因
• 报告制作：导出原始数据制作自定义报告

数据导出的格式

格式	内容	适用场景
CSV	表格数据（每次诊断一行）	Excel 分析
JSON	完整结构化数据	程序处理
Excel	多 sheet 工作簿	多维度分析

数据导出的方式

方式 1：控制台手动导出

1. 在「历史诊断」页面选择时间范围
2. 选择导出格式（CSV/JSON/Excel）
3. 点击「导出」下载文件

方式 2：API 批量拉取（年度套餐）

通过 API 编程拉取历史数据，参考GEO API：

GET /api/diagnose/history?brand=品牌名&from=2026-01-01&to=2026-07-01
Authorization: Bearer <API_KEY>

方式 3：定时自动导出

年度套餐支持定时自动导出到指定邮箱或 Webhook：

• 每月自动导出 CSV 到邮箱
• 每月自动推送 JSON 到 Webhook

导出数据的字段说明

字段	类型	说明
diagnose_id	string	诊断唯一 ID
brand	string	品牌名
category	string	品类词
platform	string	AI 平台名
mention_rate	float	提及率（0-1）
citation_rate	float	引用率（0-1）
recommendation	float	推荐倾向（0-1）
accuracy	float	信息准确度（0-1）
sentiment	float	情感倾向（-1 到 1）
mention_position	string	提及位置（top/middle/bottom）
diagnose_date	date	诊断日期

数据备份的最佳实践

• 定期备份：每月导出一次历史数据，防止数据丢失
• 多格式备份：同时导出 CSV 和 JSON，确保兼容性
• 版本管理：按日期命名导出文件，便于版本追踪
• 云端存储：导出文件存到云存储（OSS/S3），参考GEO 集成

数据导出的注意事项

• 数据量：大量历史数据导出可能耗时，建议分批拉取
• API 限流：API 拉取遵守限流策略
• 数据安全：导出文件含品牌敏感数据，妥善保管
• 格式兼容：注意 CSV 的编码（UTF-8）与日期格式