AdspirerInstall

Summary

Detect TikTok ad creative fatigue by analyzing performance metrics over a specified date range for the given TikTok advertiser ID, optionally using custom frequency thresholds and lookback periods.

Inputs

• Platform (required) — Select 'TikTok Ads' as the advertising platform to enable TikTok-specific parameters.
• Advertiser Id (required) — TikTok advertiser ID whose ad creatives will be analyzed.
• Start Date — Start date in YYYY-MM-DD format to define the analysis period beginning.
• End Date — End date in YYYY-MM-DD format to define the analysis period ending.
• Frequency Threshold — Override the default frequency threshold (3.5) as a numeric value to customize detection sensitivity.
• Lookback Days — Number of days to look back for analysis; if omitted, defaults are applied.
• Raw Data — If set to true, returns raw metrics only as JSON without labels, recommendations, or benchmarks.

Output shape

a JSON object containing analysis results of TikTok ad creative fatigue, including severity labels, benchmark comparisons, and optimization recommendations unless Raw Data is true

Output varies depending on the Raw Data flag: when true, only raw metrics are returned in a JSON code block without additional commentary or recommendations.

Examples

Example 1: User wants to detect creative fatigue for TikTok ads of a specific advertiser over the past 30 days with default thresholds

Platform set to TikTok Ads, Advertiser Id provided, Lookback Days set to 30, other fields optional or left blank.

Example 2: User wants only raw metrics for further custom processing

Same as above but with Raw Data set to true.

Links

• n8n community nodes installation guide