AdLoomly
DOCS

Documentation

Everything you need to connect a TikTok ad account, launch campaigns in bulk, and put your kill & scale rules on autopilot.

Early Access — docs expand as features ship
CORE

TikTok Integration

How AdLoomly connects through the official TikTok Marketing API: the OAuth 2.0 authorization flow, every scope we request and why, data flow & storage, rate limits, and revocation.

Read the doc →START HERE

Getting Started

From signup to your first automation rule in four steps. No credit card required during Early Access.

Jump to section ↓REFERENCE

Rule Reference

All rule conditions — metrics, operators, time windows — and every action a rule can take.

Jump to section ↓REFERENCE

Launch Reference

Supported objectives, ad formats, and the validation checks we run before anything hits your ad account.

Jump to section ↓

FAQ

Common questions, answered plainly.

Open FAQ →

Platform Status

Uptime and sync status of the platform.

Check status →
GETTING STARTED

Signup to first rule in four steps

1

Create your account

Sign up with your email — the Free plan needs no credit card. You land in an empty dashboard waiting for its first ad account.

2

Connect TikTok

Click Connect TikTok. You're sent to TikTok's own authorization page to review permissions and approve. We never see your password.

3

Pick your ad accounts

Choose which authorized ad accounts to bring into AdLoomly. Campaigns, ad groups, and spend metrics start syncing on your plan's interval.

4

Create your first rule

Build an IF/THEN rule — for example IF Spend > $50 AND Conversions = 0 → Pause Ad Group — and it evaluates 24/7 server-side.

RULE REFERENCE

Conditions and actions

Rules are IF/THEN statements: one or more conditions (combined with AND) trigger exactly one action. All metrics come from the TikTok Reporting API.

Conditions

MetricOperatorsTime windows
Spend>   <   ≥   ≤Today, yesterday, last 3 / 7 days, lifetime
CPA (cost per acquisition)>   <   ≥   ≤Today, yesterday, last 3 / 7 days
ROAS>   <   ≥   ≤Today, yesterday, last 3 / 7 days
CPM>   <   ≥   ≤Today, yesterday, last 3 / 7 days
Conversions=   >   <Today, yesterday, last 3 / 7 days
Clicks=   >   <Today, yesterday, last 3 / 7 days
Impressions=   >   <Today, yesterday, last 3 / 7 days
CTR>   <   ≥   ≤Today, yesterday, last 3 / 7 days

Actions

  • Auto-Stopped by RulePause ad group or campaign (kill rule)
  • ActiveActivate a paused ad group or campaign
  • Increase budget — by % or fixed amount, with a hard daily cap you set (scale rule)
  • Decrease budget — by % or fixed amount, with a floor
  • Adjust bid — by % or fixed amount
  • Notify only — send an alert without changing anything (email on Starter; Telegram/Slack on Pro)

Every execution is written to the audit log with a timestamp and a before/after diff.

LAUNCH REFERENCE

What the Campaign Launcher supports

Bulk-launch up to 50 ad groups per batch through the official TikTok Marketing API.

Objectives

  • • Conversions
  • • Traffic
  • • Lead Generation
  • • Product Sales
  • • App Promotion

Formats

  • • Single video (In-Feed)
  • • Single image (where placement allows)
  • • Spark Ads (boost existing organic posts via authorized post codes)

Validation before launch

  • • Budget within account limits and your configured caps
  • • Required fields present per objective (pixel/event for Conversions, etc.)
  • • Creative specs: aspect ratio, duration, file size
  • • Naming-convention templates applied consistently
  • • Dry-run preview of the full batch before anything is created