使用指南

1. 开始使用

安装工具

• 安装Python: 官方文档
• 安装pip: 随Python一同安装
• 安装依赖项:

  pip install requests
  

配置环境变量

设置以下API密钥和访问令牌：

export AUDIENCE_API_KEY="your_api_key"
export AUDIENCE_API_SECRET="your_api_secret"

2. 工具列表

可用工具

1. 报告摘要: 提供报告的全面概述，包括受众人口统计、兴趣及内容偏好。
2. 受众分段分析: 比较不同报告中的受众分段，识别相似性和独特性。
3. 内容见解: 分析受众喜欢和分享的内容，提取关键主题和趋势。

使用示例

# 获取报告摘要
python tools/get_report_summary.py --report_id "12345"

# 比较两个受众分段
python tools/compare_segments.py --segment_a "A" --segment_b "B"

3. 命令行参数

报告摘要工具 (get_report_summary.py)

• 报告ID: 必需，用于指定要分析的报告。
• 输出格式: 可选（json 或 csv），默认为json。

分段比较工具 (compare_segments.py)

4. 使用示例

示例1: 分析报告

# 获取报告摘要
$ python get_report_summary.py --report_id 67890 --output json

# 结果输出
{
  "report_id": 67890,
  "summary": "目标受众主要为25-35岁年轻人，兴趣集中于科技和生活方式。"
}

示例2: 比较分段

$ python compare_segments.py --segment_a "tech_enthusiasts" --segment_b "digital_marketers"

# 输出结果
{
  "similarity_score": 0.75,
  "differences": ["age range", "interests"]
}

5. 注意事项

常见问题

1. 未找到报告: 确认报告ID正确且已生成。
2. 缺少权限: 检查API密钥是否有效。
3. 数据延迟: 部分报告可能需要时间处理。

安全提示

• 保护凭据: 不要将API密钥公开。
• 定期轮换: 建议每90天更换一次访问令牌。

6. 日志记录

查看日志

# Unix/Linux
$ tail -n 20 -f logs/app.log

# Windows
$ Get-Content -Path "logs/app.log" -Wait -Tail 20

7. 文档扩展

如需更多帮助，可参考以下资源：

• API文档
• 开发者指南