plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "loopthink-google-analytics",
  "version": "0.1.0",
  "description": "Ask GA4 in plain language. Sessions, conversions and landing pages. Read-only, no API key.",
  "author": {
    "name": "Loopthink (TechnologyCircle GmbH)",
    "email": "info@technologycircle.io",
    "url": "https://www.loopthink.ai"
  },
  "homepage": "https://www.loopthink.ai/connect/google-analytics",
  "license": "MIT",
  "keywords": [
    "google-analytics",
    "ga4",
    "analytics",
    "web-analytics",
    "sessions",
    "users",
    "conversions",
    "landing-pages",
    "traffic-sources",
    "realtime",
    "read-only"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Google Analytics by Loopthink",
        "shortDescription": "Sessions, traffic, conversions",
        "longDescription": "Ask GA4 in plain language. Sessions, conversions and landing pages. Read-only, no API key.\n\nWhat you can ask:\n- How many sessions and users did we have last week, compared with the week before?\n- Which landing pages convert best?\n- Where does our traffic come from?\n- How many people are on the site right now?\n\nHow it works:\n1. Add the app and sign in with Google or Microsoft. Your Loopthink account is created on the spot.\n2. Connect Google Analytics with the Google account that has access to your GA4 properties, and pick the ones to share.\n3. Ask in ChatGPT. Nothing needs refreshing after you connect.\n\nRead-only:\n- The app never changes anything in Google Analytics.\n- Your Google sign-in stays in Loopthink and never passes through ChatGPT.\n\nBuilt for teams:\n- Every person signs in with their own account.\n- Access is granted per member group.\n- Every tool call is logged with who ran it.",
        "developerName": "Loopthink (TechnologyCircle GmbH)",
        "category": "Productivity",
        "capabilities": [
          "Show whether Google Analytics is connected and how to connect it",
          "List the GA4 properties you can query",
          "Report sessions, users, conversions and revenue by any GA4 dimension and date range",
          "Show realtime users on the site",
          "Look up the dimensions and metrics a property offers"
        ],
        "websiteURL": "https://www.loopthink.ai/connect/google-analytics",
        "supportURL": "https://www.loopthink.ai/support",
        "privacyPolicyURL": "https://www.loopthink.ai/privacy-policy",
        "termsOfServiceURL": "https://www.loopthink.ai/terms-and-conditions",
        "defaultPrompt": [
          "How many sessions did we have last week compared with the week before?",
          "Which landing pages bring the most conversions this month?",
          "Where does our traffic come from?"
        ],
        "brandColor": "#1B3A52",
        "brandColorDark": "#6FA8C9",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "See whether Google Analytics is connected",
              "prompt": "Is Google Analytics connected?",
              "tools_triggered": "connection_status",
              "expected_behavior": "Report Google Analytics 4 as connected and name the Loopthink server it belongs to, or give the connect link if it is not connected."
            },
            {
              "description": "Sessions per week",
              "prompt": "How many sessions and users did we have in the last 7 days?",
              "tools_triggered": "ga4_list_properties, ga4_report",
              "expected_behavior": "Call ga4_list_properties for the propertyId, then ga4_report with metrics sessions and totalUsers over the last 7 days, and return the totals."
            },
            {
              "description": "Traffic sources",
              "prompt": "Where did our traffic come from last month?",
              "tools_triggered": "ga4_list_properties, ga4_report",
              "expected_behavior": "Call ga4_report with the dimension sessionDefaultChannelGroup and the metric sessions for last month, and return one row per channel."
            },
            {
              "description": "Realtime",
              "prompt": "How many people are on the site right now?",
              "tools_triggered": "ga4_list_properties, ga4_realtime_report",
              "expected_behavior": "Call ga4_realtime_report with the metric activeUsers and return the number."
            },
            {
              "description": "Available dimensions and metrics",
              "prompt": "Which dimensions and metrics can I use for my GA4 property?",
              "tools_triggered": "ga4_list_properties, ga4_metadata",
              "expected_behavior": "Call ga4_metadata for the propertyId and list the available dimensions and metrics with their API names, including custom ones."
            }
          ],
          "negative": [
            {
              "description": "No changes in Google Analytics",
              "prompt": "Create a new conversion event called signup in my GA4 property."
            },
            {
              "description": "No data outside the connected properties",
              "prompt": "Show me the traffic of GA4 property 123456789."
            },
            {
              "description": "No user or settings changes",
              "prompt": "Give anna@example.com admin access to my GA4 property."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Loopthink does not sell products or process payments inside ChatGPT. Subscriptions are purchased on www.loopthink.ai."
      },
      "publication": {
        "release_notes": "First version: connection_status, ga4_list_properties, ga4_report, ga4_realtime_report and ga4_metadata. Read-only."
      },
      "apps": "./.app.json"
    }
  }
}