Overview
Connecting your TikTok Ads account lets you track ad spend, campaign performance, and return on ad spend (ROAS) directly in Dashboardly. This connection is optional and separate from connecting your TikTok Shop -- you can use Dashboardly without it, and connect anytime later.
For the initial signup and TikTok Shop connection flow, see Getting Started.
When to Connect
You can connect TikTok Ads in two places:
- During sign-up -- after connecting your TikTok Shop, you'll see an option to connect Ads
- From Settings -- go to Settings → Shops, find your shop, and click Connect TikTok Ads
How to Connect
- Click Connect TikTok Ads (from sign-up or Settings)
- You're redirected to TikTok's Ads authorization page
- Log in to your TikTok Ads Manager account
- Review and approve the permissions
- You're redirected back to Dashboardly
After authorization, Dashboardly will:
- Discover your advertiser accounts
- Sync TikTok Shop stores linked to that ads account
- Start importing the last 30 days of ad data
What Data Is Imported
Campaign Metrics
- Ad Spend -- total cost per campaign per day
- Revenue -- revenue attributed to ads
- Orders -- purchases attributed to ad campaigns
- Impressions -- how many times your ads were shown
- Clicks -- how many times your ads were clicked
- ROI -- return on investment, calculated as
(Revenue - Cost) / Cost - CTR -- click-through rate, calculated as
Clicks / Impressions
Product-Level Attribution
- Ad spend per product
- Revenue per product from ads
- ACoS -- Advertising Cost of Sales (
Ad Spend / Revenue) - TACoS -- Total Advertising Cost of Sales (
Ad Spend / Total Revenue)
Creative Metrics
- Performance data per ad creative
- Organic vs. paid creative breakdown
Where to See Ad Data
Marketing Dashboard
Navigate to Marketing in the sidebar to see:
- KPI Cards -- total ad spend, total ad revenue, overall ROI
- Spend vs. Revenue Chart -- visual comparison over time
- Top 5 Campaigns -- best-performing campaigns with spend and ROI
- Ad Analytics tab -- detailed filtering by campaign, product, or creative
Main Dashboard
Your main dashboard reflects ad metrics in relevant widgets when ads data is available.
Per-Shop Connections
TikTok Ads connections are managed per shop. If you have multiple shops:
- Each shop has its own ads connection
- Connect or disconnect ads independently per shop
- View ad data filtered by the currently active shop
Managing Your Connection
Disconnect (Pause)
- Go to Settings → Shops
- Click Disconnect next to TikTok Ads
- Historical data is preserved; new data stops importing
- You can reconnect anytime
Reconnect
- Click Reconnect to resume data import
- Import picks up from where it left off
Delete
- Completely removes the ads connection
- Revokes the access token on TikTok's side
Troubleshooting
Token expired
TikTok Ads tokens expire periodically. When this happens:
- You'll see a notification in Dashboardly
- Click Reconnect and complete the OAuth flow again
No data showing
- Ad data import may take a few minutes after connecting
- Ensure your TikTok Ads account has active campaigns
- Check that the correct shop is selected in the shop switcher