Runner AI
DocumentationAutomate, test, and create

Runner Ads

Connect supported ad accounts, read campaign performance, manage connections, and understand campaign creation paths.

Runner Ads brings supported ad-account reporting and campaign controls into the store project.

Entry path

Open a store project → MoreAdsOverview.

Before you start

  • Confirm the workspace has Ads access and an eligible plan.
  • Use an account that is authorized to connect the ad provider.
  • Know which provider and ad account belong to this business.
  • Connecting starts the provider's authorization flow; it is not complete until Runner shows the connected account.

Connection controls and click results

ControlWhat happens after you select it
Connect Google AdsOpens the secure Google authorization flow.
Connect Facebook & InstagramOpens the Meta authorization flow.
Connect TikTok AdsOpens TikTok authorization when that channel is enabled.
Cancel connectionCancels a provider authorization attempt that is still pending.
Connection settingsOpens connected-channel status plus the controls supported by that provider, such as connect, sync, reauthorize, or disconnect.
SyncRequests a fresh account list for that connection. It does not create a campaign.
ReauthorizeFor TikTok, starts authorization again when this control appears and the connection requires it.
DisconnectOpens a confirmation before removing Runner’s provider connection.

Connect an account

  1. Open AdsOverview.
  2. Select the correct provider button.
  3. Complete authorization in the provider window.
  4. Return to Runner and wait for account synchronization.
  5. Confirm the provider and account name appear in connection settings or the account picker.
  6. If the connection remains pending, wait for sync or use the visible retry path.
  7. Do not treat the initial button click as a completed connection.

Dashboard controls and results

Control or sectionWhat happens or appears
Time rangeRefreshes reporting for the past week, month, or broader recent period.
Account pickerFilters results when more than one connected account is available.
KPI cardsSummarize available ad metrics for the selected accounts and period.
Campaign tableLists campaign metrics and supported status controls.
Campaign Pause / EnableFor supported Google Ads or TikTok campaigns, requests the corresponding external status change. Meta campaigns do not show this control. Use it only when authorized and confirm the returned state.
Trend chartCompares selected campaign and account performance over time.
Activity feedShows available recent ad-account activity.
Create CampaignOpens a provider choice or campaign destination only when a supported creation channel is connected.

Campaign creation paths

  • With Google Ads connected, Create Campaign opens Runner’s four-step flow: Channel & Goal, Plan, Edit Campaigns, and Review & Publish.
  • With TikTok Ads connected, creation opens TikTok Ads Manager in a new tab rather than an in-app TikTok wizard.
  • With both available, the button opens a provider choice.
  • A Meta-only connection can provide reporting but does not show a campaign-creation destination in the current flow.
  • In the Google flow, Next advances after required fields are valid, Back returns to a completed step, and Publish Campaign sends the reviewed campaign to the provider.

Troubleshooting

StateMeaning and next step
WaitlistAds is disabled for the workspace. Joining or viewing the waitlist does not unlock it immediately.
Upgrade screenThe current plan cannot open the Ads workspace.
Authorization pendingThe provider window has not completed or returned. Finish it or cancel the attempt.
Reauthorization requiredFor TikTok, open connection settings and select Reauthorize when shown before expecting fresh data.
Data temporarily delayedKeep available partial data and retry later; avoid repeated provider requests.
Reporting unavailable for a channelThat connection cannot supply the requested report. Use supported channels or provider reporting.
Create button absentNo currently connected channel supports a creation destination.