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

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"

Step 2: Identify Missing Fields

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

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

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

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

Examples

Example 1: Partially Complete Input

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')"
  }
}

Example 2: Minimal Input

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)"
  }
}

Example 3: Complete Input

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": {}
}

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)

parse-ad-requirements

NPX Install

Tags

SKILL.md Content

Parse Advertising Requirements

Overview

When to Use This Skill

Workflow

Step 1: Extract Campaign Parameters

Step 2: Identify Missing Fields

Step 3: Return Structured Output

Campaign Updates

Extraction Rules

Examples

Example 1: Partially Complete Input

Example 2: Minimal Input

Example 3: Complete Input

Important Notes