Adspirer icon

Adspirer

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

Actions119

Explain Meta Anomaly

AI-generated

Summary

Analyze a specified metric's anomaly within a chosen Meta Ads account over a defined time period, optionally returning raw data without additional commentary.

Inputs

  • Platform (required) — Select the advertising platform; must be 'Meta Ads' for this operation.
  • Ad Account Id (required) — The Meta Ad Account ID to analyze.
  • Metric (required) — The metric to analyze for anomalies, such as 'roas', 'ctr', 'cpc', 'cpm', 'conversions', 'conversion_rate', 'frequency', or 'reach'.
  • Period Start (required) — Start date (ISO format YYYY-MM-DD) of the anomaly period to analyze.
  • Period End (required) — End date (ISO format YYYY-MM-DD) of the anomaly period to analyze.
  • Raw Data — Boolean flag to return only raw metrics data as a JSON code block without severity labels, suggested bids/budgets, benchmarks, or recommendations.

Output shape

a structured JSON object containing an analysis or explanation of the anomaly for the specified metric and time period within the given Meta Ads account; or raw metrics data if requested.

Output content varies: if 'Raw Data' is true, only raw metric data is returned without additional contextual labels or recommendations; otherwise, the response includes severity labels, suggested bids/budgets, industry benchmarks, and optimization recommendations as applicable.

Examples

Example 1: Identify unusual changes in CTR for a Meta Ads account during a specific week.

Set Platform to 'Meta Ads'; provide the Ad Account ID; set Metric to 'ctr'; define Period Start and Period End for the week; optionally set Raw Data to false to get full analysis.

Links

Discussion