视频广告解构器

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

该技能的功能

• 生成摘要：提取产品、功能、目标受众、行动号召（CTA）等关键信息
• 解构营销维度：包括钩子（Hooks）、社交证明（Social Proof）、紧迫感（Urgency）、情绪触发点（Emotion）等
• 支持多种内容类型：面向消费类产品与游戏类广告
• 进度追踪：支持回调机制，适用于耗时较长的分析任务
• JSON 输出：提供结构化数据，便于下游系统进一步处理

配置

1. 环境变量

# Gemini 所需
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="Tired of messy cables? Meet CableFlow...",
    text_timeline=[{"at": 0.0, "text": ["50% OFF TODAY"]}],
    scene_timeline=[{"timestamp": 0.0, "description": "Person frustrated with tangled cables"}]
)

# 生成摘要
summary = deconstructor.generate_summary(
    transcript=content.transcript,
    scenes="0.0s: Person frustrated with tangled cables",
    text_overlays="50% OFF TODAY"
)
print(summary)

完整解构

# 解构全部营销维度
def on_progress(fraction, dimension):
    print(f"Progress: {fraction*100:.0f}% - Analyzed {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)

输出结构

摘要输出示例

Product/App: CableFlow Cable Organizer

Key Features:
Magnetic design: Keeps cables organized automatically
Universal fit: Works with all cable types
Premium materials: Durable silicone construction

Target Audience: Tech users frustrated with cable management

Call to Action: Order now and get 50% off

解构输出示例

{
    "spoken_hooks": {
        "elements": [
            {
                "hook_text": "Tired of messy cables?",
                "timestamp": "0:00",
                "hook_type": "Problem Question",
                "effectiveness": "High - directly addresses pain point"
            }
        ]
    },
    "social_proof": {
        "elements": [
            {
                "proof_type": "User Count",
                "claim": "Over 1 million happy customers",
                "credibility_score": 7
            }
        ]
    },
    # ... 其他维度
}

已解构的营销维度

自定义提示词（Prompts）

编辑 prompts/marketing_analysis.md 文件，可自定义以下内容：

• 需分析的营销维度
• 输出格式
• 评分标准
• 侧重游戏类广告还是消费类产品广告

常见问题解答

• “该广告使用了哪些钩子？”
• “该广告的情绪诉求是什么？”
• “该广告如何营造紧迫感？”
• “该广告的目标人群是谁？”
• “该广告展示了哪些社交证明？”
• “请解构这个竞品的广告”