plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6a798064b7108191af56a1cbc622e65c",
  "version": "1.0.3",
  "description": "Windsor.ai TikTok Ads connects your TikTok Ads data to your AI assistant, so you can analyze performance and manage campaigns in plain English. Discover connected ad accounts, inspect valid fields and options, and query campaign, ad group, and ad metrics (spend, impressions, clicks, CTR, CPC, and conversions) over any date range. On confirmation, it can also pause or enable campaigns, ad groups, and ads and set campaign and ad group budgets.\n\nCommon workflows:\n- Compare spend, clicks, and conversions by campaign for the last 30 days\n- Find an underperforming ad group and pause it, after you confirm\n- Adjust a campaign budget without leaving the conversation\n\nChanges to your account are made only after you confirm the specific action; everything else is read-only.\n\nWindsor.ai is an independent product and is not affiliated with or endorsed by the platforms it connects to.",
  "author": {
    "name": "Windsor.ai",
    "url": "https://windsor.ai"
  },
  "homepage": "https://windsor.ai",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Windsor.ai TikTok Ads",
        "shortDescription": "Analyze TikTok Ads",
        "longDescription": "Windsor.ai TikTok Ads connects your TikTok Ads data to your AI assistant, so you can analyze performance and manage campaigns in plain English. Discover connected ad accounts, inspect valid fields and options, and query campaign, ad group, and ad metrics (spend, impressions, clicks, CTR, CPC, and conversions) over any date range. On confirmation, it can also pause or enable campaigns, ad groups, and ads and set campaign and ad group budgets.\n\nCommon workflows:\n- Compare spend, clicks, and conversions by campaign for the last 30 days\n- Find an underperforming ad group and pause it, after you confirm\n- Adjust a campaign budget without leaving the conversation\n\nChanges to your account are made only after you confirm the specific action; everything else is read-only.\n\nWindsor.ai is an independent product and is not affiliated with or endorsed by the platforms it connects to.",
        "developerName": "Windsor.ai",
        "category": "Business & Operations",
        "websiteURL": "https://windsor.ai",
        "supportURL": "https://support.windsor.ai",
        "privacyPolicyURL": "https://windsor.ai/privacy-statement/",
        "termsOfServiceURL": "https://windsor.ai/terms-of-service/",
        "brandColor": "#0E2640",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png",
        "defaultPrompt": [
          "What was our TikTok Ads spend and ROAS by campaign for the last 30 days?",
          "Pause any TikTok ad groups with a ROAS below 1 this month.",
          "Increase the daily budget on my top TikTok campaign by 20%."
        ],
        "capabilities": [
          "Analyze TikTok Ads campaign, ad group and ad spend, impressions, clicks and conversions",
          "Compare TikTok Ads CTR, CPC and campaign performance across date ranges",
          "Find top and underperforming TikTok Ads campaigns, ad groups and ads",
          "Pause or enable TikTok Ads campaigns, ad groups and ads after confirmation",
          "Set TikTok Ads campaign and ad group budgets after confirmation",
          "Discover connected TikTok Ads accounts and available reporting fields"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover connected TikTok ad accounts.",
              "prompt": "Which TikTok ad accounts are connected to Windsor.ai?",
              "tools_triggered": "get_connectors",
              "expected_behavior": "Lists connected TikTok Ads accounts so the user can choose which one to analyze."
            },
            {
              "description": "Inspect valid TikTok Ads fields.",
              "prompt": "For my TikTok ad account, show the valid fields and options for a performance report.",
              "tools_triggered": "get_options, get_fields",
              "expected_behavior": "Returns usable field IDs and connector options for a TikTok Ads report."
            },
            {
              "description": "Query spend and ROAS by campaign.",
              "prompt": "How much did we spend on TikTok Ads last month, and what was our ROAS by campaign?",
              "tools_triggered": "get_fields, get_data",
              "expected_behavior": "Returns campaign-level spend and ROAS data and a concise analysis using valid TikTok Ads fields."
            },
            {
              "description": "Pause underperformers after confirmation.",
              "prompt": "Pause any TikTok campaigns with a ROAS below 1 this week.",
              "tools_triggered": "get_data, list_actions, execute_action",
              "expected_behavior": "Reads campaign ROAS, identifies the underperformers, and only runs the pause action after the user confirms."
            },
            {
              "description": "Help a user connect the TikTok Ads connector.",
              "prompt": "I have not connected TikTok Ads yet. Give me the setup link.",
              "tools_triggered": "get_connector_authorization_url",
              "expected_behavior": "Returns a Windsor.ai setup URL for connecting or authorizing the TikTok Ads connector."
            }
          ],
          "negative": [
            {
              "description": "Do not trigger for TikTok organic. Expected behavior: The app should not be invoked because organic TikTok analytics live in the TikTok Organic connector; this covers TikTok Ads only.",
              "prompt": "Show my TikTok follower growth and video views this month."
            },
            {
              "description": "Do not trigger for other ad platforms. Expected behavior: The app should not be invoked because it covers TikTok Ads, not Meta or other ad platforms.",
              "prompt": "Show my Meta Ads spend last week."
            },
            {
              "description": "Do not act without confirmation. Expected behavior: The app should not run a pause action without first confirming the specific change with the user.",
              "prompt": "Pause all my TikTok campaigns now."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Windsor.ai does not sell products, show plans, or process payments in the app.",
        "demo_recording_url": "https://youtu.be/nEajq7zCKKI"
      },
      "publication": {
        "release_notes": "Add dedicated discovery keywords for platform names, common aliases, ChatGPT connection intent and supported reporting workflows, informed by the video-pipeline keyword matrix. Existing listing descriptions, capability labels, skills and MCP behavior are retained."
      },
      "apps": "./.app.json"
    }
  },
  "keywords": [
    "tiktok ads",
    "tiktok advertising",
    "tiktok ads manager",
    "tiktok",
    "tiktok ads chatgpt",
    "tiktok ads report ai",
    "connect tiktok ads to chatgpt",
    "tiktok ads to chatgpt",
    "tiktok ads analytics",
    "tiktok ads mcp",
    "tiktok ads reporting",
    "tiktok campaign performance",
    "tiktok ad groups",
    "tiktok ad spend",
    "tiktok conversions",
    "tiktok cpa",
    "tiktok cost per acquisition",
    "tiktok roas",
    "tiktok return on ad spend",
    "tiktok campaign budgets",
    "windsor.ai",
    "windsor ai"
  ]
}