plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "detrics",
  "version": "1.0.0",
  "description": "Query marketing and e-commerce data from 30+ advertising, analytics, CRM and commerce platforms directly through ChatGPT.",
  "author": {
    "name": "Detrics",
    "email": "support@detrics.io",
    "url": "https://detrics.io"
  },
  "homepage": "https://detrics.io",
  "keywords": [
    "marketing",
    "analytics",
    "ads",
    "meta-ads",
    "google-ads",
    "ga4",
    "shopify",
    "reporting",
    "data-warehouse"
  ],
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "interface": {
        "displayName": "Detrics",
        "shortDescription": "Your own marketing data team",
        "longDescription": "Query marketing and e-commerce data from 30+ advertising, analytics, CRM and commerce platforms directly through ChatGPT. Supported sources include Meta Ads, Google Ads, Google Analytics 4, Google Search Console, TikTok Ads, LinkedIn Ads, Pinterest Ads, Microsoft Ads, Shopify, WooCommerce, TiendaNube, VTEX, Mercado Libre, HubSpot, Klaviyo and Stripe. Ask questions in natural language; Detrics runs the query against your connected accounts and returns tables that ChatGPT can compare and summarize. Field names are normalized across platforms. AI Contexts let you save a group of accounts and reuse it in prompts. Data warehouse tools let you create and manage transfers into your own BigQuery project. Sign-in uses OAuth.\n\nExample use cases:\n- Cross-platform performance review: \"Compare my Facebook Ads vs Google Ads spend, ROAS, and CPA for the last 30 days\".\n- TiendaNube store analytics: \"Show me my TiendaNube orders and revenue by product category for the last 2 weeks\".\n- VTEX commerce insights: \"What are my top-selling VTEX products by revenue this month?\".\n- Campaign optimization: \"Which Google Ads campaigns have CPA above $50? Sort by spend descending\".\n- AI Context workflow: \"List my contexts, then query the Client A context for top traffic sources\".\n- BigQuery warehouse: \"Set up a daily transfer of my Meta Ads campaigns and Shopify orders into my BigQuery marketing dataset\".\n\nRequirements: a Detrics account (app.detrics.io) with at least one platform connected through the Detrics web app. Detrics reads data from the accounts connected to your workspace; the marketing and e-commerce platform tools are read-only. The warehouse tools can create, change and delete Detrics transfer and table definitions in your BigQuery project; those actions ask for confirmation.",
        "developerName": "Detrics",
        "category": "Data & Analytics",
        "capabilities": [
          "Query spend, clicks, conversions, ROAS and CPA across Meta, Google, TikTok, LinkedIn, Pinterest, X and Microsoft Ads",
          "Pull Google Analytics 4, Search Console and YouTube analytics for your properties",
          "Report Shopify, WooCommerce, TiendaNube, VTEX and Mercado Libre sales and products",
          "Read Klaviyo, HubSpot, Salesforce and Stripe metrics",
          "Compare platforms side by side with normalized fields",
          "Discover which metrics and dimensions each platform supports",
          "Use saved AI Contexts to query pre-configured groups of accounts",
          "Create and manage BigQuery marketing data warehouse transfers"
        ],
        "websiteURL": "https://detrics.io",
        "supportURL": "https://support.detrics.io",
        "privacyPolicyURL": "https://detrics.io/privacy-policy",
        "termsOfServiceURL": "https://detrics.io/terms-of-service",
        "defaultPrompt": [
          "Which marketing platforms do I have connected in Detrics?",
          "Show GA4 sessions by day for the last 30 days",
          "Compare my Facebook Ads vs Google Ads spend and ROAS for last month"
        ],
        "brandColor": "#2B6FF9",
        "brandColorDark": "#93C5FD",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "User wants to see which platforms and accounts are connected to their Detrics workspace.",
              "prompt": "Which marketing platforms do I have connected in Detrics?",
              "tools_triggered": "list_connections",
              "expected_behavior": "ChatGPT calls list_connections and summarizes the connected platforms (Google Analytics 4 and Google Search Console on the reviewer account) with account names and status. No data query is run."
            },
            {
              "description": "User asks for a time series from a connected Google Analytics 4 property.",
              "prompt": "Show me GA4 sessions and users by day for the last 30 days.",
              "tools_triggered": "list_connections, query_marketing_data",
              "expected_behavior": "ChatGPT identifies the GA4 connection (calling list_connections if needed), then calls query_marketing_data with platform_api google-analytics-4, the property id, metrics sessions and totalUsers, the date dimension and a last_30_days timeframe. It returns a daily table and totals."
            },
            {
              "description": "User asks for a ranked Search Console report with sorting and a row limit.",
              "prompt": "What are my top 10 Google Search Console queries by clicks in the last 28 days?",
              "tools_triggered": "list_connections, query_marketing_data",
              "expected_behavior": "ChatGPT calls query_marketing_data for google-search-console with the query dimension, clicks and impressions as metrics, the last 28 days timeframe, sorted by clicks descending with a limit of 10, and returns a 10 row table."
            },
            {
              "description": "User wants to discover what can be queried for a platform before asking for data.",
              "prompt": "What metrics and dimensions can I query from Google Analytics 4 in Detrics?",
              "tools_triggered": "list_fields",
              "expected_behavior": "ChatGPT calls list_fields with platform_api google-analytics-4 and summarizes the available metrics (sessions, users, conversions, revenue, etc.) and dimensions (date, channel, landing page, country, etc.), grouped by category."
            },
            {
              "description": "User uses a saved AI Context to run a cross-platform query without naming accounts.",
              "prompt": "Use the Detrics Analytics context and show me daily sessions and top landing pages from GA4 matched with Search Console clicks and impressions for the last 30 days.",
              "tools_triggered": "list_contexts, get_context, query_marketing_data",
              "expected_behavior": "ChatGPT calls list_contexts, finds the Detrics Analytics context, calls get_context to read its GA4 and Search Console accounts, runs one query_marketing_data call per platform for the last 30 days, and presents daily sessions, top landing pages and the matching Search Console clicks and impressions."
            }
          ],
          "negative": [
            {
              "description": "General marketing advice that does not involve the user's own data.",
              "prompt": "What is the best way to structure a Meta Ads campaign for a new product launch?"
            },
            {
              "description": "Request about a third party's data that Detrics cannot access.",
              "prompt": "How much is Nike spending on Google Ads this year?"
            },
            {
              "description": "Unrelated request outside marketing data.",
              "prompt": "What is the weather in Buenos Aires tomorrow?"
            }
          ]
        },
        "demo_recording_url": "https://storage.googleapis.com/detrics-static/public/video/detrics-chatgpt-plugin-demo.mp4",
        "commerce": false,
        "commerce_description": "No commerce. The plugin only reads data from the accounts connected to the user's existing Detrics workspace. It does not sell anything, start a checkout or an upgrade flow, show plans or promote pricing."
      },
      "publication": {
        "countries": [],
        "release_notes": "- Query ad, analytics, e-commerce and CRM data from 30+ connected platforms.\n- Discover available metrics and dimensions per platform.\n- Use saved AI Contexts to query preset groups of accounts.\n- Inspect and manage Detrics data warehouse transfers.",
        "translations": {
          "es-ES": {
            "subtitle": "Tus datos de marketing en chat",
            "description": "Detrics conecta ChatGPT con las plataformas de marketing, e-commerce, anal\u00edtica y CRM que ya usas (Meta Ads, Google Ads, GA4, TikTok Ads, Shopify, Klaviyo, HubSpot y m\u00e1s de 30 en total) para que preguntes por tus propios datos en lenguaje natural.\n\nEjemplos:\n- \u00bfCu\u00e1nto gast\u00e9 en Meta Ads la semana pasada, por campa\u00f1a?\n- Compara el ROAS de Google Ads y Meta Ads del mes pasado.\n- \u00bfQu\u00e9 productos de Shopify vendieron m\u00e1s en los \u00faltimos 30 d\u00edas?\n\nInicias sesi\u00f3n con tu cuenta de Detrics. Detrics solo lee las cuentas conectadas a tu espacio de trabajo; nunca publica, edita ni borra nada en las plataformas."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}