meta-ad-creatives

核心用法

meta-ad-creatives 是一款专为Meta（Facebook/Instagram）广告主设计的创意效果分析工具。用户通过配置环境变量（FACEBOOK_ACCESS_TOKEN等）和账户配置文件（accounts_config.json），即可调用Python脚本获取多账户的广告创意表现数据。核心功能包括：计算创意达标率（hit rate，即满足CPT/CPI等基准的广告占比）、追踪CPT（单次试用成本）、CPI（单次安装成本）、IPM（千次展示安装数）、ROAS等关键指标，支持按月份偏移查询（month_offset）、全时段聚合（all_time）以及多月份趋势对比（monthly_comparison）。数据默认存储于Firestore（云端）或SQLite（本地），便于历史趋势分析。

显著优点

1. 多账户统一管理：支持同时监控多个Meta广告账户，通过配置文件灵活设置不同账户的筛选条件（campaign名称、地域、基准值）。
2. 灵活的基准体系：不仅支持CPT，还可扩展至CPI、IPM、ROAS等多维度指标，满足不同业务场景的评估需求。
3. 历史数据沉淀：内置数据存储机制，支持跨时间段的趋势对比，帮助识别季节性规律或长期优化效果。
4. 货币转换支持：适配国际化账户的结算需求。
5. 轻量易部署：纯Python实现，依赖仅requests和python-dotenv，本地SQLite模式无需额外基础设施。

潜在缺点与局限性

1. 依赖Meta API稳定性：所有数据均来自Meta Graph API，若API限流、字段变更或账户权限问题，将直接影响功能可用性。
2. 基准值静态配置：benchmark_value在配置文件中固定，无法动态调整，对于波动较大的市场可能需要频繁手动更新。
3. 数据粒度限制：主要聚焦创意级别的聚合指标，若需更细粒度的受众、版位分析，需二次开发。
4. 无实时告警机制：需主动调用脚本查询，缺乏自动化的异常监控或达标率跌破阈值时的通知功能。
5. 本地化部署门槛：虽然支持SQLite，但多账户场景下Firestore配置对非技术用户有一定学习成本。

适合的目标群体

• 广告代理商：管理多个客户账户，需批量监控创意表现并生成月度报告。
• 出海应用/游戏厂商：依赖Meta渠道获客，需追踪CPI、ROAS等核心指标优化投放策略。
• 数据驱动的市场团队：希望建立创意素材的A/B测试评估体系，沉淀历史数据指导素材生产。
• 技术型优化师：具备基础Python能力，希望将创意分析流程自动化、集成至内部BI系统。

使用风险

1. API限流风险：Meta Graph API有严格的调用频率限制，大规模账户或长周期数据拉取可能触发限流，需合理控制并发和分页逻辑。
2. 访问令牌安全：FACEBOOK_ACCESS_TOKEN若泄露，可能导致账户数据被非法访问，需严格保管环境变量。
3. 数据一致性风险：本地SQLite与云端Firestore切换时，历史数据可能分散存储，需定期备份避免丢失。
4. 依赖项维护：requests等依赖库若出现安全漏洞，需及时更新，建议锁定版本并定期审计。
5. 合规性注意：处理广告数据时需遵守Meta平台政策及各地数据保护法规（如GDPR），避免存储用户级隐私信息。