.codex-plugin/plugin.json

{
  "author": {
    "name": "Adzviser LLC"
  },
  "description": "Connect your Google Ads data to ChatGPT with Adzviser. Ask questions in plain language to analyze campaign performance, track spending, and understand your return on ad spend.\n\nCompare campaigns, ad groups, keywords, and individual ads across date ranges. Explore metrics like impressions, clicks, cost per click, conversions, and conversion value. Turn your data into clear reports, spot performance trends, and identify opportunities to improve your advertising.",
  "interface": {
    "capabilities": [],
    "category": "Data & Analytics",
    "defaultPrompt": [
      "How much did I spend on Google Ads last week?",
      "Generate a monthly Google Ads executive report covering the last 30 days",
      "Pull Google Ads campaign-level performance data for the last 14 days"
    ],
    "developerName": "Adzviser LLC",
    "displayName": "Adzviser Google Ads",
    "longDescription": "Connect your Google Ads data to ChatGPT with Adzviser. Ask questions in plain language to analyze campaign performance, track spending, and understand your return on ad spend.\n\nCompare campaigns, ad groups, keywords, and individual ads across date ranges. Explore metrics like impressions, clicks, cost per click, conversions, and conversion value. Turn your data into clear reports, spot performance trends, and identify opportunities to improve your advertising.",
    "privacyPolicyURL": "https://docs.adzviser.com/privacy",
    "shortDescription": "Talk to your Google 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"
  },
  "name": "app-6aa067c6b00c819184fd02ecea043a21",
  "skills": "./skills",
  "version": "1.0.0",
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "publication": {
        "countries": [],
        "release_notes": "Explore your advertising spend, clicks and conversions. Compare months, review campaign performance and see daily trends using your connected Google Ads accounts."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Start a fresh conversation with this plugin enabled and a reviewer account that can access the Demo workspace and its connected Google Ads Demo account. Use Data Mode only. If Demo is unavailable, explain the access problem without switching workspaces. Monthly spend with explicit account currency.",
              "prompt": "How much did we spend on Google Ads last month in Demo?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_google_ads, retrieve_reporting_data",
              "expected_behavior": "Resolve last month to the previous complete calendar month and state its inclusive dates. Request metrics Cost and breakdowns Account Currency Code, with no time_granularity. Report the returned spend separately for each currency. The response may label Cost as $ Cost; follow the actual header and account currency rather than assuming USD or converting the amount from micros again. Use workspace_name Demo and only assorted_requests.google_ads_request. Discover exact labels with list_metrics_and_breakdowns_google_ads. Read the header and rows of each returned table in structuredContent.reportingData.GoogleAds.data and surface relevant note_of_assumption text. Preserve currencies, fractional conversions, returned zeros and missing-data distinctions. Do not open a widget or send conversation history, the user's full prompt, unrelated fields, credentials or internal client IDs."
            },
            {
              "description": "Start a fresh conversation with this plugin enabled and a reviewer account that can access the Demo workspace and its connected Google Ads Demo account. Use Data Mode only. If Demo is unavailable, explain the access problem without switching workspaces. Campaign-level reporting with stable identifiers and fractional conversion counts.",
              "prompt": "Show spend, clicks and conversions by Google Ads campaign last month in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_google_ads, retrieve_reporting_data",
              "expected_behavior": "Use the previous complete calendar month. Request Cost, Clicks and Conversions with Campaign ID, Campaign Name and Account Currency Code, with no time_granularity. Present each returned campaign with those values. Keep different campaign IDs distinct even if names match. Preserve fractional conversions from attribution. Do not replace conversions with All Conversions or describe conversion value as cash collected. Use workspace_name Demo and only assorted_requests.google_ads_request. Discover exact labels with list_metrics_and_breakdowns_google_ads. Read the header and rows of each returned table in structuredContent.reportingData.GoogleAds.data and surface relevant note_of_assumption text. Preserve currencies, fractional conversions, returned zeros and missing-data distinctions. Do not open a widget or send conversation history, the user's full prompt, unrelated fields, credentials or internal client IDs."
            },
            {
              "description": "Start a fresh conversation with this plugin enabled and a reviewer account that can access the Demo workspace and its connected Google Ads Demo account. Use Data Mode only. If Demo is unavailable, explain the access problem without switching workspaces. Device segmentation and a derived click-through rate.",
              "prompt": "Show Google Ads clicks, impressions and click-through rate by device last month in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_google_ads, retrieve_reporting_data",
              "expected_behavior": "Use the previous complete calendar month. Request Clicks and Impressions with Device, without time_granularity. Calculate each device CTR as clicks divided by impressions times 100. Show N/A when the denominator is zero. If an overall CTR is included, calculate it from summed clicks and impressions rather than averaging device percentages. Explain returned device enum labels without inventing missing groups. Use workspace_name Demo and only assorted_requests.google_ads_request. Discover exact labels with list_metrics_and_breakdowns_google_ads. Read the header and rows of each returned table in structuredContent.reportingData.GoogleAds.data and surface relevant note_of_assumption text. Preserve currencies, fractional conversions, returned zeros and missing-data distinctions. Do not open a widget or send conversation history, the user's full prompt, unrelated fields, credentials or internal client IDs."
            },
            {
              "description": "Start a fresh conversation with this plugin enabled and a reviewer account that can access the Demo workspace and its connected Google Ads Demo account. Use Data Mode only. If Demo is unavailable, explain the access problem without switching workspaces. Two distinct comparison periods in one report.",
              "prompt": "Compare our Google Ads spend last month with the month before in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_google_ads, retrieve_reporting_data",
              "expected_behavior": "Send one request containing two date_ranges pairs: the previous complete calendar month and the month before it. Request Cost and Account Currency Code, without time_granularity. Match each returned currency across periods. Show both totals and later minus earlier absolute change. Calculate percentage change only when the earlier value is present and nonzero; a missing row is unavailable, not assumed zero. Use workspace_name Demo and only assorted_requests.google_ads_request. Discover exact labels with list_metrics_and_breakdowns_google_ads. Read the header and rows of each returned table in structuredContent.reportingData.GoogleAds.data and surface relevant note_of_assumption text. Preserve currencies, fractional conversions, returned zeros and missing-data distinctions. Do not open a widget or send conversation history, the user's full prompt, unrelated fields, credentials or internal client IDs."
            },
            {
              "description": "Start a fresh conversation with this plugin enabled and a reviewer account that can access the Demo workspace and its connected Google Ads Demo account. Use Data Mode only. If Demo is unavailable, explain the access problem without switching workspaces. Daily time series with honest handling of missing dates.",
              "prompt": "Show daily Google Ads spend and clicks last week in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_google_ads, retrieve_reporting_data",
              "expected_behavior": "Resolve last week to the previous complete Monday-Sunday week and state the dates. Request Cost and Clicks with Account Currency Code and time_granularity Date. Do not add Date to breakdowns. The daily date can appear in a Date Range column; follow the returned headers. Sort the returned dates chronologically and keep currencies separate. Missing days are not fabricated as zero-spend days. Use workspace_name Demo and only assorted_requests.google_ads_request. Discover exact labels with list_metrics_and_breakdowns_google_ads. Read the header and rows of each returned table in structuredContent.reportingData.GoogleAds.data and surface relevant note_of_assumption text. Preserve currencies, fractional conversions, returned zeros and missing-data distinctions. Do not open a widget or send conversation history, the user's full prompt, unrelated fields, credentials or internal client IDs."
            }
          ],
          "negative": [
            {
              "description": "Unsupported account modification. Explain that this plugin reports performance but cannot change budgets. Do not call its discovery, retrieval, preview or mode tools as a substitute, and do not claim a budget was changed.",
              "prompt": "Increase all my Google Ads campaign budgets by 20% in Demo."
            },
            {
              "description": "Unsupported destructive action. Explain that this reporting plugin cannot delete campaigns. Do not invoke this plugin's tools or claim that any campaign was deleted.",
              "prompt": "Delete every paused Google Ads campaign in Demo."
            },
            {
              "description": "Unsupported public advertising search. This plugin reports only from authorized connected Google Ads accounts. Explain that competitor ad-library searches need a separate capability. Do not invoke this plugin's tools or send google_ads_transparency_request.",
              "prompt": "Use this plugin to find my competitors' ads in the public Google Ads Transparency Center."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/VC3-yn69VeM",
        "commerce": false,
        "commerce_description": "Adzviser subscriptions are purchased separately on the Adzviser website (https://adzviser.com). This plugin reports on connected Google Ads accounts and does not offer in-plugin purchases, process payments or purchase advertising."
      }
    }
  },
  "apps": "./.app.json"
}