SuperAPI AI 工具集

creative-signal

设计与创作

查看项目

更新于 10-15 22:11

技能介绍

Creative Signal 用于分析 Meta 视频广告中哪些创意属性与注意力指标相关。它聚焦两个指标:hook rate(3 秒观看数 ÷ 曝光数)和 hold rate(thruplay ÷ 3 秒观看数),覆盖窗口期内所有已投放的视频广告。

主要能力:脚本把指标拉取到本地 SQLite 存储,对每条创意只打一次标签(使用 Gemini gemini-3.1-flash-lite 搭配 ffmpeg 特征),再计算每个属性的提升幅度并给出明确置信度。属性分为需统计检验的类别(如 first3s_content、hook_text、cut_count、sound_mode 等)与仅作参考的 hook_text 文本。智能体读取 signals.json 撰写 brief.md:判断由智能体给出,数学结果不重新推导。

使用方式:技能支持可选窗口参数,默认 last_14d,有效值 last_7d、last_14d、last_30d,也支持 reconfigure 和 backfill。运行前检查四项前置条件(虚拟环境、账户配置、GEMINI_API_KEY、非空存储),任一缺失进入 ONBOARDING MODE。分析模式执行:

<skill-dir>/.venv/bin/python <skill-dir>/scripts/run.py --window $ARGUMENTS

run.py 内部依次执行 sync → assets → deterministic → gemini → correlate。每次运行幂等,第二次运行通常只重新计算相关性。首次打标约每广告 3 秒加 9k tokens,200 条广告约 10 分钟,稳定后约 30 秒。退出码 0 表示成功,3 表示存储为空,1 表示其他错误。输出写入 ~/.meta-ads-intel/creative-signal/runs/<run>/ 下的 signals.json、run-status.json 与 brief.md。

适用场景:想知道哪些创意开头、剪辑节奏、声音模式或情绪与更高 hook/hold 相关时使用。

限制:v1 不提供任何收入或 ROAS 结论,hook 与 hold 只是注意力代理指标;eligible 少于 20 时不会有 strong 信号;q_value 为多重比较校正后的 p 值;部分属性依赖 sound_mode 包含音乐才有意义;视频与快照目录为临时文件不可依赖,存储中的 asset_hash 标签才是持久结果;GEMINI_API_KEY 不可泄露到运行目录或 brief。缺失事实如具体价格、平台支持范围、更长窗口等暂未提供。