manage-campaign

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Manage Campaign

管理广告活动

Overview

概述

Retrieve and manage advertising campaign state. Campaigns progress through a defined workflow: parameters → research → ad copy → images → mixed media. This skill helps track progress and determine next steps.

检索并管理广告活动状态。广告活动会按照既定工作流推进：参数设置 → 调研 → 广告文案 → 图片 → 混合媒体。本技能可帮助跟踪进度并确定下一步操作。

When to Use This Skill

适用场景

Use this skill when:

Retrieving campaign data by ID
Checking campaign completion status
Determining next workflow step
Viewing stored campaign parameters, research, or assets
Understanding what components are complete or pending

在以下场景中使用本技能：

按ID检索活动数据
查看活动完成状态
确定工作流的下一步操作
查看已存储的活动参数、调研内容或素材
了解哪些组件已完成或待处理

Campaign Lifecycle

活动生命周期

Campaigns follow this workflow:

1. parseAdRequirements → Creates campaign with parameters
2. conductAdResearch → Adds research report
3. generateAdCopy → Adds ad copy variations (A/B)
4. generateAdImages → Adds image variations (A/B)
5. generateMixedMedia → Creates final composite

Each step stores results in the campaign record.

广告活动遵循以下工作流：

1. parseAdRequirements → Creates campaign with parameters
2. conductAdResearch → Adds research report
3. generateAdCopy → Adds ad copy variations (A/B)
4. generateAdImages → Adds image variations (A/B)
5. generateMixedMedia → Creates final composite

每个步骤的结果都会存储到活动记录中。

Campaign Data Structure

活动数据结构

A campaign contains:

Field	Description	Set By
id	UUID identifier	parseAdRequirements
parameters	Campaign parameters (product, audience, platform, etc.)	parseAdRequirements
research	Research report with insights and recommendations	conductAdResearch
ad_copy	Two ad copy variations (A/B)	generateAdCopy
images	Two image variations (A/B)	generateAdImages
mixed_media	Final composite creative	generateMixedMedia
selected_ad_copy_variation	User's chosen copy (A or B)	User selection
selected_image_variation	User's chosen image (A or B)	User selection

活动包含以下字段：

字段	描述	设置方
id	UUID标识符	parseAdRequirements
parameters	活动参数（产品、受众、平台等）	parseAdRequirements
research	包含洞察和建议的调研报告	conductAdResearch
ad_copy	两版广告文案（A/B测试用）	generateAdCopy
images	两版图片（A/B测试用）	generateAdImages
mixed_media	最终复合创意素材	generateMixedMedia
selected_ad_copy_variation	用户选择的文案版本（A或B）	用户选择
selected_image_variation	用户选择的图片版本（A或B）	用户选择

Completion Status

完成状态

Check these flags to determine campaign progress:

hasParameters: Campaign parameters are set
hasResearch: Research report is complete
hasAdCopy: Ad copy variations generated
hasImages: Image variations generated
hasMixedMedia: Final creative is ready
hasSelectedAdCopy: User selected a copy variation
hasSelectedImage: User selected an image variation
isComplete: All components are present

通过以下标记判断活动进度：

hasParameters：活动参数已设置
hasResearch：调研报告已完成
hasAdCopy：多版广告文案已生成
hasImages：多版图片已生成
hasMixedMedia：最终创意素材已就绪
hasSelectedAdCopy：用户已选择文案版本
hasSelectedImage：用户已选择图片版本
isComplete：所有组件均已完成

Workflow Guidance

工作流指导

Determining Next Step

确定下一步操作

Based on completion status, recommend:

Status	Next Action
No parameters	Call parseAdRequirements
Parameters only	Call conductAdResearch
Has research	Call generateAdCopy
Has ad copy	Call generateAdImages
Has images	User selects variations, then generateMixedMedia
Complete	Campaign ready for deployment

根据完成状态，推荐以下操作：

状态	下一步操作
无参数	调用parseAdRequirements
仅设置参数	调用conductAdResearch
已有调研内容	调用generateAdCopy
已有广告文案	调用generateAdImages
已有图片	用户选择版本，之后调用generateMixedMedia
已完成	活动就绪，可部署

Handling Missing Selections

处理未选择的版本

Before generating mixed media:

Check if ad copy variation is selected
Check if image variation is selected
If not selected, prompt user to choose A or B

在生成混合媒体之前：

检查是否已选择广告文案版本
检查是否已选择图片版本
若未选择，提示用户选择A或B版本

Output Format

输出格式

When reporting campaign status, return:

json

{
  "campaign_id": "uuid",
  "campaign_name": "name or null",
  "status": "in_progress or complete",
  "completion": {
    "hasParameters": true,
    "hasResearch": true,
    "hasAdCopy": false,
    "hasImages": false,
    "hasMixedMedia": false,
    "hasSelectedAdCopy": false,
    "hasSelectedImage": false
  },
  "next_step": "generateAdCopy",
  "next_step_description": "Generate ad copy variations based on research insights",
  "created_at": "ISO timestamp",
  "updated_at": "ISO timestamp"
}

报告活动状态时，返回以下格式：

json

{
  "campaign_id": "uuid",
  "campaign_name": "name or null",
  "status": "in_progress or complete",
  "completion": {
    "hasParameters": true,
    "hasResearch": true,
    "hasAdCopy": false,
    "hasImages": false,
    "hasMixedMedia": false,
    "hasSelectedAdCopy": false,
    "hasSelectedImage": false
  },
  "next_step": "generateAdCopy",
  "next_step_description": "Generate ad copy variations based on research insights",
  "created_at": "ISO timestamp",
  "updated_at": "ISO timestamp"
}

Important Notes

重要说明

Campaign IDs are UUIDs - validate format before querying
All campaign data is persisted in PostgreSQL
Each workflow step updates the campaign record
Missing components block downstream steps
User selections are required before mixed media generation

活动ID为UUID格式，查询前请验证格式
所有活动数据均持久化存储在PostgreSQL中
每个工作流步骤都会更新活动记录
缺失组件会阻塞后续步骤
生成混合媒体前必须完成用户版本选择