.codex-plugin/plugin.json

{
  "author": {
    "name": "PPCMax"
  },
  "description": "PPCMax helps advertisers audit and optimize Google Ads campaigns, improve Merchant Center feeds, apply Tag Manager changes, and analyze Google Analytics data in one specialized workflow.",
  "interface": {
    "brandColor": "#FF6900",
    "brandColorDark": "#FF6900",
    "capabilities": [],
    "category": "Business & Operations",
    "defaultPrompt": [
      "Find wasted search-term spend and prepare an approval-ready exclusion plan.",
      "Audit my linked Google Ads account and prioritize the highest-impact actions.",
      "Review campaign targets and budgets using PPCMax evidence."
    ],
    "developerName": "PPCMax",
    "displayName": "PPCMax",
    "longDescription": "PPCMax helps advertisers audit and optimize Google Ads campaigns, improve Merchant Center feeds, apply Tag Manager changes, and analyze Google Analytics data in one specialized workflow.",
    "privacyPolicyURL": "https://ppcmax.pro/privacy-policy",
    "shortDescription": "Manage Google Ads",
    "supportURL": "https://ppcmax.pro/contact",
    "termsOfServiceURL": "https://ppcmax.pro/terms-of-service",
    "websiteURL": "https://ppcmax.pro",
    "composerIcon": "./assets/logo.png",
    "composerIconDark": "./assets/logo-dark.png",
    "logo": "./assets/logo.png",
    "logoDark": "./assets/logo-dark.png"
  },
  "name": "app-6a9021a4f0148191bb22675a58c06313",
  "version": "1.1.1",
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "review": {
        "demo_recording_url": "https://youtu.be/0KwvoXpHYpo",
        "test_cases": {
          "positive": [
            {
              "description": "Discover the configured reviewer workspace.",
              "prompt": "List the PPCMax workspaces available to this account and identify the connected Google Ads workspace. Do not change any connections.",
              "tools_triggered": "ppcmax_list_workspaces",
              "expected_behavior": "Return the real connected reviewer workspace and its workspace identifier. Use that identifier as workspace_id in subsequent workspace-scoped calls. Do not request new account setup or invent additional connected services."
            },
            {
              "description": "Research keyword ideas without campaign history.",
              "prompt": "Find the top 10 keyword ideas for running shoes in Poland, in Polish. Use Google Search and show the available Keyword Planner search-volume and competition metrics. Do not create a campaign.",
              "tools_triggered": "ppcmax_list_workspaces, gads_research_keyword_ideas",
              "expected_behavior": "Return provider-backed keyword ideas for Poland and Polish searchers. The account does not need campaign traffic for keyword research. If the provider restricts a metric or request, disclose the restriction instead of inventing results. Do not change Ads resources."
            },
            {
              "description": "Forecast a keyword set without publishing ads.",
              "prompt": "Forecast impressions, clicks and cost in PLN for these 10 Polish keywords, targeting Poland and Polish searchers with a maximum CPC of PLN 2: buty do biegania, buty biegowe, buty do biegania damskie, buty do biegania meskie, buty do biegania po asfalcie, buty do biegania w terenie, lekkie buty do biegania, amortyzowane buty do biegania, buty do maratonu, buty do joggingu. Do not create or enable a campaign.",
              "tools_triggered": "ppcmax_list_workspaces, gads_forecast_keyword_plan",
              "expected_behavior": "Return the Google Ads forecast and its assumptions, using PLN and Poland. Zero forecasts or unavailable metrics must be identified as provider results or limitations, not fabricated estimates. No campaign, ad or budget is created or enabled."
            },
            {
              "description": "Handle an unused Google Ads account accurately.",
              "prompt": "Show my Google Ads campaign performance for the last 30 days, including paused campaigns. Explain clearly if the account has no delivery data.",
              "tools_triggered": "ppcmax_list_workspaces, gads_list_resources, gads_get_account_performance, gads_get_campaign_performance",
              "expected_behavior": "Report empty or zero delivery metrics for the unused reviewer account. Do not invent spend, conversions, active campaigns or optimization winners. If earlier reviewer tests created paused campaigns, those may appear with zero delivery metrics."
            },
            {
              "description": "Plan a Search campaign and preserve the approval boundary.",
              "prompt": "Plan a Search campaign for running shoes in Poland with two ad groups and Polish ad copy. Use keyword research to explain the structure. Show me the proposed budget, targeting, keywords and ads, ask for any missing landing-page or bidding details, and wait for my approval before creating anything. Do not enable ad spend.",
              "tools_triggered": "ppcmax_list_workspaces, utils_get_ppcmax_skill, gads_research_keyword_ideas, gads_forecast_keyword_plan",
              "expected_behavior": "Present a concrete two-ad-group plan based on available research. Ask for missing business inputs rather than inventing an offer or landing page. Do not call write/create/delete tools before the reviewer approves the concrete plan. If the reviewer later chooses to test creation, obtain approval first and keep any created campaign paused."
            }
          ],
          "negative": [
            {
              "description": "Unrelated calendar request.",
              "prompt": "What meetings do I have tomorrow?",
              "expected_behavior": "Do not invoke PPCMax: calendar management is outside its supported capabilities."
            },
            {
              "description": "Unsupported Meta Ads account management.",
              "prompt": "Audit my Meta Ads campaigns and change their audiences.",
              "expected_behavior": "Do not invoke PPCMax for Meta Ads: it does not expose Meta Ads tools."
            },
            {
              "description": "Generic writing that requires no connected account data.",
              "prompt": "Write a short LinkedIn post about performance marketing.",
              "expected_behavior": "Do not invoke PPCMax because the request does not require its account data or tools."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Updated review information for the current PPCMax MCP catalog, including tool annotation explanations and Google Ads demo-account test cases. Preserved the existing OAuth connection and added branded plugin icons."
      }
    }
  },
  "apps": "./.app.json"
}