🚀 Auto-Boost & Paid Ads
Integrate your ad accounts to automatically promote your best content. OmniSocial AI monitors post performance in real-time and boosts content that meets your criteria — so you never miss a viral moment.
Connecting Ad Accounts​
- Go to Settings > Ads
- Connect your Meta Ads Manager (Facebook/Instagram) or TikTok Ads account
- Set a default budget and audience targeting
Once connected, ad campaigns are tracked as AdCampaign records:
| Field | Description |
|---|---|
platform | Ad platform (Meta, TikTok) |
socialAccountId | The connected social account |
platformAdId | The ad ID on the platform |
status | PENDING, ACTIVE_AD, PAUSED_AD, COMPLETED_AD, or FAILED_AD |
budget | Campaign budget amount |
currency | Budget currency |
duration | How long the ad runs |
targetingConfig | JSON object with audience targeting rules |
impressions | Total ad impressions |
clicks | Total clicks |
spend | Actual amount spent |
conversions | Total conversions tracked |
Auto-Boost Rules​
Auto-Boost rules continuously monitor your post performance and automatically create paid promotions when posts meet your criteria.
Creating a Rule​
Each rule is stored as an AutoBoostRule:
| Field | Description |
|---|---|
name | Rule name (e.g., "Boost viral Reels") |
isActive | Whether the rule is currently enabled |
platform | Which platform to monitor |
metric | The metric to watch (likes, comments, shares, engagementRate, reach, etc.) |
operator | Comparison operator (gt, gte, lt, lte, eq) |
threshold | The target value (e.g., 100 likes, 5% engagement rate) |
timeWindowHours | Time window for evaluation (e.g., "within 2 hours of publishing") |
budget | Budget to allocate per boost |
currency | Budget currency |
duration | How long the boosted ad should run |
targetingConfig | JSON audience targeting configuration |
maxBoostsPerDay | Safety cap to prevent overspending |
Example Rules​
| Rule | Configuration |
|---|---|
| "Boost posts with 100+ likes in 2 hours" | metric: likes, operator: gt, threshold: 100, timeWindowHours: 2, budget: 25 |
| "Promote high-engagement product posts" | metric: engagementRate, operator: gte, threshold: 5, timeWindowHours: 6, budget: 50 |
| "Auto-boost Reels with high reach" | metric: reach, operator: gt, threshold: 10000, timeWindowHours: 12, budget: 30 |
Always set maxBoostsPerDay to prevent runaway spending. If multiple posts meet your criteria on the same day, the system respects this cap and prioritizes the highest-performing posts.
Manual Promotion​
You can also manually boost any post by selecting it and clicking Boost:
- Budget — Set the amount to spend
- Duration — How long the promotion runs
- Targeting — Define your audience (demographics, interests, lookalike)
- Objective — Choose between reach, engagement, or conversions
This creates an AdCampaign with status PENDING, which transitions to ACTIVE_AD once the platform approves it.
Ad Campaign Lifecycle​
| Status | Description |
|---|---|
PENDING | Ad submitted, waiting for platform approval |
ACTIVE_AD | Ad is live and running |
PAUSED_AD | Ad temporarily paused |
COMPLETED_AD | Ad finished its scheduled duration |
FAILED_AD | Ad was rejected or encountered an error |
When a boost_post action fires (either from an Auto-Boost rule or a workflow), the system creates an AdCampaign record, submits the promotion to the platform's API, and begins tracking impressions, clicks, spend, and conversions in real-time.
Ad Performance Tracking​
Track ad spend and ROI in Analytics > Ads:
| Metric | Description |
|---|---|
| Impressions | Total times the ad was shown |
| Clicks | Total ad clicks |
| Spend | Total amount spent |
| Conversions | Total attributed conversions |
| Cost per Engagement | Spend / total engagements |
| Cost per Click (CPC) | Spend / clicks |
| Return on Ad Spend (ROAS) | Revenue / spend |
| Reach: Paid vs. Organic | Comparison of boosted reach vs. organic reach |
Compare the ROAS of auto-boosted posts vs. manually promoted ones to fine-tune your Auto-Boost rules. The AI Advisor also provides recommendations for optimizing your ad spend.
Integration with Workflows​
The boost_post action is available as a node in the Workflow Builder. This gives you more flexibility than standalone Auto-Boost rules because you can:
- Chain conditions (e.g., boost only Reels on Instagram with engagement > 5%)
- Add delays (e.g., wait 3 hours, then check performance, then boost)
- Combine with other actions (e.g., boost AND send a notification to the team)
- Use AI content repurposing before boosting on a different platform
See Triggers & Actions for workflow configuration details.
Integration with Predictions​
Combine Auto-Boost with Predictive Analytics for proactive promotion:
- Posts with high virality scores can be boosted immediately rather than waiting for organic traction
- Posts with high predicted ROAS can receive larger ad budgets
- Posts with low predicted performance can be excluded from auto-boosting to save budget
Related Pages​
- Workflow Builder — Build complex automation flows that include boosting
- Triggers & Actions — Reference for the
boost_postaction node - Revenue Attribution — Track ROAS and conversions from boosted posts
- Predictions — Predict which posts deserve ad spend
- Dashboard — See ad performance in the overall analytics view