核心用法
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成本：高频写入历史数据可能产生云服务费用，需评估数据保留策略