Adspirer icon

Adspirer

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

Actions119

Explain Tiktok Anomaly

AI-generated

Summary

Explain anomalies in TikTok Ads performance metrics for a specified advertiser over a given period, optionally returning raw metric data only.

Inputs

  • Platform (required) — The advertising platform to analyze. For this operation, must select 'TikTok Ads'.
  • Advertiser Id (required) — TikTok advertiser ID to identify the account for anomaly explanation.
  • Metric (required) — The specific performance metric to analyze, such as roas, ctr, cpc, cpm, conversions, hook_rate, or engagement_rate.
  • Period Start (required) — Start date of the anomaly period in YYYY-MM-DD format.
  • Period End (required) — End date of the anomaly period in YYYY-MM-DD format.
  • Raw Data — If true, returns only raw metric data as a JSON code block without additional context like severity labels or recommendations.

Output shape

a structured JSON object containing explanations of TikTok ad metric anomalies for the specified period and advertiser; or if 'Raw Data' is true, a JSON code block with only raw metric details without interpretive labels or suggestions.

The response includes severity labels, suggested bids/budgets, industry benchmarks, and optimization recommendations unless 'Raw Data' is set to true. The operation requires the 'Platform' to be 'TikTok Ads' to enable TikTok-specific inputs and outputs.

Links

Discussion