parse-ad-requirements

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Parse Advertising Requirements

解析广告需求

Overview

概述

Extract structured advertising campaign parameters from natural language input provided by advertisers. Supports creating new campaigns and updating existing campaigns with additional information. Identify missing information and provide helpful guidance for completing campaign requirements.

从广告主提供的自然语言输入中提取结构化的广告活动参数。支持创建新活动以及为现有活动补充信息进行更新，还能识别缺失的信息并为完善活动需求提供实用指导。

When to Use This Skill

何时使用该技能

Use this skill when:

Analyzing advertising requirements or campaign briefs
Converting natural language ad requests into structured data
Creating a new advertising campaign from natural language input
Updating an existing campaign with additional information
Identifying missing or incomplete campaign information
Validating that all necessary advertising parameters are provided
Processing advertiser input for campaign setup

使用该技能的场景：

分析广告需求或活动简报
将自然语言广告请求转换为结构化数据
从自然语言输入创建新的广告活动
为现有活动补充信息进行更新
识别活动信息的缺失或不完善之处
验证是否提供了所有必要的广告参数
处理广告主的活动设置输入

Workflow

工作流程

When given a natural language campaign description, follow this step-by-step workflow:

当收到自然语言形式的活动描述时，请遵循以下分步工作流程：

Step 1: Extract Campaign Parameters

步骤1：提取活动参数

Analyze the input text and extract the following 12 fields:

product_or_service: The product, service, or brand being advertised
- Examples: "fitness app", "organic coffee brand", "SaaS platform"
product_or_service_url: Website or landing page URL for the product/service
- Examples: "https://myfitnessapp.com", "www.coffeebrand.com"
campaign_name: A descriptive name for this campaign
- Examples: "Summer Fitness Launch", "Q4 Brand Awareness"
target_audience: Demographics, interests, or characteristics of the target audience
- Examples: "women aged 25-35", "tech-savvy millennials", "small business owners"
geography: Geographic targeting for the campaign
- Examples: "Southeast Asia", "United States", "Global", "New York City"
ad_format: Type of ad creative needed
- Examples: "video ad", "carousel ad", "static image", "story ad"
budget: Campaign budget amount and currency
- Examples: "$5,000", "€10,000", "5000 USD"
platform: Advertising platform(s) to use
- Examples: "TikTok", "Facebook", "Instagram", "Google Ads", "LinkedIn"
kpi: Key performance indicators or success metrics
- Examples: "CTR", "app installs", "conversions", "brand awareness", "engagement rate"
time_period: Campaign duration or timeline
- Examples: "2 weeks", "Q1 2024", "ongoing", "launch in March"
creative_direction: Style, tone, or creative requirements
- Examples: "energetic and motivating", "professional and trustworthy", "fun and playful"
other_details: Any additional requirements or context
- Examples: "must include testimonials", "competitor: BrandX", "seasonal theme"

分析输入文本，提取以下12个字段：

product_or_service：推广的产品、服务或品牌
- 示例："健身应用"、"有机咖啡品牌"、"SaaS平台"
product_or_service_url：产品/服务的官网或落地页URL
- 示例："https://myfitnessapp.com"、"www.coffeebrand.com"
campaign_name：该活动的描述性名称
- 示例："夏季健身应用推广"、"Q4品牌认知活动"
target_audience：目标受众的人口统计特征、兴趣或特点
- 示例："25-35岁女性"、"精通科技的千禧一代"、"小企业主"
geography：活动的地域定向
- 示例："东南亚"、"美国"、"全球"、"纽约市"
ad_format：所需的广告创意类型
- 示例："视频广告"、"轮播广告"、"静态图片"、"故事广告"
budget：活动预算金额及币种
- 示例："$5,000"、"€10,000"、"5000 USD"
platform：使用的广告平台
- 示例："TikTok"、"Facebook"、"Instagram"、"Google Ads"、"LinkedIn"
kpi：关键绩效指标或成功衡量标准
- 示例："CTR"、"应用安装量"、"转化量"、"品牌认知度"、"互动率"
time_period：活动时长或时间线
- 示例："2周"、"2024年第一季度"、"持续进行"、"3月启动"
creative_direction：创意的风格、语气或要求
- 示例："充满活力且鼓舞人心"、"专业可信"、"有趣活泼"
other_details：任何额外要求或背景信息
- 示例："必须包含客户证言"、"竞争对手：BrandX"、"季节性主题"

Step 2: Identify Missing Fields

步骤2：识别缺失字段

For each field:

If the information is explicitly stated or can be reasonably inferred, populate the field
If the information is not present or unclear, mark it as missing

针对每个字段：

如果信息明确说明或可合理推断，则填充该字段
如果信息未提及或不明确，则标记为缺失

Step 3: Return Structured Output

步骤3：返回结构化输出

Return a JSON object with this structure:

json

{
  "success": true/false,
  "parameters": {
    "product_or_service": "value or null",
    "product_or_service_url": "value or null",
    "campaign_name": "value or null",
    "target_audience": "value or null",
    "geography": "value or null",
    "ad_format": "value or null",
    "budget": "value or null",
    "platform": "value or null",
    "kpi": "value or null",
    "time_period": "value or null",
    "creative_direction": "value or null",
    "other_details": "value or null"
  },
  "missingFields": ["field1", "field2"],
  "suggestions": {
    "field1": "Consider specifying...",
    "field2": "You might want to include..."
  }
}

Set
```
success
```
to
```
true
```
only if ALL fields are populated (no missing fields)
Set
```
success
```
to
```
false
```
if any fields are missing
List all missing field names in the
```
missingFields
```
array
Optionally provide helpful suggestions for missing fields

返回如下结构的JSON对象：

json

{
  "success": true/false,
  "parameters": {
    "product_or_service": "value or null",
    "product_or_service_url": "value or null",
    "campaign_name": "value or null",
    "target_audience": "value or null",
    "geography": "value or null",
    "ad_format": "value or null",
    "budget": "value or null",
    "platform": "value or null",
    "kpi": "value or null",
    "time_period": "value or null",
    "creative_direction": "value or null",
    "other_details": "value or null"
  },
  "missingFields": ["field1", "field2"],
  "suggestions": {
    "field1": "Consider specifying...",
    "field2": "You might want to include..."
  }
}

仅当所有字段均已填充（无缺失字段）时，将
```
success
```
设为
```
true
```
若存在任何缺失字段，将
```
success
```
设为
```
false
```
在
```
missingFields
```
数组中列出所有缺失字段的名称
可选择性为缺失字段提供实用建议

Campaign Updates

活动更新

When updating an existing campaign (indicated by context mentioning a campaign ID):

Extract only the NEW information provided in the input
Set fields to their extracted values if new information is provided
Set fields to
```
null
```
if no new information is provided for that field
The system will automatically merge new values with existing campaign data
Only newly provided fields will overwrite existing values; null fields preserve existing data

当更新现有活动（上下文提及活动ID时）：

仅提取输入中提供的新信息
若提供了新信息，则将字段设为提取到的值
若未提供该字段的新信息，则设为
```
null
```
系统会自动将新值与现有活动数据合并
仅新提供的字段会覆盖现有值；null字段将保留现有数据

Extraction Rules

提取规则

Be Conservative: Only populate a field if the information is clearly stated or strongly implied
Use Null for Missing: If a field is not mentioned, set it to
```
null
```
rather than guessing
Preserve Original Phrasing: When extracting, use the advertiser's own words when possible
Infer Carefully: Some fields can be inferred (e.g., if they mention "TikTok video", ad_format is "video ad" and platform is "TikTok")
Handle Ambiguity: If information is ambiguous, mark the field as missing and suggest clarification

保持严谨：仅当信息明确说明或强烈暗示时，才填充字段
缺失值用Null：若字段未被提及，设为
```
null
```
而非猜测
保留原始表述：提取时尽可能使用广告主的原话
谨慎推断：部分字段可合理推断（例如，若提及"TikTok video"，则ad_format为"video ad"，platform为"TikTok"）
处理歧义：若信息存在歧义，标记该字段为缺失并建议澄清

Examples

示例

Example 1: Partially Complete Input

示例1：部分完整的输入

Input: "Create a TikTok video ad for my fitness app targeting Southeast Asian women aged 25-35 with a $5,000 budget. The goal is to drive app installs with an energetic and motivating tone."

Output:

json

{
  "success": false,
  "parameters": {
    "product_or_service": "fitness app",
    "product_or_service_url": null,
    "campaign_name": null,
    "target_audience": "Southeast Asian women aged 25-35",
    "geography": "Southeast Asia",
    "ad_format": "video ad",
    "budget": "$5,000",
    "platform": "TikTok",
    "kpi": "app installs",
    "time_period": null,
    "creative_direction": "energetic and motivating",
    "other_details": null
  },
  "missingFields": ["product_or_service_url", "campaign_name", "time_period"],
  "suggestions": {
    "product_or_service_url": "Please provide the landing page or app store URL for your fitness app",
    "campaign_name": "Consider providing a campaign name for tracking purposes (e.g., 'Q1 2024 Southeast Asia Launch')",
    "time_period": "When should this campaign run? Specify duration or dates (e.g., '2 weeks', 'March 1-15')"
  }
}

输入："为我的健身应用创建一个TikTok视频广告，定向东南亚25-35岁女性，预算$5,000。目标是提升应用安装量，创意风格要充满活力且鼓舞人心。"

输出:

json

{
  "success": false,
  "parameters": {
    "product_or_service": "fitness app",
    "product_or_service_url": null,
    "campaign_name": null,
    "target_audience": "Southeast Asian women aged 25-35",
    "geography": "Southeast Asia",
    "ad_format": "video ad",
    "budget": "$5,000",
    "platform": "TikTok",
    "kpi": "app installs",
    "time_period": null,
    "creative_direction": "energetic and motivating",
    "other_details": null
  },
  "missingFields": ["product_or_service_url", "campaign_name", "time_period"],
  "suggestions": {
    "product_or_service_url": "Please provide the landing page or app store URL for your fitness app",
    "campaign_name": "Consider providing a campaign name for tracking purposes (e.g., 'Q1 2024 Southeast Asia Launch')",
    "time_period": "When should this campaign run? Specify duration or dates (e.g., '2 weeks', 'March 1-15')"
  }
}

Example 2: Minimal Input

示例2：极简输入

Input: "I need ads for my coffee brand"

Output:

json

{
  "success": false,
  "parameters": {
    "product_or_service": "coffee brand",
    "product_or_service_url": null,
    "campaign_name": null,
    "target_audience": null,
    "geography": null,
    "ad_format": null,
    "budget": null,
    "platform": null,
    "kpi": null,
    "time_period": null,
    "creative_direction": null,
    "other_details": null
  },
  "missingFields": [
    "product_or_service_url",
    "campaign_name",
    "target_audience",
    "geography",
    "ad_format",
    "budget",
    "platform",
    "kpi",
    "time_period",
    "creative_direction"
  ],
  "suggestions": {
    "target_audience": "Who is your ideal customer? (e.g., coffee enthusiasts aged 25-45, young professionals)",
    "platform": "Where do you want to advertise? (e.g., Instagram, Facebook, Google, TikTok)",
    "budget": "What is your advertising budget? Please include currency",
    "geography": "Which geographic region should we target? (e.g., United States, Europe, specific cities)",
    "ad_format": "What type of ad creative? (e.g., video ad, static image, carousel)",
    "kpi": "What success metrics matter most? (e.g., brand awareness, website traffic, sales conversions)"
  }
}

输入："我需要为我的咖啡品牌投放广告"

输出:

json

{
  "success": false,
  "parameters": {
    "product_or_service": "coffee brand",
    "product_or_service_url": null,
    "campaign_name": null,
    "target_audience": null,
    "geography": null,
    "ad_format": null,
    "budget": null,
    "platform": null,
    "kpi": null,
    "time_period": null,
    "creative_direction": null,
    "other_details": null
  },
  "missingFields": [
    "product_or_service_url",
    "campaign_name",
    "target_audience",
    "geography",
    "ad_format",
    "budget",
    "platform",
    "kpi",
    "time_period",
    "creative_direction"
  ],
  "suggestions": {
    "target_audience": "Who is your ideal customer? (e.g., coffee enthusiasts aged 25-45, young professionals)",
    "platform": "Where do you want to advertise? (e.g., Instagram, Facebook, Google, TikTok)",
    "budget": "What is your advertising budget? Please include currency",
    "geography": "Which geographic region should we target? (e.g., United States, Europe, specific cities)",
    "ad_format": "What type of ad creative? (e.g., video ad, static image, carousel)",
    "kpi": "What success metrics matter most? (e.g., brand awareness, website traffic, sales conversions)"
  }
}

Example 3: Complete Input

示例3：完整输入

Input: "Run an Instagram carousel ad campaign called 'Spring Coffee Collection' for our organic coffee brand at www.organicbrew.com. Target coffee enthusiasts aged 25-45 in the United States with a $10,000 budget. Campaign runs for 3 weeks starting March 1st. Focus on conversions (online purchases). Use a warm and inviting tone that emphasizes sustainability. Include customer testimonials in the creative."

Output:

json

{
  "success": true,
  "parameters": {
    "product_or_service": "organic coffee brand",
    "product_or_service_url": "www.organicbrew.com",
    "campaign_name": "Spring Coffee Collection",
    "target_audience": "coffee enthusiasts aged 25-45",
    "geography": "United States",
    "ad_format": "carousel ad",
    "budget": "$10,000",
    "platform": "Instagram",
    "kpi": "conversions (online purchases)",
    "time_period": "3 weeks starting March 1st",
    "creative_direction": "warm and inviting tone that emphasizes sustainability",
    "other_details": "Include customer testimonials in the creative"
  },
  "missingFields": [],
  "suggestions": {}
}

输入："为我们的有机咖啡品牌（官网www.organicbrew.com）投放名为'春季咖啡系列'的Instagram轮播广告活动。定向美国25-45岁的咖啡爱好者，预算$10,000。活动从3月1日起持续3周，重点关注转化（在线购买）。采用温暖亲切的风格，强调可持续性，创意中需包含客户证言。"

输出:

json

{
  "success": true,
  "parameters": {
    "product_or_service": "organic coffee brand",
    "product_or_service_url": "www.organicbrew.com",
    "campaign_name": "Spring Coffee Collection",
    "target_audience": "coffee enthusiasts aged 25-45",
    "geography": "United States",
    "ad_format": "carousel ad",
    "budget": "$10,000",
    "platform": "Instagram",
    "kpi": "conversions (online purchases)",
    "time_period": "3 weeks starting March 1st",
    "creative_direction": "warm and inviting tone that emphasizes sustainability",
    "other_details": "Include customer testimonials in the creative"
  },
  "missingFields": [],
  "suggestions": {}
}

Important Notes

重要说明

Always return valid JSON
Ensure all 12 parameter fields are present in the output
The
```
success
```
field should reflect whether ALL required information is present
Be helpful and specific in suggestions
Maintain a professional, friendly tone when providing suggestions
When updating campaigns, only extract NEW information from the input
Null values in updates preserve existing campaign data (they don't delete it)

始终返回有效的JSON
确保输出中包含全部12个参数字段
```
success
```
字段应反映是否提供了所有必要信息
建议内容需实用且具体
提供建议时保持专业友好的语气
更新活动时，仅提取输入中的新信息
更新时的Null值将保留现有活动数据（不会删除数据）