.codex-plugin/plugin.json

{
  "author": {
    "name": "Adzviser LLC"
  },
  "description": "Explore your Google Merchant Center data with Adzviser. Ask questions in plain language to see product impressions, clicks, and click-through rate.\n\nCompare reporting periods, find products getting the most clicks, and break performance down by brand, product category, customer country, or marketing method. Review ads and organic traffic separately.\n\nInspect current product details and reported product issues alongside your performance analysis. Product details and issues describe the current feed, rather than historical status during a selected date range.",
  "interface": {
    "capabilities": [],
    "category": "Data & Analytics",
    "defaultPrompt": [
      "How did my product listings perform last week?",
      "Generate a monthly Merchant Center product feed report covering the last 30 days",
      "Show me my top Merchant Center products by clicks for the last 14 days"
    ],
    "developerName": "Adzviser LLC",
    "displayName": "Adzviser Merchant Center",
    "longDescription": "Explore your Google Merchant Center data with Adzviser. Ask questions in plain language to see product impressions, clicks, and click-through rate.\n\nCompare reporting periods, find products getting the most clicks, and break performance down by brand, product category, customer country, or marketing method. Review ads and organic traffic separately.\n\nInspect current product details and reported product issues alongside your performance analysis. Product details and issues describe the current feed, rather than historical status during a selected date range.",
    "privacyPolicyURL": "https://docs.adzviser.com/privacy",
    "shortDescription": "Talk to Google product 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-6aa3b9397a048191be1511994353757e",
  "skills": "./skills",
  "version": "1.0.0",
  "extensions": {
    "com.openai": {
      "interface": {
        "capabilities": [],
        "category": "Data & Analytics",
        "defaultPrompt": [
          "How did my product listings perform last week?",
          "Generate a monthly Merchant Center product feed report covering the last 30 days",
          "Show me my top Merchant Center products by clicks for the last 14 days"
        ],
        "developerName": "Adzviser LLC",
        "displayName": "Adzviser Merchant Center",
        "longDescription": "Explore your Google Merchant Center data with Adzviser. Ask questions in plain language to see product impressions, clicks, and click-through rate.\n\nCompare reporting periods, find products getting the most clicks, and break performance down by brand, product category, customer country, or marketing method. Review ads and organic traffic separately.\n\nInspect current product details and reported product issues alongside your performance analysis. Product details and issues describe the current feed, rather than historical status during a selected date range.",
        "privacyPolicyURL": "https://docs.adzviser.com/privacy",
        "shortDescription": "Talk to Google product 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 Merchant Center clicks, impressions, and click-through rate. Find your top products, compare ads with organic traffic, and review performance by country and reporting period."
      },
      "review": {
        "prompts": [
          "How many impressions and clicks did we get in Merchant Center Demo during the 30 days ending two days ago, and what was our CTR?",
          "Which 10 products got the most clicks in Merchant Center Demo during the 30 days ending two days ago?",
          "Show clicks and impressions by customer country in Merchant Center Demo for the 30 days ending two days ago.",
          "How many clicks and impressions came from ads versus organic listings in Merchant Center Demo during the 30 days ending two days ago?",
          "Compare clicks and impressions in Merchant Center Demo for the 30 days ending two days ago with the preceding 30 days."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Traffic totals and CTR. Use a fresh Data Mode conversation with reviewer access to workspace Merchant Center Demo and its connected Yuka.ua Merchant Center account. Let D be the current date in the user's timezone. The recent 30-day interval is [D-31, D-2] and the preceding 30 days are [D-61, D-32], both inclusive. Recalculate dates at review time. Expected numbers must come from returned rows, not historical preparation notes. ",
              "prompt": "How many impressions and clicks did we get in Merchant Center Demo during the 30 days ending two days ago, and what was our CTR?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_merchant_center, retrieve_reporting_data",
              "expected_behavior": "Call list_workspace and select workspace_name=Merchant Center Demo, discover fields using list_metrics_and_breakdowns_merchant_center, then call retrieve_reporting_data using only necessary fields in assorted_requests.merchant_center_request. Do not call preview_and_retrieve_reporting_data or set_reporting_mode. Do not send client_id, reporting_mode, conversation history or unrelated context. Read model-visible reportingData.MerchantCenter.data, table names, headers, date segments and note_of_assumption. Match columns by header. Convert numeric strings to numbers for calculation; preserve Product ID as text. Show the actual reporting dates. Empty responses and provider errors must be explained accurately; do not invent records or treat errors as zero traffic. Request metrics=[Impressions, Clicks, CTR] and breakdowns=[]. Use date_ranges=[[D-31, D-2]] and no time_granularity. Read the Combined table and report its period totals. CTR is a fractional ratio; multiply by 100 once for percentage display. When impressions are positive, verify CTR agrees with Clicks / Impressions within rounding tolerance. If impressions are zero, explain that a calculated CTR is undefined instead of dividing by zero. Do not average segmented CTR values."
            },
            {
              "description": "Top products by clicks. Use a fresh Data Mode conversation with reviewer access to workspace Merchant Center Demo and its connected Yuka.ua Merchant Center account. Let D be the current date in the user's timezone. The recent 30-day interval is [D-31, D-2] and the preceding 30 days are [D-61, D-32], both inclusive. Recalculate dates at review time. Expected numbers must come from returned rows, not historical preparation notes. ",
              "prompt": "Which 10 products got the most clicks in Merchant Center Demo during the 30 days ending two days ago?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_merchant_center, retrieve_reporting_data",
              "expected_behavior": "Call list_workspace and select workspace_name=Merchant Center Demo, discover fields using list_metrics_and_breakdowns_merchant_center, then call retrieve_reporting_data using only necessary fields in assorted_requests.merchant_center_request. Do not call preview_and_retrieve_reporting_data or set_reporting_mode. Do not send client_id, reporting_mode, conversation history or unrelated context. Read model-visible reportingData.MerchantCenter.data, table names, headers, date segments and note_of_assumption. Match columns by header. Convert numeric strings to numbers for calculation; preserve Product ID as text. Show the actual reporting dates. Empty responses and provider errors must be explained accurately; do not invent records or treat errors as zero traffic. Request metrics=[Clicks, Impressions], breakdowns=[Product ID, Title]. Use date_ranges=[[D-31, D-2]] and no time_granularity. Read ProductPerformance. Aggregate additive counts across returned title variants sharing the same nonblank Product ID within this account and period. Keep distinct IDs separate even if their titles match. Preserve IDs including leading zeros. Sort product click totals descending, breaking ties by Product ID, and show up to 10 IDs, returned titles, clicks and impressions. If an ID has several titles, label the variants or select a returned title without claiming it is the latest. Exclude blank IDs from the named-product ranking and disclose their returned traffic separately if present. Do not fabricate missing titles or claim the top 10 represents all account traffic."
            },
            {
              "description": "Customer countries. Use a fresh Data Mode conversation with reviewer access to workspace Merchant Center Demo and its connected Yuka.ua Merchant Center account. Let D be the current date in the user's timezone. The recent 30-day interval is [D-31, D-2] and the preceding 30 days are [D-61, D-32], both inclusive. Recalculate dates at review time. Expected numbers must come from returned rows, not historical preparation notes. ",
              "prompt": "Show clicks and impressions by customer country in Merchant Center Demo for the 30 days ending two days ago.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_merchant_center, retrieve_reporting_data",
              "expected_behavior": "Call list_workspace and select workspace_name=Merchant Center Demo, discover fields using list_metrics_and_breakdowns_merchant_center, then call retrieve_reporting_data using only necessary fields in assorted_requests.merchant_center_request. Do not call preview_and_retrieve_reporting_data or set_reporting_mode. Do not send client_id, reporting_mode, conversation history or unrelated context. Read model-visible reportingData.MerchantCenter.data, table names, headers, date segments and note_of_assumption. Match columns by header. Convert numeric strings to numbers for calculation; preserve Product ID as text. Show the actual reporting dates. Empty responses and provider errors must be explained accurately; do not invent records or treat errors as zero traffic. Request metrics=[Clicks, Impressions], breakdowns=[Customer country code]. Use date_ranges=[[D-31, D-2]] and no time_granularity. Read ProductPerformance and show each returned country code with its counts, sorted by clicks descending. This is customer country, not product target country. Preserve unknown or blank codes as unknown. Do not invent countries, zero-fill absent countries, or assume segmented impressions equal unsegmented account impressions. If compared with a separate account total, disclose any difference without assigning it to an invented country."
            },
            {
              "description": "Ads versus organic. Use a fresh Data Mode conversation with reviewer access to workspace Merchant Center Demo and its connected Yuka.ua Merchant Center account. Let D be the current date in the user's timezone. The recent 30-day interval is [D-31, D-2] and the preceding 30 days are [D-61, D-32], both inclusive. Recalculate dates at review time. Expected numbers must come from returned rows, not historical preparation notes. ",
              "prompt": "How many clicks and impressions came from ads versus organic listings in Merchant Center Demo during the 30 days ending two days ago?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_merchant_center, retrieve_reporting_data",
              "expected_behavior": "Call list_workspace and select workspace_name=Merchant Center Demo, discover fields using list_metrics_and_breakdowns_merchant_center, then call retrieve_reporting_data using only necessary fields in assorted_requests.merchant_center_request. Do not call preview_and_retrieve_reporting_data or set_reporting_mode. Do not send client_id, reporting_mode, conversation history or unrelated context. Read model-visible reportingData.MerchantCenter.data, table names, headers, date segments and note_of_assumption. Match columns by header. Convert numeric strings to numbers for calculation; preserve Product ID as text. Show the actual reporting dates. Empty responses and provider errors must be explained accurately; do not invent records or treat errors as zero traffic. Request metrics=[Clicks, Impressions], breakdowns=[Marketing method]. Use date_ranges=[[D-31, D-2]] and no time_granularity. Read ProductPerformance. Show ADS and ORGANIC counts separately using the returned labels; retain other or unknown methods if returned. Do not confuse Merchant Center clicks with Google Ads spend, website sessions or conversions. Any combined total must sum the returned counts, not average them. Absent methods are not automatically confirmed zero activity."
            },
            {
              "description": "Period comparison. Use a fresh Data Mode conversation with reviewer access to workspace Merchant Center Demo and its connected Yuka.ua Merchant Center account. Let D be the current date in the user's timezone. The recent 30-day interval is [D-31, D-2] and the preceding 30 days are [D-61, D-32], both inclusive. Recalculate dates at review time. Expected numbers must come from returned rows, not historical preparation notes. ",
              "prompt": "Compare clicks and impressions in Merchant Center Demo for the 30 days ending two days ago with the preceding 30 days.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_merchant_center, retrieve_reporting_data",
              "expected_behavior": "Call list_workspace and select workspace_name=Merchant Center Demo, discover fields using list_metrics_and_breakdowns_merchant_center, then call retrieve_reporting_data using only necessary fields in assorted_requests.merchant_center_request. Do not call preview_and_retrieve_reporting_data or set_reporting_mode. Do not send client_id, reporting_mode, conversation history or unrelated context. Read model-visible reportingData.MerchantCenter.data, table names, headers, date segments and note_of_assumption. Match columns by header. Convert numeric strings to numbers for calculation; preserve Product ID as text. Show the actual reporting dates. Empty responses and provider errors must be explained accurately; do not invent records or treat errors as zero traffic. Request metrics=[Clicks, Impressions], breakdowns=[], date_ranges=[[D-31, D-2], [D-61, D-32]], and no time_granularity. Read Combined and keep the date segments separate. Show both period totals, recent minus earlier for each metric, and percentage changes relative to earlier. When an earlier value is zero, its percentage change is undefined. Do not merge periods or substitute calendar months."
            }
          ],
          "negative": [
            {
              "description": "Editing prices is unsupported. Explain that this plugin retrieves Merchant Center reports and cannot update product prices. Do not call reporting, preview, catalog, workspace or preference tools as a substitute, and do not claim any prices changed.",
              "prompt": "Reduce every product price in Merchant Center Demo by 10%."
            },
            {
              "description": "Deleting products is unsupported. Explain that this reporting plugin cannot remove products from the feed. Do not fetch reports or invoke other tools to pretend to perform deletion, and do not claim any product was removed.",
              "prompt": "Delete all disapproved products from Merchant Center Demo."
            },
            {
              "description": "Changing advertising budgets or bids is unsupported. Explain that Merchant Center reporting cannot change Google Ads campaigns. Do not invoke reporting or preference tools as a substitute, and do not claim any budget was updated.",
              "prompt": "Double the Shopping campaign budget for the products in Merchant Center Demo."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/gbv-Vxd8LR0",
        "commerce": false,
        "commerce_description": "Adzviser subscriptions are purchased separately on the Adzviser website. This plugin does not offer in-plugin purchases or checkout."
      }
    }
  },
  "mcpServers": "./mcp.json"
}