Ads management

The ads module is a meta-layer over the ad platforms — Facebook, Google, TikTok, LinkedIn, Pinterest, Snapchat. You author a campaign once, target one or more channels, and the module pushes the right shape to each platform's API. Performance metrics flow back through the sync jobs and roll up into a unified view.

Campaign CRUD

{
  "name": "Black Friday 2026",
  "objective": "conversions",
  "platforms": ["facebook", "google", "tiktok"],
  "budget": { "type": "daily", "amount": 250, "currency": "USD" },
  "audienceIds": ["aud-vip", "aud-cart-abandoned"],
  "creativeIds": ["cre-bf-video-1", "cre-bf-static-1"],
  "schedule": { "startAt": "2026-11-24T00:00:00Z", "endAt": "2026-11-30T23:59:59Z" }
}

Lifecycle controls

Launch pushes the campaign to every platform listed in platforms. Pause/resume cascades to all of them. Duplicate copies the spec — useful for A/B tests where you change one variable.

Bulk variants exist for batch operations:

Creatives

A creative bundles the asset (image, video, carousel) plus headline, description, and call-to-action. The same creative can be referenced by multiple campaigns; the platform handles per-channel resizing and format conversion at launch.

Custom audiences

Ad audiences are distinct from CRM audiences (see Audiences and segmentation). An ad audience is what the ad platform sees — a list synced via customer-match upload, a pixel-based retargeting rule, or a lookalike. You can seed one from a CRM audience via the sourceAudienceId field.

Connected accounts

Lists ad accounts the org has connected. sync pulls latest account metadata (name, currency, timezone, business manager) from each platform. Connect new accounts via the OAuth flow.

Performance

Metrics include impressions, clicks, CTR, CPC, spend, conversions, ROAS, and per-platform breakdowns. Data freshness depends on each ad platform's reporting API — Facebook and Google update hourly, TikTok every few hours, LinkedIn daily.

Automation rules

Define conditional rules: "pause any ad set with CPC > $5 over the last 24 hours", "increase budget 20% if ROAS > 4 for 3 days". Rules run on a sync cycle and use the Rule Engine for evaluation.

Templates and reports

Templates capture a reusable campaign skeleton. Reports can be scheduled and exported to CSV or PDF.