plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "d8a",
  "version": "1.0.0",
  "description": "Explore d8a website analytics and manage analytics settings with approval.",
  "author": {
    "name": "d8a",
    "email": "support@d8a.tech",
    "url": "https://d8a.tech/"
  },
  "homepage": "https://docs.d8a.tech/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "d8a.tech",
        "shortDescription": "Ask about your site analytics",
        "longDescription": "Ask about your website analytics and set up properties, goals and reports, with your approval for every change.\n\nConnect your d8a account to ChatGPT to see what changed after a release, which campaigns brought in traffic, and where visitors dropped off before converting.\n\nExplore your analytics:\n\u2022 Break down visits, sessions, users, and events by traffic source, campaign, or page.\n\u2022 Compare time periods and see how conversions changed.\n\u2022 Build conversion funnels, explore user journeys through your site, and rerun saved reports.\n\u2022 Get tracking snippets and installation guidance for your property, or audit your tracking setup.\n\nChatGPT uses the selected property's timezone, goals, and available metrics and dimensions when building queries. d8a calculates the results using your analytics data.\n\nWith write access, you can also:\n\u2022 Create properties and update settings such as timezones, session timeouts, IP masking, excluded URL parameters, and traffic filters.\n\u2022 Create and edit conversion goals and save table, funnel, and user journey reports.\n\u2022 Save business context for future analysis, such as what counts as a completed sign-up.\n\nYou sign in with your d8a account and choose Read only or, if your role allows it, Read and write. ChatGPT shows the proposed settings and any warnings before asking you to approve a change. Unapproved changes expire after 10 minutes. If someone edits the same settings before you approve, the change is refused. New traffic filters start in Test mode, which labels matching traffic without dropping it.\n\nMCP guide: https://docs.d8a.tech/articles/mcp",
        "developerName": "d8a",
        "category": "Data & Analytics",
        "websiteURL": "https://d8a.tech/",
        "supportURL": "https://d8a.tech/contact/",
        "privacyPolicyURL": "https://d8a.tech/privacy/",
        "termsOfServiceURL": "https://d8a.tech/terms/",
        "defaultPrompt": [
          "List the d8a analytics properties I can access.",
          "Compare sessions by traffic source last week versus the previous week.",
          "Show me how to install d8a tracking on my site."
        ],
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find accessible properties",
              "prompt": "List the d8a analytics properties I can access.",
              "tools_triggered": "list_properties",
              "expected_behavior": "List the demo properties available to the signed-in account."
            },
            {
              "description": "Compare weekly traffic",
              "prompt": "On the demo analytics property, compare sessions by traffic source for the last two complete weeks.",
              "tools_triggered": "get_property_context, get_query_catalog, run_query",
              "expected_behavior": "Report sessions by source for both periods using the property timezone and label the date ranges."
            },
            {
              "description": "Explore a conversion funnel",
              "prompt": "On the demo analytics property, show a funnel from the home page to pricing to completed sign-up.",
              "tools_triggered": "get_property_context, run_funnel",
              "expected_behavior": "Show counts and drop-off by step using the demo property's configured paths and sign-up event."
            },
            {
              "description": "Retrieve tracking instructions",
              "prompt": "How do I install d8a tracking for the demo analytics property?",
              "tools_triggered": "get_tracking_install, get_tracking_guide",
              "expected_behavior": "Return the property's installation instructions and tracking snippet."
            },
            {
              "description": "Create and verify a goal with approval",
              "prompt": "On the sandbox property, add a goal for visits to /thank-you. Show me the change before saving.",
              "tools_triggered": "get_property_edit_context, prepare_goal_change, execute_change, get_goal",
              "expected_behavior": "Preview the proposed goal. After explicit approval, save it and verify the saved rule. Use a fresh sandbox or reset the goal before rerunning."
            }
          ],
          "negative": [
            {
              "description": "Do not save an unapproved change",
              "prompt": "Preview a change to the sandbox session timeout to 45 minutes. Do not save it.",
              "expected_behavior": "Show the preview and leave the property unchanged. Do not call execute_change."
            },
            {
              "description": "Reject writes with read-only access",
              "prompt": "After connecting with Read only, ask: Set the sandbox session timeout to 45 minutes.",
              "expected_behavior": "Explain that write access is required and leave the settings unchanged."
            },
            {
              "description": "Reject requests for another account's data",
              "prompt": "Show me last week's traffic for a property in another customer's d8a account that I cannot access.",
              "expected_behavior": "Explain the access limit and offer to list accessible properties. Do not return or invent another customer's data."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial d8a.tech plugin for website analytics, tracking guidance, and approved property changes."
      },
      "apps": "./.app.json"
    }
  }
}