--- 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." 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. OPTIONAL filter: omit it unless the question needs one. Useful when ranking Lead Generation performance and non-delivering experiments would be noise. Do NOT set it when the user asks about experiments with no spend, no leads or no results. | | `minLeads` | integer | | Minimum leads threshold. OPTIONAL filter: omit it unless the question needs one. Useful to keep only converting experiments in a Lead Generation ranking. Do NOT set it for Brand Awareness, nor when the user asks about zero-lead or 'no results' experiments. | | `minCpl` | integer | | Minimum cost per lead threshold (whole dollars). OPTIONAL filter: omit it unless the question needs one. It excludes every zero-lead experiment, whose CPL is undefined, so never pair it with minLeads=0 and never set it for Brand Awareness. | | `minAudienceSize` | integer | | Minimum audience size. OPTIONAL filter: omit it unless the question needs one. | | `minClicks` | integer | | Minimum clicks threshold. OPTIONAL filter: omit it unless the question needs one. Useful in a Brand Awareness ranking. Do NOT set it for Lead Generation. | | `minCpc` | integer | | Minimum cost per click threshold (whole dollars). OPTIONAL filter: omit it unless the question needs one. Do NOT set it for Lead Generation or unspecified campaign types. | | `page` | integer | | Page number for pagination (0-based). Use it with the 'size' you already sent to reach rows beyond the first page when 'totalElements' exceeds the rows returned. | | `size` | integer | | Number of results per page. 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 n | | `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. The platform knows only VISIBLE (live) and ARCHIVED; there is no HIDDEN value and sending one is rejected with a 400. | | `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 ## 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 - [create_linkedin_engagement_retargeting_audience](https://metadata.io/developers/tools/create_linkedin_engagement_retargeting_audience) Writes - [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 [Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)