Audiense Insights

🚀 使用指南

本指南将帮助你快速上手相关工具，通过简单的步骤完成安装、配置，并使用工具进行报告分析和受众分段比较等操作。

🚀 快速开始

安装工具

• 安装Python：请参考官方文档进行安装。
• 安装pip：pip会随Python一同安装。
• 安装依赖项：使用以下命令安装requests库。

pip install requests

配置环境变量

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

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

✨ 主要特性

可用工具

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

📦 安装指南

安装依赖

pip install requests

配置环境

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

💻 使用示例

基础用法

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

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

高级用法

示例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"]
}

📚 详细文档

命令行参数

报告摘要工具 (get_report_summary.py)

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

分段比较工具 (compare_segments.py)

| 参数名称 | 描述 | 类型 | 是否必需 | | ---- | ---- | ---- | ---- | | segment_a | 第一个分段标识 | string | 是 | | segment_b | 第二个分段标识 | string | 是 | | output_dir | 输出文件夹路径 | string | 否 | | format | 输出格式 | enum | 否 |

📄 注意事项

常见问题

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

安全提示

⚠️ 重要提示

请保护好你的凭据，不要将API密钥公开。

💡 使用建议

建议每90天更换一次访问令牌。

📚 日志记录

查看日志

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

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

📚 文档扩展

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

• API文档
• 开发者指南