Actions119
- Analyze Search Terms
- Analyze Wasted Spend
- Explain Performance Anomaly
- Get Benchmark Context
- Get Business Profile
- Get Campaign Performance
- Get Campaign Structure
- Get Campaign Targeting
- Get Pmax Audience Signals
- Get Pmax Search Themes
- Get Usage Status
- Help User Upload
- Infer Business Profile
- List Campaign Extensions
- List Campaigns
- Optimize Budget Allocation
- Pause Ad
- Pause Campaign
- Remove Pmax Audience Signal
- Resume Ad
- Resume Campaign
- Save Business Profile
- Search Audiences
- Select Google Campaign Type
- Update Bid Strategy
- Update Campaign
- Update Keyword
- Validate Video
- Analyze Meta Ad Performance
- Analyze Meta Audiences
- Analyze Meta Wasted Spend
- Browse Meta Targeting
- Detect Meta Creative Fatigue
- Discover Meta Assets
- Duplicate Meta Campaign
- Explain Meta Anomaly
- Get Meta Ad Creatives
- Get Meta Audience Insights
- Get Meta Campaign Details
- Get Meta Campaign Performance
- Get Meta Lead Form Submissions
- List Meta Ad Sets
- List Meta Ads
- List Meta Campaigns
- List Meta Custom Audiences
- List Meta Instagram Accounts
- List Meta Lead Forms
- List Meta Pixels
- Optimize Meta Budget
- Optimize Meta Placements
- Pause Meta Campaign
- Resume Meta Campaign
- Select Meta Campaign Type
- Update Meta Ad
- Update Meta Campaign
- Add Linkedin Creative
- Add Linkedin Text Creative
- Add Linkedin Video Creative
- Analyze Linkedin Creative Performance
- Analyze Linkedin Wasted Spend
- Associate Linkedin Conversion
- Delete Linkedin Creative
- Discover Linkedin Assets
- Explain Linkedin Anomaly
- Explain Linkedin Objectives
- Generate Linkedin Ad Creatives
- Get Linkedin Campaign Performance
- Get Linkedin Campaign Structure
- Get Linkedin Campaign Targeting
- Get Linkedin Engagement Metrics
- Get Linkedin Organizations
- List Linkedin Campaign Groups
- List Linkedin Campaigns
- List Linkedin Conversions
- List Linkedin Creatives
- Manage Linkedin Conversions
- Optimize Linkedin Budget
- Pause Linkedin Campaign
- Pause Linkedin Creative
- Resume Linkedin Campaign
- Resume Linkedin Creative
- Search Linkedin Targeting
- Select Linkedin Campaign Type
- Update Linkedin Campaign Budget
- Update Linkedin Campaign Group
- Update Linkedin Campaign Schedule
- Update Linkedin Creative
- Analyze Tiktok Geo Performance
- Analyze Tiktok Wasted Spend
- Detect Tiktok Creative Fatigue
- Discover Tiktok Assets
- Explain Tiktok Anomaly
- Get Tiktok Ad Performance
- Get Tiktok Audience Insights
- Get Tiktok Campaign Details
- Get Tiktok Campaign Performance
- List Tiktok Ad Groups
- List Tiktok Ads
- List Tiktok Campaigns
- Optimize Tiktok Budget
- Pause Tiktok Ad
- Pause Tiktok Ad Group
- Pause Tiktok Campaign
- Resume Tiktok Ad
- Resume Tiktok Ad Group
- Resume Tiktok Campaign
- Update Tiktok Campaign
- Audit Conversion Tracking
- Delete Monitor
- Get Connections Status
- Get Monitor History
- Get Research Status
- List Connected Accounts
- List Monitors
- List Pending Actions
- List Scheduled Tasks
- Manage Action
- Manage Scheduled Task
- Test Monitor
Optimize Meta Placements
AI-generatedSummary
Optimize Meta Ads placements by analyzing campaign data within a specified date range to recommend an optimal mix of placements based on a campaign objective such as conversions, traffic, or awareness.
Inputs
- Platform (required) — The advertising platform to optimize, must be 'Meta Ads' for this operation.
- Ad Account Id (required) — The Meta Ad Account ID for which to perform the optimization.
- Date Range — A preset date range for data analysis (e.g., 'last_7_days', 'last_30_days').
- Start Date — The start date (YYYY-MM-DD) of the custom date range for analysis.
- End Date — The end date (YYYY-MM-DD) of the custom date range for analysis.
- Lookback Days — Number of days to analyze (7, 14, 30, 60, or 90), which can be used instead of or along with start/end dates.
- Objective — Campaign optimization objective: 'conversions' (default), 'traffic', or 'awareness'.
- Raw Data — Boolean flag to return only raw campaign metrics in JSON format rather than optimization recommendations.
- Target Roas — Optional numeric target ROAS override (e.g., 3.0 for 3.0x ROAS).
Output shape
a JSON object containing either optimized Meta Ads placements recommendations or raw campaign metrics depending on the Raw Data parameter
If Raw Data is true, the output includes raw spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS by campaign, ad, and date as a JSON code block; otherwise, it returns a campaign objective-based optimal placements mix recommendation. Date filtering supports both presets and custom start/end dates or lookback days, which are optional and used as provided.
Examples
Example 1: Optimize Meta Ads placements for the last 30 days targeting conversions.
Platform set to Meta Ads, Ad Account Id provided, Lookback Days set to 30, Objective set to conversions, Raw Data false or omitted.
Example 2: Retrieve raw campaign metrics for a specific date range on Meta Ads.
Platform set to Meta Ads, Ad Account Id provided, Start Date and End Date set to desired range, Raw Data set to true.