--- title: "experiment_performance_stats. Metadata MCP tool reference" url: https://metadata.io/developers/tools/experiment_performance_stats description: "Experiment-level performance statistics from Metadata.io Experiments API. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response." source: metadata.io --- # experiment_performance_stats Experiment-level performance statistics from Metadata.io Experiments API. Read [analytics](https://metadata.io/developers/tools/#cat-analytics) ## What it does ## Arguments | Argument | Type | | Notes | |---|---|---|---| | `metrics` | array | | List of metrics for secondary ordering when question involves multiple metrics (e.g., ['cpl', 'ctr', 'leads']). Only include when analyzing more than one metric simultaneously. Do NOT include for single metric questions. | | `minSpend` | number | | Minimum spend threshold. REQUIRED for all campaigns except Brand Awareness. Use for Lead Generation and when campaign type is unspecified. | | `minLeads` | integer | | Minimum leads threshold. REQUIRED for Lead Generation campaigns. Do NOT use for Brand Awareness campaigns. | | `minCpl` | integer | | Minimum cost per lead threshold (whole dollars). REQUIRED for Lead Generation campaigns. Do NOT use for Brand Awareness campaigns. | | `minAudienceSize` | integer | | Minimum audience size to filter experiments | | `minClicks` | integer | | Minimum clicks threshold. REQUIRED for Brand Awareness campaigns only. Do NOT use for Lead Generation campaigns. | | `minCpc` | integer | | Minimum cost per click threshold (whole dollars). Do NOT use for Lead Generation or unspecified campaign types. | | `size` | integer | | Number of results to return. RULES: size=1 for 'top' singular questions, size=requested number for 'top X' questions, size=50 for plural questions (e.g. 'campaigns'), size=30+ for multiple metrics analysis, size=15 as default when not specified. Raise it freely for full-dataset analytics — there is | | `sort` | string | | Sorting parameter. CRITICAL RULES: 'cpl2Score,desc' for Lead Generation or unspecified campaigns, 'cpc2Score,desc' for Brand Awareness, 'triggeredAmount,desc' for ROI/pipeline questions, 'oppsAmount,desc' for influenced pipeline, 'conversionRate,desc' for conversion rate, 'internalStatus,desc' for a | | `goals` | string | | Campaign goal type. RULES: 'CPL' for Lead Generation campaigns, 'CTR' for Brand Awareness campaigns. Do NOT include for unspecified campaign types. When multiple metrics involved, use only the first metric's corresponding goal.one of: `CPL`, `CTR` | | `name` | object | | Experiment name filter, matched as ONE substring per request. Use 'name' field (NOT experimentName) for specific experiment questions. Can be a single string or an array of strings for multiple experiments; an array is queried one name per request and the results are merged. Do NOT add additional pa | | `campaignName` | object | | Campaign name filter. Use when question is about specific campaign(s). Can be single string or array ['campaign1', 'campaign2'] for multiple campaigns. Do NOT include additional parameters when filtering by specific campaign name. | | `audienceName` | string | | Filter by target audience name (e.g., 'WTS EMEA Jan25_EMEAPitchbook') | | `offerName` | string | | Filter by specific offer name (e.g., 'AMER_ZO_EN_HBR Reimagining Work'). Use this field when question mentions specific offers. | | `adName` | string | | Filter by specific ad name (e.g., 'Sifted_WorkShift_Ad5_Beige'). Use 'adName' field when question asks about specific ad names. | | `audienceTypes` | string | | Comma-separated list of audience types (e.g., 'Spotlight Retargeting Contacts (Dynamic),Technographic (Aberdeen)') | | `imageLibraryName` | string | | Filter by creative/image name (e.g., 'JP - Square-Ad15.png'). Use 'imageLibraryName' field when question asks about specific creative names. | | `offerTypes` | array | | Offer types filter. RULES: ['LP'] for lead gen forms/landing pages questions, ['LP', 'LG'] as default when offer types mentioned. LP=Landing Pages, LG=Lead Gen forms. Should NOT be empty when included. | | `channels` | array | | Marketing channels to include | | `visibilities` | array | | Visibility status filter | | `launchedExperimentStatuses` | array | | Filter experiments by launch status. DEFAULT when omitted: successfully-launched experiments only (Active, WithoutSpend, Paused, Completed) — Failed and Disconnected are EXCLUDED, because a failed/non-launched experiment has 0 leads and is a non-starter, not a 'bottom performer'. Pass values explici | | `timeFrame` | string | | Timeframe aggregation. CRITICAL RULES: Use ONLY for WEEK or QUARTER questions. NEVER use 'YEAR' - use startDate/endDate instead. If timeFrame is included, DO NOT add startDate or endDate parameters under any circumstances.one of: `WEEK`, `QUARTER` | | `startDate` | string | | Start date in ISO 8601 format (e.g., '2024-10-18T00:00:00.000Z'). CRITICAL: Do NOT include if timeFrame parameter is used. Use last year of data if period cannot be inferred from question. For specific campaigns/experiments without timeframe, omit this parameter. | | `endDate` | string | | End date in ISO 8601 format. Must end on last hour of date (e.g., '2024-11-21T23:59:59.999Z'). CRITICAL: Do NOT include if timeFrame parameter is used. For specific campaigns/experiments without timeframe, omit this parameter. | ## Request **Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool. ## Response Real, from the production server, in **1262 ms**. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned. ## Related Other analytics tools: - [account_funnel_reports](https://metadata.io/developers/tools/account_funnel_reports) Read - [account_level_stats](https://metadata.io/developers/tools/account_level_stats) Read - [account_list_performance](https://metadata.io/developers/tools/account_list_performance) Read - [budget_group_performance](https://metadata.io/developers/tools/budget_group_performance) Read - [deep_funnel_stats](https://metadata.io/developers/tools/deep_funnel_stats) Read - [demographic_country_stats](https://metadata.io/developers/tools/demographic_country_stats) Read - [get_account_opportunities_insights](https://metadata.io/developers/tools/get_account_opportunities_insights) Read - [get_account_summary_insights](https://metadata.io/developers/tools/get_account_summary_insights) Read [Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)