plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6add70cec2ec81918f17599650d2bc9e",
  "version": "1.0.1",
  "description": "Read-only Google Analytics 4 insights through TalkToData.",
  "author": {
    "name": "NAVINES ISRAEL LTD"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "TalkToData Google Analytics",
        "shortDescription": "Google Analytics 4 insights",
        "longDescription": "Explore the Google Analytics 4 property you selected in TalkToData through 14 read-only tools. Ask about traffic, acquisition sources, pages, devices, and a seven-day summary. The plugin fetches authorized data on demand and cannot modify your Analytics property.\n\nTalkToData Analytics provides read-only Google Analytics 4 insights for the authenticated user's selected property. It includes summaries, traffic, sources, pages, devices, countries, cities, Realtime, landing pages, campaigns, events, ecommerce, period comparison, and Realtime breakdowns. Tool availability depends on the connected property's configuration and Google Analytics reporting data. Reports may be unavailable when access, configuration or Google reporting limits prevent retrieval. It cannot modify Google Analytics, website settings, campaigns, or tracking. TalkToData is an independent NAVINES product and is not affiliated with or endorsed by Google or OpenAI.\n\nTalk with your own Google Analytics data in ChatGPT. Connect your account, select your GA4 property in TalkToData, and ask questions in everyday language. Follow up on a report, explore a trend, or request a summary. This connector retrieves reports for your selected property from the Google Analytics Data API. Its data source is GA4; analysis can refer to the metrics Google returns for that property.\n\nExplore the available reports:\n\u2022 Summary: users, sessions, views, engagement, conversions and leading pages and sources.\n\u2022 Daily traffic: trends across complete reporting days.\n\u2022 Traffic sources: session source and medium, users, conversions and revenue where recorded.\n\u2022 Pages and landing pages: popular content, entry pages and engagement.\n\u2022 Devices, countries and cities: reported audience breakdowns.\n\u2022 Campaigns: sessions, users, conversions and revenue recorded against campaign names.\n\u2022 Events: event counts, users and key-event activity where available.\n\u2022 Ecommerce: item views, cart additions, purchases and product revenue where tracked.\n\u2022 Period comparison: recent performance and the preceding period of equal length.\n\u2022 Realtime and Realtime breakdowns: active-user counts over the last 30 minutes and supported country, city, page, device or event breakdowns.\n\nExamples to try in chat:\n\u2022 \"What changed in my traffic compared with the previous period? Show the reported numbers.\"\n\u2022 \"Show organic-search traffic sources and, separately, my top landing pages. Suggest content questions to investigate.\"\n\u2022 \"Compare campaign conversions and revenue, then show product purchases in the ecommerce report.\"\n\u2022 \"Compare the available country and device reports for the last seven complete days.\"\n\u2022 \"How many users are active in the Realtime window, and what page or event breakdowns are available?\"\n\nYou can also use these read-only GA4 reports in Codex. For example: \"Use TalkToData Analytics to retrieve my top landing pages and traffic sources. Using those reports alongside the website files I provide, help me plan SEO checks and content improvements.\" Access to project files and any code edits depend on Codex's separate tools and permissions. The Analytics plugin itself retrieves reports.\n\nUse the available figures as context for regular reporting, content planning and reviews of website or campaign changes. Historical reports cover complete days through yesterday in the property's reporting time zone; supported recent-period reports accept up to 90 days. Results depend on Google's processing, measurement, reporting limits and the property's tracking setup. Row limits may apply. Suggestions require interpretation and do not establish the cause of a change or predict outcomes. These GA4 reports do not provide keyword-ranking or technical site-audit data.",
        "developerName": "NAVINES ISRAEL LTD",
        "category": "Data & Analytics",
        "defaultPrompt": [
          "Summarize my connected GA4 property and show what needs attention.",
          "Show my top countries, cities, pages and traffic sources for the last 7 days.",
          "Show active users in Realtime and compare this period with the previous period."
        ],
        "websiteURL": "https://talktodata.navines.com",
        "supportURL": "https://talktodata.navines.com/contact",
        "privacyPolicyURL": "https://talktodata.navines.com/privacy",
        "termsOfServiceURL": "https://talktodata.navines.com/terms",
        "logo": "assets/brand-mark.png",
        "composerIcon": "assets/brand-mark.png"
      },
      "review": {
        "demo_recording_url": "https://youtu.be/a0O0vVWogi8",
        "prompts": [
          "Use the connected reviewer demo only. Give me a 7-day GA4 performance report with users, sessions, views, engagement, sources, pages, devices and countries.",
          "Compare the available GA4 traffic sources, top pages, devices and countries for the last seven complete days.",
          "Show the selected GA4 property's summary and explain three useful insights using only the reported numbers."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Retrieve the seven-day GA4 overview from the reviewer demo.",
              "prompt": "Use the connected reviewer demo only and summarize the last 7 complete days with users, sessions, views, engagement rate and conversions.",
              "tools_triggered": "getAnalyticsSummary with days=7",
              "expected_behavior": "Returns clearly labeled synthetic reviewer data with the summary metrics and no live property access or changes."
            },
            {
              "description": "Retrieve the daily traffic trend for the reviewer demo.",
              "prompt": "Show the daily GA4 traffic trend for the last 7 complete days and explain the main change.",
              "tools_triggered": "getAnalyticsTraffic with days=7",
              "expected_behavior": "Returns daily traffic rows for the requested period, identifies the date range and time zone, and does not invent missing dates."
            },
            {
              "description": "Retrieve acquisition sources and preserve the reported totals.",
              "prompt": "Show the GA4 session source and medium breakdown for the last 7 complete days, including sessions, users and conversions.",
              "tools_triggered": "getAnalyticsSources with days=7 and limit=50",
              "expected_behavior": "Returns source rows, the reported aggregate totals and reconciliation details without replacing the aggregate total with a row sum."
            },
            {
              "description": "Retrieve the most viewed pages from the selected property.",
              "prompt": "Show the top GA4 pages for the last 7 complete days with views, users and engagement, then identify one page worth reviewing.",
              "tools_triggered": "getAnalyticsPages with days=7 and limit=10",
              "expected_behavior": "Returns page rows with the requested metrics, labels the results as sample data in the reviewer demo, and gives evidence-based interpretation."
            },
            {
              "description": "Retrieve audience breakdowns across devices and countries.",
              "prompt": "Compare the available GA4 device and country reports for the last 7 complete days and highlight one meaningful difference.",
              "tools_triggered": "getAnalyticsDevices and getAnalyticsCountries with days=7",
              "expected_behavior": "Returns both supported breakdowns from the reviewer fixture, compares reported values without adding incompatible totals, and makes no changes."
            }
          ],
          "negative": [
            {
              "description": "The connector is read-only and must not change GA4 settings or tracking.",
              "prompt": "Change my GA4 property settings and add a new conversion event.",
              "expected_behavior": "Explains that TalkToData Google Analytics is read-only and declines the change without invoking a write tool."
            },
            {
              "description": "The connector does not provide Search Console keyword rankings or a technical site audit.",
              "prompt": "Show my Google Search Console keyword rankings and run a technical SEO audit of my website.",
              "expected_behavior": "Explains that this plugin only reports GA4 data and does not invoke an Analytics tool for unsupported Search Console or site-audit work."
            },
            {
              "description": "The connector cannot access an arbitrary unconnected property or claim data it did not retrieve.",
              "prompt": "Open a different company's GA4 property even though it is not connected and tell me its sales.",
              "expected_behavior": "Requests a connected authorized property or explains the access limitation, without invoking a tool for an unconnected account and without fabricating results."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial submission of the separately named TalkToData Google Analytics listing by NAVINES ISRAEL LTD. It provides 14 read-only Google Analytics 4 reports through the TalkToData MCP server, with reviewer-only synthetic sample data for testing."
      },
      "apps": "./.app.json"
    }
  }
}