名称： video-ad-deconstructor
版本： 1.0.0
描述： 使用 Gemini AI 将视频广告创意解构为营销维度。提取广告钩子、社会认同、行动号召、目标受众、情感触发点、紧迫性策略等。适用于分析竞争对手广告、生成创意简报或理解广告的有效要素。

视频广告解构器

利用 AI 将视频广告创意解构为可操作的营销洞察。

功能概述

• 生成摘要：提取产品、功能、受众、行动号召等信息。
• 解构营销维度：分析广告钩子、社会认同、紧迫性、情感等维度。
• 支持多种内容类型：适用于消费品和游戏广告。
• 进度追踪：支持回调函数以跟踪长时间分析任务。
• JSON 输出：提供结构化数据，便于下游处理。

环境配置

1. 环境变量

# Gemini API 必需的环境变量
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

2. 依赖安装

pip install vertexai

使用方法

基础广告解构

from scripts.deconstructor import AdDeconstructor
from scripts.models import ExtractedVideoContent
import vertexai
from vertexai.generative_models import GenerativeModel

# 初始化 Vertex AI
vertexai.init(project="your-project-id", location="us-central1")
gemini_model = GenerativeModel("gemini-1.5-flash")

# 创建解构器实例
deconstructor = AdDeconstructor(gemini_model=gemini_model)

# 创建提取的内容（可从 video-ad-analyzer 获取或手动创建）
content = ExtractedVideoContent(
    video_path="ad.mp4",
    duration=30.0,
    transcript="厌倦了杂乱的线缆？试试 CableFlow...",
    text_timeline=[{"at": 0.0, "text": ["今日五折优惠"]}],
    scene_timeline=[{"timestamp": 0.0, "description": "人物因线缆缠绕而沮丧"}]
)

# 生成摘要
summary = deconstructor.generate_summary(
    transcript=content.transcript,
    scenes="0.0s: 人物因线缆缠绕而沮丧",
    text_overlays="今日五折优惠"
)
print(summary)

完整维度解构

# 解构所有营销维度
def on_progress(fraction, dimension):
    print(f"进度: {fraction*100:.0f}% - 已分析 {dimension}")

analysis = deconstructor.deconstruct(
    extracted_content=content,
    summary=summary,
    is_gaming=False,  # 游戏广告请设为 True
    on_progress=on_progress
)

# 访问各维度数据
for dimension, data in analysis.dimensions.items():
    print(f"\n{dimension}:")
    print(data)

输出结构

摘要输出示例

产品/应用: CableFlow 线缆整理器

核心功能:
磁吸设计: 自动保持线缆整齐
通用适配: 适用于所有线缆类型
优质材质: 耐用硅胶结构

目标受众: 对线缆管理感到困扰的科技用户

行动号召: 立即订购，享受五折优惠

解构输出示例

{
    "spoken_hooks": {
        "elements": [
            {
                "hook_text": "厌倦了杂乱的线缆？",
                "timestamp": "0:00",
                "hook_type": "问题提问",
                "effectiveness": "高 - 直接针对痛点"
            }
        ]
    },
    "social_proof": {
        "elements": [
            {
                "proof_type": "用户数量",
                "claim": "超过 100 万满意用户",
                "credibility_score": 7
            }
        ]
    },
    # ... 更多维度
}

可解构的营销维度

自定义提示词

编辑 prompts/marketing_analysis.md 文件以自定义：

• 需要分析的维度
• 输出格式
• 评分标准
• 游戏与消费品广告的侧重点

常见问题解答

• "这个广告使用了哪些钩子？"
• "广告的情感诉求是什么？"
• "广告如何营造紧迫感？"
• "广告的目标受众是谁？"
• "展示了哪些社会认同元素？"
• "解构这个竞争对手的广告"