Adspirer icon

Adspirer

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

Actions119

Optimize Meta Budget

AI-generated

Summary

Optimize the allocation of a total monthly budget across Meta advertising campaigns or ad sets to improve performance based on historical spend and conversion data.

Inputs

  • Platform (required) — Select 'Meta Ads' to use this operation; specifies the advertising platform.
  • Ad Account Id (required) — Meta Ad Account ID to target for budget optimization.
  • Date Range — Predefined date range to analyze historical performance, e.g., 'last_7_days' or 'last_30_days'.
  • Start Date — Custom start date (YYYY-MM-DD) for the performance data analysis period.
  • End Date — Custom end date (YYYY-MM-DD) for the performance data analysis period.
  • Lookback Days — Number of days to analyze for historical performance (7, 30, 60, 90, or 120).
  • Max Change Percentage — Maximum allowed fractional budget change per campaign (e.g., 0.3 for ±30%).
  • Min Daily Budget — Minimum allowed daily budget per campaign in US dollars.
  • Optimization Level — Target level for optimization; either 'campaign' (default) or 'ad_set'.
  • Raw Data — If true, returns only raw performance metrics (spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS) by campaign or ad and date as a JSON code block.
  • Target Roas — Optional override for target Return On Ad Spend (ROAS) as a numeric value (e.g., 2.0).
  • Total Budget (required) — Total monthly budget amount in US dollars to allocate across Meta campaigns or ad sets.

Output shape

a JSON object including optimized budget recommendations per campaign or ad set with associated performance metrics, or raw metrics if requested

The output is a JSON-formatted response with budget recommendations reflecting constraints and the specified optimization level. When 'Raw Data' is true, output contains only raw historical metrics without budget recommendations.

Links

Discussion