How Ritsbo Auto Advertising Works

Auto Advertising is a Ritsbo automation that launches and manages ad campaigns on Facebook, Instagram, Google, and TikTok automatically, within a monthly budget you configure. This document explains the configuration, execution cycle, and safety mechanisms.

Auto Advertising is configured through the AutoAdvertisingSettings entity:

Auto Advertising supports four channels:

• Facebook — Meta Ads platform
• Instagram — via Meta Ads
• Google — Google Ads
• TikTok — TikTok Ads Manager

You select which channels to use via preferred_channels. The system will only launch campaigns on your selected channels.

The auto-advertising cycle runs via the runAutoAdvertisingCycle backend function on a scheduled basis. Each cycle:

1. Reads your AutoAdvertisingSettings to check if enabled and not paused
2. Calculates remaining budget: monthly_budget - spent_this_month
3. Checks if the maximum campaign count for the month has been reached
4. If budget and campaign count allow, launches a campaign on a preferred channel
5. Validates wallet/service balance via validateAutoServiceBalance
6. Charges the ad spend plus the service fee per campaign
7. Updates spent_this_month and appends to history
8. Pauses automatically when the budget is exhausted

Unlike percentage-based ad management fees, Ritsbo charges a flat fee per campaign in the $5–$10 range, configured via service_fee_per_campaign. This means:

• You know the exact fee before each campaign launches
• The fee does not scale with your ad spend
• Large budgets do not incur proportionally larger fees

Spending is tracked through two fields:

• spent_this_month — cumulative ad spend plus service fees in the current window
• month_start — the start date of the current budget window

The system resets spent_this_month at the start of each new month.

• Balance validation — funds are verified before each campaign
• Monthly budget cap — total spend cannot exceed the configured budget
• Campaign count cap — limits the number of campaigns per month
• Pause feature — instantly pause without losing configuration
• History log — every campaign event is recorded with date, name, channel, spend, fee, and status

The history array records every auto-advertising event, capped at 50 entries. Each entry includes:

• date — when the campaign launched
• campaign_name — the campaign name
• channel — which channel was used
• spend — the ad spend
• fee — the service fee charged
• status — completed, failed, or skipped
• billed_via — wallet or card

Auto Advertising and Auto Ordering are designed to work together:

• Auto Ordering keeps your store stocked with fresh products
• Auto Advertising drives traffic to those products
• Both run within separate budgets you control
• Both can be paused independently

Read How Auto Ordering Works for the companion system.

• How Ritsbo Auto Ordering Works
• How Ritsbo AI Agents Work
• Marketing Automation Stack (SEO Article)