Get detailed ads performance with attribution data for Facebook, Google, TikTok, Snapchat, Microsoft, Pinterest, or AppLovin. Returns TOP 50 ads by spend by default.

Key Features:

• Hierarchical structure: campaign → adset → ad
• Attribution-based metrics (orders, sales, ROAS)
• Platform-reported metrics for comparison
• Smart filtering by spend, performance, and aggregation level

Parameters:

• store_id (integer, required): Store identifier
• platform (string, required): Platform key - "facebook", "google", "tiktok", "snapchat", "microsoft", "pinterest", "applovin"
• last_x_days (integer, optional): Get ads report for the last X days (e.g., 30 for last 30 days, 0 for today only). Alternative to using absolute date_start/date_end.
• date_start (string, optional): Start date (YYYY-MM-DD, inclusive). Use with date_end or use last_x_days instead.
• date_end (string, optional): End date (YYYY-MM-DD, inclusive). Use with date_start or use last_x_days instead.
• attribution_model (string, optional): Attribution model - "last_click_per_channel" (default), "any_click", "first_click", "last_click"
• attribution_window_days (integer, optional): Attribution window in days (default: 180)
• min_spend (float, optional): Minimum spend filter (default: 0)
• sort_by (string, optional): Sort metric - "spend", "roas", "sales", "orders", "nc_roas" (default: "spend")
• sort_order (string, optional): Sort direction - "desc" or "asc" (default: "desc")
• limit (integer, optional): Max ads to return (default: 50)
• level (string, optional): Aggregation level - "all" (default), "campaign", "adset", "ad"

Aggregation Levels: