Update to Google Analytics | LoomaScale

Changed files

Choose a file to see its text changes. Binary or large files show metadata only.

.codex-plugin/plugin.json →

skills/ga4-insights/SKILL.md →

skills/ga4-insights/references/analysis-guide.md →

skills/loomascale-ga4/SKILL.md →

.codex-plugin/plugin.json

− removed · + added

--- before
+++ after
@@ -2,7 +2,7 @@
   "author": {
     "name": "LoomaScale"
   },
-  "description": "Analyze Google Analytics 4 (GA4) data in ChatGPT with LoomaScale. Compare website traffic, landing pages, key events, revenue and funnel drop-offs, investigate conversion attribution, and check realtime activity using read-only access to your connected Analytics properties.",
+  "description": "Analyze your Google Analytics 4 (GA4) data in ChatGPT with LoomaScale. Understand website traffic, compare traffic sources and popular pages, and report conversions, revenue, funnels and realtime activity. Reporting is read-only; supported settings changes require configuration-preview access and your approval.",
   "keywords": [
     "google analytics 4",
     "google analytics",
@@ -19,11 +19,14 @@
     "funnel drop-off",
     "ecommerce analytics",
     "revenue analysis",
-    "realtime analytics"
+    "realtime analytics",
+    "google analytics reports",
+    "website traffic",
+    "popular pages"
   ],
   "interface": {
     "displayName": "Google Analytics | LoomaScale",
-    "shortDescription": "Audit GA4 traffic & funnels",
+    "shortDescription": "Analyze Google Analytics data",
     "developerName": "LoomaScale",
     "composerIcon": "./assets/web-app-manifest-385x385.png",
     "logo": "./assets/web-app-manifest-385x385.png",
@@ -35,15 +38,16 @@
       "Ordered event funnels, completion rates and drop-offs by device",
       "Realtime activity and event reports for the last 30 minutes",
       "Conversion attribution, ad cost and ROAS reporting where available in GA4",
-      "Property time zone, currency, custom dimensions, custom metrics, annotations and Google Ads link inspection"
+      "Property time zone, currency, custom dimensions, custom metrics, annotations and Google Ads link inspection",
+      "Supported Analytics settings changes for eligible configuration-preview accounts, with user approval"
     ],
     "category": "Business & Operations",
     "defaultPrompt": [
-      "Compare my Google Analytics 4 traffic over the last 30 complete days with the previous 30. Which sources explain the change?",
-      "Use my GA4 data to compare key events and revenue by source/medium. Explain the attribution and data limitations.",
-      "Show my Google Analytics 4 funnel from add_to_cart to purchase, broken down by device, and identify the largest drop-offs."
+      "Show my Google Analytics website traffic and most popular pages for the last seven complete days.",
+      "Compare my GA4 traffic sources, key events and revenue for the last 30 complete days with the previous 30.",
+      "Show my Google Analytics 4 funnel from add_to_cart to purchase by device. Where do users drop off?"
     ],
-    "longDescription": "Google Analytics 4 (GA4) in ChatGPT, by LoomaScale. Analyze your connected Analytics properties to understand website traffic, engagement, landing pages, key events and ecommerce revenue. Compare periods, investigate funnel drop-offs and review conversion attribution with read-only Google Analytics access. Built for marketers, agencies, ecommerce teams and business owners who want answers grounded in their own GA4 data.\n\nWhat can I analyze in Google Analytics 4?\nReport users, sessions, engaged sessions, engagement rate, events, key events and revenue. Break results down by traffic source/medium, channel, landing page, device or country using compatible GA4 dimensions and metrics. Identify which segments contribute to a change and get practical next steps.\n\nWhy did my website traffic or conversions change?\nCompare explicit date ranges and find the sources, pages or devices contributing most to a rise or decline. Read property annotations for context and custom definitions for property-specific reporting. Separate observed changes from possible causes; reports alone do not prove causation.\n\nWhere are users dropping out of my funnel?\nBuild an ordered event funnel, such as add_to_cart followed by purchase, and examine step completion and abandonment. Break down the funnel by device to find where to investigate first. Funnel analysis uses events your property already collects; it does not install tracking.\n\nCan I check realtime activity?\nReport activity during GA4's last-30-minute realtime window, such as active users by country or incoming events by event name. This is an aggregate report, not a visitor list or a continuously updating monitor.\n\nCan I analyze conversion attribution and ROAS?\nUse GA4 conversion reports for attributed conversions, ad cost and return on ad spend where the property has the required data. Inspect existing Google Ads links. Results reflect GA4's attribution definitions and should not be treated as interchangeable with advertising-platform conversions. This plugin does not retrieve Google Ads campaign performance or change ads.\n\nHow do I connect Google Analytics 4?\nSign in to LoomaScale, connect Google Analytics through Google authorization, and choose a GA4 property your Google login can access. Then ask a reporting question in ChatGPT. Analytics access uses Google's read-only permission. Reports depend on property permissions, collected events and available API data. Funnel and conversion reports use Google's alpha APIs; thresholds, sampling and processing delays can limit results.\n\nCan this plugin change Analytics settings or tracking?\nNo. It cannot edit Analytics properties, create events or key events, install tags, publish Tag Manager changes or manage ad campaigns. It supports GA4 properties, not Universal Analytics. Supporting LoomaScale tools can check your usage allowance or send a feature request when you ask.\n\nLoomaScale is an independent product and is not affiliated with or endorsed by Google.",
+    "longDescription": "LoomaScale connects Google Analytics 4 (GA4) to ChatGPT so you can understand your website traffic in plain language. Compare traffic sources, find popular pages, track conversions and ecommerce revenue, and identify funnel drop-offs using your connected Analytics data. Built for marketers, agencies, ecommerce teams and business owners. Reports are read-only.\n\nWhat can I analyze in Google Analytics 4?\nReport website traffic, popular pages, users, sessions, engaged sessions, engagement rate, events, key events and revenue. Break results down by traffic source/medium, channel, landing page, device or country using compatible GA4 dimensions and metrics. Identify which segments contribute to a change and get practical next steps.\n\nWhy did my website traffic or conversions change?\nCompare explicit date ranges and find the sources, pages or devices contributing most to a rise or decline. Read property annotations for context and custom definitions for property-specific reporting. Separate observed changes from possible causes; reports alone do not prove causation.\n\nWhere are users dropping out of my funnel?\nBuild an ordered event funnel, such as add_to_cart followed by purchase, and examine step completion and abandonment. Break down the funnel by device to find where to investigate first. Funnel analysis uses events your property already collects; it does not install tracking.\n\nCan I check realtime activity?\nReport activity during GA4's last-30-minute realtime window, such as active users by country or incoming events by event name. This is an aggregate report, not a visitor list or a continuously updating monitor.\n\nCan I analyze conversion attribution and ROAS?\nUse GA4 conversion reports for attributed conversions, ad cost and return on ad spend where the property has the required data. Inspect existing Google Ads links. Results reflect GA4's attribution definitions and should not be treated as interchangeable with advertising-platform conversions. This plugin does not retrieve Google Ads campaign performance or change ads.\n\nHow do I connect Google Analytics 4?\nSign in to LoomaScale, connect Google Analytics through Google authorization, and choose a GA4 property your Google login can access. Then ask a reporting question in ChatGPT. Reporting uses Google's read-only permission; eligible configuration-preview accounts also need edit permission for supported settings changes. Reports depend on property permissions, collected events and available API data. Funnel and conversion reports use Google's alpha APIs; thresholds, sampling and processing delays can limit results.\n\nCan this plugin change Analytics settings or tracking?\nReports do not change settings. Eligible configuration-preview accounts can manage key events, event create and edit rules, enhanced measurement and data redaction, and create or update web streams, only after you approve the exact changes. Event rules affect future collected events. It cannot install tags, publish Tag Manager changes, manage ads or delete properties or streams. It supports GA4, not Universal Analytics. Helper tools check your usage allowance or send a feature request when you ask.\n\nLoomaScale is an independent product and is not affiliated with or endorsed by Google.",
     "privacyPolicyURL": "https://loomascale.com/privacy",
     "supportURL": "https://loomascale.com/contact",
     "termsOfServiceURL": "https://loomascale.com/terms",
@@ -52,7 +56,7 @@
   "mcpServers": "./.mcp.json",
   "name": "loomascale-ga4",
   "skills": "./skills/",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "extensions": {
     "com.openai": {
       "review": {
@@ -96,9 +100,9 @@
               "expected_behavior": "Do not invoke this plugin or any of its tools. Explain that creating or enabling Google Ads campaigns requires an advertising integration; this GA4 integration cannot perform the requested action."
             },
             {
-              "description": "Analytics configuration and tracking writes are unsupported.",
-              "prompt": "Create a purchase event in my Google Analytics 4 property and mark it as a key event.",
-              "expected_behavior": "Do not invoke this plugin or any of its tools. Explain that this integration has read-only Google Analytics access and cannot create events or mark key events. Do not claim that a configuration change was made."
+              "description": "Website tag installation and Tag Manager publishing are outside this integration.",
+              "prompt": "Install the Google Analytics tracking tag on my website and publish it through Google Tag Manager.",
+              "expected_behavior": "Do not invoke this plugin or any of its tools. Explain that it cannot install website tags or publish Tag Manager changes. Configuration-preview access does not provide website or Tag Manager access."
             },
             {
               "description": "A general analytics definition requires no connected property data.",