Adspirer icon

Adspirer

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

Actions119

Optimize Budget Allocation

AI-generated

Summary

Optimize advertising budget allocation across campaigns on the selected platform by analyzing historical performance data and applying constraints like max change percentage, minimum daily budget, and target ROAS.

Inputs

  • platform (required) — Advertising platform to optimize budgets for (Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, or Utility).
  • total_budget (required) — Total monthly budget amount in dollars to allocate across campaigns.
  • customer_id — Google Ads customer ID; required if platform is Google Ads.
  • date_range — Preset date range for historical data analysis, e.g., 'last_7_days', 'last_30_days' (Google Ads only).
  • start_date — Custom start date (YYYY-MM-DD) for historical data analysis (Google Ads only).
  • end_date — Custom end date (YYYY-MM-DD) for historical data analysis (Google Ads only).
  • lookback_days — Number of past days to analyze for performance; accepted values include 7, 30, 60, 90, or 120 (Google Ads only).
  • max_change_percentage — Maximum allowed budget change per campaign as a percentage (0.0-1.0), e.g., 0.3 for 30% (Google Ads only).
  • min_daily_budget — Minimum daily budget per campaign in dollars (Google Ads only).
  • target_roas — Optional override for target Return-On-Ad-Spend (ROAS), e.g., 3.0 for 3x ROAS (Google Ads only).
  • raw_data — Boolean flag; if true, returns only raw metric data (spend, clicks, conversions, etc.) without optimized allocation (Google Ads only).

Output shape

a JSON object containing optimized budget allocations across campaigns or, if raw_data is true, raw campaign performance metrics in a JSON code block.

Inputs related to Google Ads are only applicable when platform is 'googleAds'. Other platforms may have their own implicit handling or no parameters exposed here. The node requires 'total_budget' and 'platform' as mandatory inputs. The data and results are scoped to the time range specified by date_range or start_date/end_date. Output may vary by platform and 'raw_data' flag.

Examples

Example 1: Allocating $15,000 monthly budget across Google Ads campaigns based on past 30-days performance with constraints.

Platform: Google Ads; Customer Id: '123-456-7890'; Total Budget: 15000; Lookback Days: 30; Max Change Percentage: 0.3; Min Daily Budget: 30; Target Roas: 3.0

Links

Discussion