Meta广告创意性能追踪工具，计算CPT/CPI/ROAS等指标的达标率，支持多账户对比与历史趋势分析，适用于移动广告投放优化。
说明：
## 核心用法
**meta-ad-creatives** 是一款专为Meta（Facebook/Instagram）广告平台设计的创意绩效分析工具，核心功能是计算”达标率”（hit rate）——即满足特定成本阈值（如CPT < $100）的广告创意占比。用户通过配置`accounts_config.json`添加多个广告账户，调用`get_all_hit_rates()`函数即可获取当前或历史月份的整体及各账户达标率。
工具支持灵活的查询维度：按月份偏移量查询（`month_offset`）、获取全历史聚合数据（`all_time=True`）、对比多个月份趋势（`get_monthly_comparison`），以及钻取单个广告明细（`get_individual_ads`）。指标覆盖移动投放核心KPI：CPT（单次试用成本）、CPI（单次安装成本）、IPM（千次展示安装数）、ROAS（广告支出回报率），并内置货币转换功能。
## 显著优点
– **多账户统一管理**：支持批量监控多个客户/项目的创意表现，便于代理商或大型广告主集中分析
– **历史趋势追踪**：通过Firestore或SQLite持久化数据，支持跨月度对比与长期绩效追踪
– **灵活的达标判定**：可自定义benchmark阈值（如CPT目标值），自动过滤零花费或零转化创意
– **开发者友好**：纯Python实现，提供清晰的函数接口，易于集成到现有数据流水线
## 潜在局限
– **依赖Meta Marketing API**：需有效访问令牌，受API速率限制及权限变更影响
– **配置门槛**：需要手动维护`accounts_config.json`，缺乏可视化配置界面
– **指标深度有限**：聚焦创意层级汇总，不支持受众细分、频次分析等进阶维度
– **本地化部署复杂**：Firestore与SQLite双模式虽提供灵活性，但增加了部署决策成本
## 适合人群
– 移动应用/游戏投放团队，需追踪试玩/安装成本效率
– 广告代理商，管理多客户Meta账户并需定期输出创意达标报告
– 数据分析师，构建内部BI系统并需要标准化的创意绩效数据接口
## 常规风险
– **API凭证泄露**：`FACEBOOK_ACCESS_TOKEN`等敏感变量需妥善保管，避免硬编码提交至版本控制
– **数据准确性依赖配置**：错误的`benchmark_value`或`filter`设置可能导致误判创意表现
– **Firestore成本**：高频写入历史数据可能产生云服务费用，需评估数据保留策略
会员专属
