.codex-plugin/plugin.json

{
  "author": {
    "name": "Adzviser LLC"
  },
  "description": "Connect your Facebook and Instagram 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 sets, and individual ads across date ranges. Explore metrics like impressions, clicks, cost per result, and conversions. 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 Meta Ads last week?",
      "Generate a monthly Facebook Ads executive report covering the last 30 days",
      "Pull Facebook Ads ad-level performance data for the last 14 days"
    ],
    "developerName": "Adzviser LLC",
    "displayName": "Adzviser Meta Ads",
    "longDescription": "Connect your Facebook and Instagram 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 sets, and individual ads across date ranges. Explore metrics like impressions, clicks, cost per result, and conversions. 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 Facebook 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-6aa067ab20f0819198ab28be70e46556",
  "skills": "./skills",
  "version": "1.0.0",
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "publication": {
        "countries": [],
        "release_notes": "Explore your Facebook and Instagram advertising performance. Check spend and website purchases by campaign, compare monthly spending, and review daily trends and performance by platform."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use a fresh conversation in Data Mode with access to the Demo workspace and its Facebook Ads connection. Resolve relative dates from the date of review. Check a single account-level monthly spending total, including its currency.",
              "prompt": "How much did we spend on Meta Ads last month in Demo?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_fb_ads, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name=Demo, discover exact fields with workspace_name=Demo, and call retrieve_reporting_data with only assorted_requests.fb_ads_request and the required report fields. Do not invoke the preview widget or set_reporting_mode. Base the answer on all returned FacebookAds tables and preserve relevant assumptions. Request metrics=[Spend], breakdowns=[Account Currency], one inclusive date range for the previous complete calendar month, and no time_granularity. State the actual dates and total spend in the returned currency. Keep distinct currencies separate. An empty result must be described as no returned data, not invented zero spend."
            },
            {
              "description": "Use a fresh conversation in Data Mode with access to the Demo workspace and its Facebook Ads connection. Resolve relative dates from the date of review. Check campaign-level spending and a specific conversion event, without ambiguity about the meaning of conversions.",
              "prompt": "Show spend and website purchases by Meta Ads campaign last month in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_fb_ads, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name=Demo, discover exact fields with workspace_name=Demo, and call retrieve_reporting_data with only assorted_requests.fb_ads_request and the required report fields. Do not invoke the preview widget or set_reporting_mode. Base the answer on all returned FacebookAds tables and preserve relevant assumptions. Request metrics=[Spend, Website Purchases], breakdowns=[Campaign ID, Campaign Name, Account Currency], and the previous complete calendar month. Present a campaign table with spend, returned currency and attributed website purchases. Distinguish duplicate names using IDs. Do not substitute Actions, Total Purchases, leads or unique customers for Website Purchases. Any totals must reconcile with the returned rows, preserving separate currencies."
            },
            {
              "description": "Use a fresh conversation in Data Mode with access to the Demo workspace and its Facebook Ads connection. Resolve relative dates from the date of review. Check a delivery breakdown by publisher platform with additive metrics.",
              "prompt": "Break down our Meta Ads spend, impressions and link clicks by platform last month in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_fb_ads, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name=Demo, discover exact fields with workspace_name=Demo, and call retrieve_reporting_data with only assorted_requests.fb_ads_request and the required report fields. Do not invoke the preview widget or set_reporting_mode. Base the answer on all returned FacebookAds tables and preserve relevant assumptions. Request metrics=[Spend, Impressions, Link Clicks], breakdowns=[Publisher Platform, Account Currency], and the previous complete calendar month. Show one row per returned platform and currency. Include every actual platform such as Facebook, Instagram, Audience Network or Threads when returned. Do not replace Link Clicks with Clicks (All), invent absent platforms, or silently drop non-Facebook/Instagram rows. Round displayed money only after calculations."
            },
            {
              "description": "Use a fresh conversation in Data Mode with access to the Demo workspace and its Facebook Ads connection. Resolve relative dates from the date of review. Check two complete calendar months in one report and calculate the change.",
              "prompt": "Compare our Meta Ads spend last month with the month before in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_fb_ads, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name=Demo, discover exact fields with workspace_name=Demo, and call retrieve_reporting_data with only assorted_requests.fb_ads_request and the required report fields. Do not invoke the preview widget or set_reporting_mode. Base the answer on all returned FacebookAds tables and preserve relevant assumptions. Request metrics=[Spend], breakdowns=[Account Currency], two separate inclusive date_ranges for the previous complete calendar month and the month before it, and no time_granularity. Report each period and its spend, then calculate recent minus earlier and (recent minus earlier)/earlier*100 in each currency. If the earlier value is zero, mark percentage change unavailable; do not invent a finite percentage. Missing rows are not zero values."
            },
            {
              "description": "Use a fresh conversation in Data Mode with access to the Demo workspace and its Facebook Ads connection. Resolve relative dates from the date of review. Check daily time grouping over a complete week.",
              "prompt": "Show our daily Meta Ads spend and link clicks last week in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_fb_ads, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name=Demo, discover exact fields with workspace_name=Demo, and call retrieve_reporting_data with only assorted_requests.fb_ads_request and the required report fields. Do not invoke the preview widget or set_reporting_mode. Base the answer on all returned FacebookAds tables and preserve relevant assumptions. Request metrics=[Spend, Link Clicks], breakdowns=[Account Currency], time_granularity=Date, and an inclusive date range for the previous complete Monday-Sunday week unless the user specified another convention. Show the exact dates and a daily table. Any weekly totals must equal the returned daily rows, separated by currency. Do not add Date to breakdowns, replace Link Clicks with Clicks (All), or fabricate zero rows for missing dates."
            }
          ],
          "negative": [
            {
              "description": "Budget changes are unsupported. Explain that this plugin retrieves connected-account reports and cannot edit campaign budgets. Do not call reporting, preview or preference tools to simulate a write, and do not claim a budget changed.",
              "prompt": "Increase every Meta Ads campaign budget in Demo by 20% right now."
            },
            {
              "description": "Public competitor Ad Library searches are outside this connector. Explain that it reports on authorized connected accounts and cannot find public competitor ads. Do not call its workspace, catalog, reporting or preview tools, substitute the user's campaigns, or claim that competitor data was retrieved.",
              "prompt": "Find all active Facebook ads run by Nike in the United States in the Meta Ad Library."
            },
            {
              "description": "Individual audience identification is unsupported. Explain that reporting can provide aggregate delivery, not names or email addresses of people who saw an ad. Do not call tools, fabricate identities, or treat demographic groups or configured targeting as individual audience membership.",
              "prompt": "Give me the names and email addresses of everyone who saw our Meta Ads in Demo last month."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/uV_317ApGyQ",
        "commerce": false,
        "commerce_description": "Adzviser subscriptions are purchased separately on the Adzviser website. The plugin provides reporting and analysis and does not offer in-plugin purchases or checkout."
      }
    }
  },
  "apps": "./.app.json"
}