Adspirer icon

Adspirer

Manage ad campaigns across Google, Meta, LinkedIn & TikTok Ads via the Adspirer REST API

Actions119

Detect Meta Creative Fatigue

AI-generated

Summary

Detect Meta Ads creative fatigue by analyzing campaign performance metrics over specified date ranges and thresholds to identify declining ad effectiveness.

Inputs

  • Ad Account Id (required) — The Meta Ad Account ID from which to retrieve ad performance data for analysis.
  • Ctr Decline Threshold — Numeric threshold for the CTR decline (between 0.10 and 0.50) used to flag creatives as fatigued. Leave blank to omit this filter.
  • Date Range — Predefined date range presets such as 'last_7_days', 'last_14_days', 'last_30_days', 'last_60_days', or 'last_90_days' to specify the period for analysis.
  • Start Date — Custom start date in YYYY-MM-DD format to set the beginning of the analysis period.
  • End Date — Custom end date in YYYY-MM-DD format to set the end of the analysis period.
  • Frequency Threshold Cold — Numeric frequency threshold for cold traffic audiences (between 2.0 and 8.0); leave blank to omit.
  • Frequency Threshold Retargeting — Numeric frequency threshold for retargeting audiences (between 4.0 and 10.0); leave blank to omit.
  • Lookback Days — Number of days (7, 14, 30, 60, or 90) to look back for analysis; leave blank to omit.
  • Raw Data — Boolean flag; if true, returns only the raw metrics as a JSON code block including spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, and ROAS broken down by campaign, ad, and date.

Output shape

a JSON object containing detected creative fatigue indicators, including metrics per campaign, ad, and date; optionally, only raw metrics if Raw Data is true.

Date range can be specified either with Date Range preset or Start Date and End Date. Numeric thresholds are optional and omitted if left blank. The operation specifically supports the Meta Ads platform and requires a Meta Ad Account ID. Output structure may vary between analyzed fatigue flags and raw metrics depending on the Raw Data input.

Links

Discussion