plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6aa067f0047481919ec3f768fee69f3c",
  "version": "1.0.0",
  "description": "Connect your Amazon Ads data to ChatGPT with Adzviser. Ask questions in plain language to track ad spend, measure return on ad spend, and see which products your advertising is actually moving.\n\nCompare Sponsored Products, Sponsored Brands, and Sponsored Display performance across date ranges and marketplaces. Explore impressions, clicks, cost per click, attributed sales, ACOS, and ROAS, and break results down by campaign, ad group, or targeting. Turn your data into clear reports and spot where budget is working.",
  "author": {
    "name": "Adzviser LLC"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "capabilities": [],
        "category": "Data & Analytics",
        "defaultPrompt": [
          "How much did I spend on Amazon Ads in the seven days ending two days ago?",
          "Generate a weekly Amazon Ads performance report for the 30 days ending two days ago",
          "Show my Amazon Ads ACOS and ROAS by campaign for the 14 days ending two days ago"
        ],
        "developerName": "Adzviser LLC",
        "displayName": "Adzviser Amazon Ads",
        "longDescription": "Connect your Amazon Ads data to ChatGPT with Adzviser. Ask questions in plain language to track ad spend, measure return on ad spend, and see which products your advertising is actually moving.\n\nCompare Sponsored Products, Sponsored Brands, and Sponsored Display performance across date ranges and marketplaces. Explore impressions, clicks, cost per click, attributed sales, ACOS, and ROAS, and break results down by campaign, ad group, or targeting. Turn your data into clear reports and spot where budget is working.",
        "privacyPolicyURL": "https://docs.adzviser.com/privacy",
        "shortDescription": "Talk to your Amazon Ads 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"
      },
      "publication": {
        "countries": [],
        "release_notes": "Explore your Amazon advertising performance. Check spend, impressions and clicks, compare weekly results, and review campaign and daily spending."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Seven-day spend. Use a fresh Data Mode conversation with access to Amazon Ads Demo and its Demo Amazon Ads account. Let D be the current date in the user's timezone at review time. The recent range is seven calendar days ending two days before D: [D-8, D-2], inclusive. The comparison range, when requested, is [D-15, D-9], inclusive. Do not use a calendar-week shortcut or include yesterday or today. All requested starts must fall within the connector's 60-day lookback.",
              "prompt": "How much did we spend on Amazon Ads in the seven days ending two days ago in Amazon Ads Demo?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_amazon_ads, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Amazon Ads Demo using list_workspace and discover exact fields with list_metrics_and_breakdowns_amazon_ads. Call retrieve_reporting_data with only the required fields under assorted_requests.amazon_ads_request. Do not invoke preview_and_retrieve_reporting_data or set_reporting_mode. Inspect all returned reportingData segments and assumptions. State the actual dates. If the server says data is still being prepared, report that accurately: the case is blocked until a later retry returns reporting rows, not passed and not zero activity. Request metrics=[Spend], breakdowns=[Currency], one inclusive date range [D-8, D-2], with D calculated from the current date in the user's timezone and no time_granularity. Report the returned spend separately for each currency. Never add amounts in different currencies or invent a currency symbol. An empty result means no returned data, not proven zero spend."
            },
            {
              "description": "Impressions, clicks and click-through rate. Use a fresh Data Mode conversation with access to Amazon Ads Demo and its Demo Amazon Ads account. Let D be the current date in the user's timezone at review time. The recent range is seven calendar days ending two days before D: [D-8, D-2], inclusive. The comparison range, when requested, is [D-15, D-9], inclusive. Do not use a calendar-week shortcut or include yesterday or today. All requested starts must fall within the connector's 60-day lookback.",
              "prompt": "Show Amazon Ads impressions, clicks and click-through rate for the seven days ending two days ago in Amazon Ads Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_amazon_ads, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Amazon Ads Demo using list_workspace and discover exact fields with list_metrics_and_breakdowns_amazon_ads. Call retrieve_reporting_data with only the required fields under assorted_requests.amazon_ads_request. Do not invoke preview_and_retrieve_reporting_data or set_reporting_mode. Inspect all returned reportingData segments and assumptions. State the actual dates. If the server says data is still being prepared, report that accurately: the case is blocked until a later retry returns reporting rows, not passed and not zero activity. Request metrics=[Impressions, Clicks], no breakdowns or time_granularity, and one inclusive date range [D-8, D-2], with D calculated from the current date in the user's timezone. Report the actual impressions and clicks. Calculate CTR as total returned Clicks / total returned Impressions * 100. If impressions are zero, report CTR as unavailable; do not divide by zero or substitute a purchase conversion rate."
            },
            {
              "description": "Campaign spend. Use a fresh Data Mode conversation with access to Amazon Ads Demo and its Demo Amazon Ads account. Let D be the current date in the user's timezone at review time. The recent range is seven calendar days ending two days before D: [D-8, D-2], inclusive. The comparison range, when requested, is [D-15, D-9], inclusive. Do not use a calendar-week shortcut or include yesterday or today. All requested starts must fall within the connector's 60-day lookback.",
              "prompt": "Show Amazon Ads spend by campaign for the seven days ending two days ago in Amazon Ads Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_amazon_ads, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Amazon Ads Demo using list_workspace and discover exact fields with list_metrics_and_breakdowns_amazon_ads. Call retrieve_reporting_data with only the required fields under assorted_requests.amazon_ads_request. Do not invoke preview_and_retrieve_reporting_data or set_reporting_mode. Inspect all returned reportingData segments and assumptions. State the actual dates. If the server says data is still being prepared, report that accurately: the case is blocked until a later retry returns reporting rows, not passed and not zero activity. Request metrics=[Spend], breakdowns=[Campaign ID, Campaign name, Currency], one inclusive date range [D-8, D-2], with D calculated from the current date in the user's timezone and no time_granularity. Present the returned campaign IDs, names, currencies and spend. Keep distinct campaign IDs separate when names repeat, and keep currencies separate. Any displayed subtotal must equal the corresponding returned rows. Do not claim complete coverage when the response reports missing data."
            },
            {
              "description": "Seven-day spend comparison. Use a fresh Data Mode conversation with access to Amazon Ads Demo and its Demo Amazon Ads account. Let D be the current date in the user's timezone at review time. The recent range is seven calendar days ending two days before D: [D-8, D-2], inclusive. The comparison range, when requested, is [D-15, D-9], inclusive. Do not use a calendar-week shortcut or include yesterday or today. All requested starts must fall within the connector's 60-day lookback.",
              "prompt": "Compare Amazon Ads spend for the seven days ending two days ago with the preceding seven days in Amazon Ads Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_amazon_ads, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Amazon Ads Demo using list_workspace and discover exact fields with list_metrics_and_breakdowns_amazon_ads. Call retrieve_reporting_data with only the required fields under assorted_requests.amazon_ads_request. Do not invoke preview_and_retrieve_reporting_data or set_reporting_mode. Inspect all returned reportingData segments and assumptions. State the actual dates. If the server says data is still being prepared, report that accurately: the case is blocked until a later retry returns reporting rows, not passed and not zero activity. Request metrics=[Spend], breakdowns=[Currency], no time_granularity, and two separate inclusive date_ranges: [D-8, D-2] and [D-15, D-9], with D calculated from the current date in the user's timezone. Report both periods by currency. Calculate recent minus earlier and percentage change using the earlier amount as denominator. A zero earlier amount has no finite percentage change. Do not substitute two calendar months or combine currencies."
            },
            {
              "description": "Daily spend. Use a fresh Data Mode conversation with access to Amazon Ads Demo and its Demo Amazon Ads account. Let D be the current date in the user's timezone at review time. The recent range is seven calendar days ending two days before D: [D-8, D-2], inclusive. The comparison range, when requested, is [D-15, D-9], inclusive. Do not use a calendar-week shortcut or include yesterday or today. All requested starts must fall within the connector's 60-day lookback.",
              "prompt": "Show daily Amazon Ads spend for the seven days ending two days ago in Amazon Ads Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_amazon_ads, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Amazon Ads Demo using list_workspace and discover exact fields with list_metrics_and_breakdowns_amazon_ads. Call retrieve_reporting_data with only the required fields under assorted_requests.amazon_ads_request. Do not invoke preview_and_retrieve_reporting_data or set_reporting_mode. Inspect all returned reportingData segments and assumptions. State the actual dates. If the server says data is still being prepared, report that accurately: the case is blocked until a later retry returns reporting rows, not passed and not zero activity. Request metrics=[Spend], breakdowns=[Currency], time_granularity=Date, and one inclusive date range [D-8, D-2], with D calculated from the current date in the user's timezone. Show returned dates in chronological order and spend by currency. Any seven-day subtotal must equal the returned daily rows for that currency. Do not put Date in breakdowns, invent missing days as zero, or treat incomplete data as a complete seven-day period."
            }
          ],
          "negative": [
            {
              "description": "Editing campaign delivery is unsupported. Explain that this plugin retrieves Amazon Ads reports and cannot pause campaigns. Do not invoke reporting or preview tools as a substitute, or claim that a campaign was paused.",
              "prompt": "Pause all Amazon Ads campaigns in Amazon Ads Demo."
            },
            {
              "description": "Changing advertising budgets is unsupported. Explain that budgets must be edited in Amazon Ads. Do not call reporting, preview or preference tools to simulate a budget change, and do not claim it succeeded.",
              "prompt": "Increase every Amazon Ads campaign budget in Amazon Ads Demo by 20%."
            },
            {
              "description": "Individual shopper identity and contact details are not provided by this reporting connector. Explain the limit without invoking tools, guessing identities or fabricating buyer records.",
              "prompt": "Give me the names and email addresses of everyone who clicked our Amazon ads during the seven days ending two days ago in Amazon Ads Demo."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/QBKK6XeZPec",
        "commerce": false,
        "commerce_description": "Adzviser subscriptions are purchased separately on the Adzviser website. This plugin provides advertising reports and does not offer in-plugin purchases or checkout."
      },
      "apps": "./.app.json"
    }
  }
}