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)

📄 注意事項

常見問題

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文檔
• 開發者指南