plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "adbeacon",
  "version": "1.0.0",
  "description": "Read-only access to AdBeacon advertising attribution and e-commerce analytics: channel, campaign, ad set and ad performance across Meta, Google, TikTok, Bing, Snapchat, Pinterest and Klaviyo; creative performance; attributed orders and customer journeys; GA4 reports; and store profit and loss.",
  "author": {
    "name": "AdBeacon",
    "email": "support@adbeacon.com",
    "url": "https://www.adbeacon.com/"
  },
  "homepage": "https://www.adbeacon.com/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "AdBeacon",
        "shortDescription": "Ad attribution and analytics",
        "longDescription": "Ask questions about your AdBeacon data in plain language. AdBeacon connects ad platforms and online stores to attribute every order to the marketing that drove it.\n\nWith AdBeacon in ChatGPT you can:\n- Compare spend, revenue, ROAS, CAC and orders across Meta, Google, TikTok, Bing, Snapchat, Pinterest and Klaviyo, at campaign, ad set or ad level.\n- Switch between attribution models (first click, last click, linear, full impact and more) and attribution windows.\n- See which images, videos and ad copy are performing best.\n- Review attributed orders, how each order's credit splits across channels, and the touchpoints that led to a single order.\n- Pull GA4 traffic, landing page and product reports.\n- Check store-level sales, refunds, COGS, profit and blended ROAS.\n\nAccess is read-only. You sign in with your AdBeacon account and only see the accounts you already have access to in AdBeacon.",
        "developerName": "AdBeacon",
        "category": "Data & Analytics",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://www.adbeacon.com/",
        "supportURL": "https://www.adbeacon.com/adbeacon-help-center/",
        "privacyPolicyURL": "https://www.adbeacon.com/privacy/",
        "termsOfServiceURL": "https://www.adbeacon.com/terms-of-use/",
        "defaultPrompt": [
          "Which Meta campaigns had the best ROAS last week?",
          "Compare spend and attributed revenue by channel for last month.",
          "What were my top 5 ad creatives by revenue in the last 30 days?"
        ],
        "brandColor": "#002A42",
        "brandColorDark": "#1B84FF",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Account selection: the plugin lists the accounts the signed-in user can access.",
              "prompt": "Which AdBeacon accounts do I have access to?",
              "tools_triggered": "list-accounts",
              "expected_behavior": "Calls list-accounts and writes out the full numbered list of account names available to the reviewer account."
            },
            {
              "description": "Channel totals for a date range.",
              "prompt": "For the AdBeacon Foods Demo account, what were Meta spend, clicks and impressions from 2026-09-01 to 2026-09-30?",
              "tools_triggered": "get-summary-data",
              "expected_behavior": "Calls get-summary-data for channel meta with the given dates and reports spend, clicks and impressions in the account currency."
            },
            {
              "description": "Campaign-level breakdown ranked by a metric.",
              "prompt": "For the AdBeacon Foods Demo account, which Google campaigns had the highest ROAS between 2026-09-01 and 2026-09-30?",
              "tools_triggered": "get-channel-data",
              "expected_behavior": "Calls get-channel-data for channel google at campaign breakdown for the given dates and returns campaigns ranked by ROAS with spend and revenue."
            },
            {
              "description": "Creative performance: top assets by revenue.",
              "prompt": "For the AdBeacon Foods Demo account, what were the top 5 Meta video creatives by attributed revenue from 2026-09-01 to 2026-09-30?",
              "tools_triggered": "list-creative-channels, get-top-creatives",
              "expected_behavior": "Checks the Meta creative vocabulary with list-creative-channels, then calls get-top-creatives with breakdown video ranked by AdBeacon-attributed revenue and lists the top 5 creatives, saying the figures are AdBeacon-attributed."
            },
            {
              "description": "Store profit and loss trend.",
              "prompt": "For the AdBeacon Foods Demo account, show weekly gross sales, net profit and blended ROAS for September 2026.",
              "tools_triggered": "get-store-data",
              "expected_behavior": "Calls get-store-data with breakdown week for 2026-09-01 to 2026-09-30 and presents one row per week plus the period totals, noting these are store totals not attributed to a channel."
            }
          ],
          "negative": [
            {
              "description": "Write request: the plugin is read-only and cannot change ad platforms.",
              "prompt": "Pause my worst performing Meta campaign in AdBeacon."
            },
            {
              "description": "Unrelated request that should not trigger the plugin.",
              "prompt": "Write a haiku about autumn leaves."
            },
            {
              "description": "Request for another business's data that the signed-in user has no access to.",
              "prompt": "Show me Nike's Meta ad spend for last month."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/HroOv6b7pzw",
        "commerce": false,
        "commerce_description": "AdBeacon in ChatGPT is read-only analytics. It does not sell, promote or link to any purchase, plan or upgrade."
      },
      "publication": {
        "release_notes": "Initial release: read-only access to AdBeacon channel, creative, order attribution, GA4 and store P&L data."
      },
      "apps": "./.app.json"
    }
  }
}