Parse Advertising Requirements

Analyze the input text and extract the following 12 fields:

1. product_or_service: The product, service, or brand being advertised

   • Examples: "fitness app", "organic coffee brand", "SaaS platform"

2. product_or_service_url: Website or landing page URL for the product/service

   • Examples: "https://myfitnessapp.com", "www.coffeebrand.com"

3. campaign_name: A descriptive name for this campaign

   • Examples: "Summer Fitness Launch", "Q4 Brand Awareness"

4. target_audience: Demographics, interests, or characteristics of the target audience

   • Examples: "women aged 25-35", "tech-savvy millennials", "small business owners"

5. geography: Geographic targeting for the campaign

   • Examples: "Southeast Asia", "United States", "Global", "New York City"

6. ad_format: Type of ad creative needed

   • Examples: "video ad", "carousel ad", "static image", "story ad"

7. budget: Campaign budget amount and currency

   • Examples: "$5,000", "€10,000", "5000 USD"

8. platform: Advertising platform(s) to use

   • Examples: "TikTok", "Facebook", "Instagram", "Google Ads", "LinkedIn"

9. kpi: Key performance indicators or success metrics

   • Examples: "CTR", "app installs", "conversions", "brand awareness", "engagement rate"

10. time_period: Campaign duration or timeline

    • Examples: "2 weeks", "Q1 2024", "ongoing", "launch in March"

11. creative_direction: Style, tone, or creative requirements

    • Examples: "energetic and motivating", "professional and trustworthy", "fun and playful"

12. 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:

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

1. Be Conservative: Only populate a field if the information is clearly stated or strongly implied
2. Use Null for Missing: If a field is not mentioned, set it to null rather than guessing
3. Preserve Original Phrasing: When extracting, use the advertiser's own words when possible
4. Infer Carefully: Some fields can be inferred (e.g., if they mention "TikTok video", ad_format is "video ad" and platform is "TikTok")
5. 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:

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

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

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