.codex-plugin/plugin.json

{
  "author": {
    "name": "Adzviser LLC"
  },
  "description": "Connect your Google Analytics 4 data to ChatGPT with Adzviser. Ask questions in plain language to understand how people find your site and what they do once they arrive.\n\nCompare active users, new users, sessions, engagement, and conversions across date ranges. Break results down by channel, session source and medium, landing page, device, or country. Turn your analytics into clear reports, spot traffic trends, and see which sources actually convert.",
  "interface": {
    "capabilities": [],
    "category": "Data & Analytics",
    "defaultPrompt": [
      "How many active users did my site get last week?",
      "Generate a monthly Google Analytics traffic report covering the last 30 days",
      "Break down my website sessions by channel for the last 14 days"
    ],
    "developerName": "Adzviser LLC",
    "displayName": "Adzviser Google Analytics",
    "longDescription": "Connect your Google Analytics 4 data to ChatGPT with Adzviser. Ask questions in plain language to understand how people find your site and what they do once they arrive.\n\nCompare active users, new users, sessions, engagement, and conversions across date ranges. Break results down by channel, session source and medium, landing page, device, or country. Turn your analytics into clear reports, spot traffic trends, and see which sources actually convert.",
    "privacyPolicyURL": "https://docs.adzviser.com/privacy",
    "shortDescription": "Talk to your GA4 data",
    "supportURL": "https://adzviser.com/contact-us",
    "termsOfServiceURL": "https://docs.adzviser.com/terms",
    "websiteURL": "https://adzviser.com",
    "logo": "./assets/adzviser-directory-light.png",
    "composerIcon": "./assets/adzviser-directory-light.png"
  },
  "name": "app-6aa0683f119c8191b279c9cc3ca2496e",
  "skills": "./skills",
  "version": "1.0.0",
  "extensions": {
    "com.openai": {
      "publication": {
        "countries": [],
        "release_notes": "Explore your website traffic with Google Analytics 4. Check active users and sessions, compare monthly traffic, and review channels, devices and daily trends."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Google Analytics connection. Resolve relative dates from the date of review. Check an ungrouped active-user count for the previous complete week without confusing it with sessions or rolling metrics.",
              "prompt": "How many active users did we have in GA4 last week in Demo?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_ga4, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact GA4 fields, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.ga4_request. Do not invoke a preview widget or set_reporting_mode. Base the response on every returned GA4 table row and relevant assumptions. Request metrics=[Active users], no breakdowns and no time_granularity, with the previous complete Monday-Sunday week as one inclusive date range unless the user specified another convention. State the actual dates and returned Active users count. Do not substitute Total users, Sessions or 7-day active users, or sum daily counts into a distinct weekly total. Report an empty result honestly rather than inventing zero."
            },
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Google Analytics connection. Resolve relative dates from the date of review. Check session acquisition using the session-scoped channel dimension. A grouped report need not reconcile exactly to a separate ungrouped query; do not fabricate equality.",
              "prompt": "Break down our GA4 sessions by channel last month in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_ga4, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact GA4 fields, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.ga4_request. Do not invoke a preview widget or set_reporting_mode. Base the response on every returned GA4 table row and relevant assumptions. Request metrics=[Sessions], breakdowns=[Session default channel group], the previous complete calendar month, and no time_granularity. Show each returned channel and its session count, retaining Unassigned, (not set) or other actual groups. Do not substitute first-user or conversion-attributed channel dimensions. If displaying the sum of the rows, label it as the returned channel-row total. If an ungrouped total is also available and differs, disclose the difference without changing numbers, inventing a balancing group or asserting a cause without evidence."
            },
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Google Analytics connection. Resolve relative dates from the date of review. Check a device breakdown of active users while preserving the meaning of user counts and missing groups.",
              "prompt": "Show our GA4 active users by device last week in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_ga4, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact GA4 fields, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.ga4_request. Do not invoke a preview widget or set_reporting_mode. Base the response on every returned GA4 table row and relevant assumptions. Request metrics=[Active users], breakdowns=[Device category], the previous complete Monday-Sunday week unless otherwise specified, and no time_granularity. Report the actual device categories and counts. Do not add a zero tablet row unless returned. Do not label the sum of device counts as a deduplicated overall active-user total or infer individual visitor identities."
            },
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Google Analytics connection. Resolve relative dates from the date of review. Check two complete calendar months in one request and calculate the change in sessions.",
              "prompt": "Compare our GA4 sessions last month with the month before in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_ga4, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact GA4 fields, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.ga4_request. Do not invoke a preview widget or set_reporting_mode. Base the response on every returned GA4 table row and relevant assumptions. Request metrics=[Sessions], no breakdowns or time_granularity, and two separate inclusive date_ranges for the previous complete calendar month and the month before it. State both periods and counts. Calculate recent minus earlier and (recent minus earlier)/earlier*100. If the earlier value is zero, mark percentage change unavailable. Do not substitute user counts or silently replace an ungrouped total with a sum from a different report."
            },
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Google Analytics connection. Resolve relative dates from the date of review. Check daily sessions and chronological ordering over the previous complete week.",
              "prompt": "Show our daily GA4 sessions last week in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_ga4, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact GA4 fields, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.ga4_request. Do not invoke a preview widget or set_reporting_mode. Base the response on every returned GA4 table row and relevant assumptions. Request metrics=[Sessions], no breakdowns, time_granularity=Date, and the inclusive previous complete Monday-Sunday week unless otherwise specified. Sort returned dates chronologically and show each date and Sessions. Any displayed sum must equal the returned daily rows; label it accordingly. Do not add Date to breakdowns, confuse metric-sorted rows with date order, invent missing days as zero, or call the session total a distinct-user count."
            }
          ],
          "negative": [
            {
              "description": "Changing GA4 property or event configuration is unsupported. Explain that this plugin retrieves reports and cannot mark events as key events. Do not invoke reporting, preview or preference tools to simulate an edit or claim that configuration changed.",
              "prompt": "Mark sign_up as a key event in the GA4 property connected to Demo."
            },
            {
              "description": "Deleting collected analytics data is unsupported. Explain that the plugin cannot perform data deletion. Do not invoke reporting tools as a substitute or claim records were removed.",
              "prompt": "Delete all last month's collected GA4 data from the property in Demo."
            },
            {
              "description": "Individual visitor identification is unsupported. Explain that the connector provides aggregate analytics, not visitors' real names, email addresses or physical addresses. Do not call tools, invent personal records, or treat geographic aggregates as individual identities.",
              "prompt": "Give me the real names, email addresses and home addresses of everyone who visited our site last week in Demo."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/QJIMoHtAnRE",
        "commerce": false,
        "commerce_description": "Adzviser subscriptions are purchased separately on the Adzviser website. This plugin provides analytics reporting and does not offer in-plugin purchases or checkout."
      }
    }
  },
  "mcpServers": "./.mcp.json",
  "apps": "./.app.json"
}