Skip to content

Documentation

Everything you need to go from a connected TikTok ad account to campaigns that optimize themselves. Most teams finish setup in under 15 minutes.

Quick start

  • Connect TikTok. Go to Settings → Integrations → TikTok for Business and sign in. Select the advertiser accounts you want Wecore Hub to manage.
  • Import a catalog. Add a Shopify store, WooCommerce site or a public XML/CSV feed URL. Map required fields (id, title, price, availability, image_link, link).
  • Set targets. Enter a target CPA or ROAS per workspace. Rules use these values as their baseline.
  • Review and launch. Approve the proposed campaign structure. The agent starts monitoring within 15 minutes.

Permissions

Wecore Hub requests the following TikTok Marketing API scopes, only for accounts you select:

  • Ad Account Management — read advertiser details and status
  • Ads Management — create and update campaigns, ad groups and ads
  • Reporting — read performance metrics
  • Creative Management — upload videos and read creative metadata
  • Catalog Management — create catalogs, sync products and product sets

You can revoke access at any time in TikTok Business Center or in Wecore Hub settings. See the Privacy Policy for how this data is used.

Catalogs

Feeds are re-synced every 6 hours (hourly on Growth and Agency). Products marked out of stock are removed from product sets before the next delivery window. Campaigns can be grouped by product_type, custom_label_0–4, price band or bestseller rank.

Agent rules

A rule has a condition, a time window and an action. Conditions can use spend, cpa, roas, ctr, cvr, frequency, hook_rate and budget_pacing. Examples:

  • IF cpa > target * 1.2 FOR 6h THEN budget -15%
  • IF roas >= 3.0 FOR 24h AND spend >= 200 THEN budget +20%
  • IF ctr < avg_7d * 0.65 THEN pause_ad, promote_next
  • IF budget_pacing >= 0.9 BEFORE 18:00 THEN notify whatsapp

The agent evaluates rules every 15 minutes. A condition must hold for the entire window before an action runs, and each object has a cooldown (default 6 hours) so changes have time to take effect.

Guardrails

  • Minimum data before acting: $100 spend or 20 conversions in the window (configurable)
  • Maximum budget change per object: ±30% per day
  • Ad groups in the learning phase are excluded from bid and budget changes
  • Approval mode queues actions for review instead of applying them
  • Every action is logged and can be reverted from the action log or by replying UNDO on WhatsApp

WhatsApp reports

Add recipients in Settings → Reports. Each number receives a one-time opt-in message. Choose daily summaries (sent at 09:00 in the workspace time zone), weekly recaps, and which real-time alerts to receive: ROAS drop, budget exhausted, winning creative, and agent actions awaiting approval.

Getting help

Email hello@wecorehub.com. We reply within one business day, typically much faster during UK and Brazil business hours.