plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "windsor-ai-ga4",
  "version": "1.0.6",
  "description": "Bring your own Google Analytics 4 property data into your AI assistant with Windsor.ai, so you can explore website and app performance in plain English.\n\nReporting examples:\n- Analyze Google Analytics 4 (GA4) website and app traffic: users, sessions, engagement rate and conversions/key events.\n- Find which channels, source/medium combinations and landing pages bring users and key events.\n- Compare traffic and engagement across periods, devices and countries using available dimensions.\n\nDiscover connected properties, inspect valid dimensions and metrics, and query traffic, engagement, conversions, and channel performance (sessions, users, engagement rate, conversions, and default channel grouping) over any date range or by day, week, and month.\n\nCommon workflows:\n- See your top traffic sources and conversions last month\n- Compare sessions and engagement across two periods\n- Break down conversions by default channel group\n\nIt provides read-only analytics and does not run write actions, cover advertising cost data, or change any property settings.\n\nWindsor.ai is an independent product and is not affiliated with or endorsed by Google. Google Analytics is a trademark of Google LLC.",
  "author": {
    "name": "Windsor.ai",
    "url": "https://windsor.ai"
  },
  "homepage": "https://windsor.ai",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Windsor.ai Google Analytics 4",
        "shortDescription": "Analyze your GA4 data",
        "longDescription": "Bring your own Google Analytics 4 property data into your AI assistant with Windsor.ai, so you can explore website and app performance in plain English.\n\nReporting examples:\n- Analyze Google Analytics 4 (GA4) website and app traffic: users, sessions, engagement rate and conversions/key events.\n- Find which channels, source/medium combinations and landing pages bring users and key events.\n- Compare traffic and engagement across periods, devices and countries using available dimensions.\n\nDiscover connected properties, inspect valid dimensions and metrics, and query traffic, engagement, conversions, and channel performance (sessions, users, engagement rate, conversions, and default channel grouping) over any date range or by day, week, and month.\n\nCommon workflows:\n- See your top traffic sources and conversions last month\n- Compare sessions and engagement across two periods\n- Break down conversions by default channel group\n\nIt provides read-only analytics and does not run write actions, cover advertising cost data, or change any property settings.\n\nWindsor.ai is an independent product and is not affiliated with or endorsed by Google. Google Analytics is a trademark of Google LLC.",
        "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": [
          "Show my GA4 sessions, users, and conversions by default channel group for the last 30 days.",
          "How have my GA4 sessions and users trended month over month this year?",
          "What's my GA4 engagement rate by default channel group so far this quarter?"
        ],
        "capabilities": [
          "Analyze Google Analytics 4 (GA4) website and app sessions, users, engagement and conversions",
          "Compare GA4 traffic sources, channels and campaign performance",
          "Analyze GA4 landing pages, devices and countries using available dimensions",
          "Compare Google Analytics 4 performance across days, weeks, months and date ranges",
          "Discover connected GA4 properties and valid reporting dimensions and metrics"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover connected GA4 properties.",
              "prompt": "Which Google Analytics 4 properties are connected to Windsor.ai?",
              "tools_triggered": "get_connectors",
              "expected_behavior": "Lists connected GA4 properties so the user can choose which one to analyze."
            },
            {
              "description": "Inspect valid GA4 dimensions and metrics before querying.",
              "prompt": "For my GA4 property, show the valid dimensions and metrics for a traffic and conversions report.",
              "tools_triggered": "get_options, get_fields",
              "expected_behavior": "Returns usable dimension and metric IDs and connector options for a GA4 report."
            },
            {
              "description": "Query GA4 traffic and conversions for a recent period.",
              "prompt": "Show my GA4 sessions, users, and conversions by default channel group for the last 30 days.",
              "tools_triggered": "get_fields, get_data",
              "expected_behavior": "Returns channel-level GA4 data and a concise analysis using valid fields from the Google Analytics 4 connector."
            },
            {
              "description": "Analyze the top converting channel.",
              "prompt": "Which channel drove the most conversions in my GA4 property last month, by default channel group?",
              "tools_triggered": "get_fields, get_data",
              "expected_behavior": "Returns conversions by channel and identifies the single top channel using valid GA4 fields."
            },
            {
              "description": "Help a user connect the GA4 connector.",
              "prompt": "I have not connected GA4 yet. Give me the setup link for the Google Analytics 4 connector.",
              "tools_triggered": "get_connector_authorization_url",
              "expected_behavior": "Returns a Windsor.ai setup URL for connecting or authorizing the Google Analytics 4 connector."
            }
          ],
          "negative": [
            {
              "description": "Public benchmark data, not the user's property.",
              "prompt": "What is the average bounce rate for e-commerce websites this year?"
            },
            {
              "description": "Creative or content generation.",
              "prompt": "Write a landing page headline that will improve my conversion rate."
            },
            {
              "description": "General explanation unrelated to connected accounts.",
              "prompt": "Explain how attribution models in GA4 differ from Universal Analytics."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Windsor.ai does not sell products, show plans, or process payments in the app.",
        "demo_recording_url": "https://www.youtube.com/watch?v=PIteVZYyJFc"
      },
      "publication": {
        "release_notes": "Add explicit source-specific reporting metrics and natural-language use cases to both the root and listing descriptions. Preserve all prior description text, existing limitations, title, subtitle, capability labels, starter prompts, skills, MCP configuration and review materials."
      },
      "apps": "./.app.json"
    }
  }
}