Integrating Tiktok Ads on Clarisights
Connect your TikTok Ads accounts to monitor campaign performance, video engagement, app installs, on-site/off-site conversions, and SKAN-attributed results across every TikTok ad format alongside the rest of your marketing stack.
At a glance
Authentication | OAuth 2.0 (TikTok Business Center) |
Permissions needed | Admin access to each connected ad account; Catalog Management or Ad Promotion access for any catalogs used |
Account discovery | Automatic on credential validation |
Data freshness | Daily |
Lookback window | 90 days (last 3 months) |
Backfill on connect | Last 90 days |
Timezone | Account native timezone |
Currency | Account native currency (auto-converted via Currency Conversion); both local and converted spend exposed |
Levels supported | Account · Campaign · Ad Group · Ad |
Limited rollout | No |
Prerequisites
An active TikTok Ads account managed in TikTok Ads Manager or TikTok Business Center
Admin permissions to all ad accounts you want to connect (a Business Center Admin role does not automatically grant admin access to individual assets — check each ad account)
Catalog Management or Ad Promotion access on any catalogs used by the connected ad accounts (required for catalog-driven dimensions like Catalog ID and product feed metrics)
Permission to authorize third-party apps on your TikTok profile
Need to grant or check access?
Steps to Connect
Step 1 — Start the connection from Clarisights
In Clarisights, go to Integrations and click + Connect below the TikTok icon.
[TODO: Screenshot needed — Clarisights Integrations page with the TikTok “+ Connect” button highlighted]
Step 2 — Authorize Clarisights on TikTok
You will be redirected to TikTok to log in and approve the access scopes Clarisights needs (read access to ad accounts, campaigns, ad groups, ads, reports, audiences, creatives, and catalog data). Approve the request to continue.
[TODO: Screenshot needed — TikTok OAuth permission screen]
⚠ Common error: “Authorization Failure / no permission for advertiser.” → The TikTok user you authorized does not have admin permissions on one or more selected ad accounts. Ask a Business Center admin to assign the correct asset-level role and re-run the connection.
⚠ Common error: “Missing scopes.” → You unchecked one or more permissions on the TikTok consent screen. Restart the flow from Clarisights and accept all requested scopes.
Step 3 — Wait for the redirect back to Clarisights
Do not refresh or close the window. TikTok will redirect you back to the Integrations page once authorization completes.
[TODO: Screenshot needed — Account selection screen after OAuth redirect]
Step 4 — Select the ad accounts to connect
Clarisights automatically discovers every advertiser ID your TikTok user has access to. Select the accounts you want to connect, optionally rename them, and confirm.
Step 5 — Manage connected accounts
Connected accounts appear on the Integrations page with controls to enable / disable each account and to refresh the user’s access token.
[TODO: Screenshot needed — Connected TikTok accounts list]
Verify the connection
Go to Integrations → TikTok. Each selected account should show a “Connected” status.
Initial backfill covers the last 3 months and typically populates within 24 hours of the next scheduled sync.
Quick start: create a new report, add TikTok as the data source, and add Account · Campaign · Impressions · Clicks · Cost.
Data available
Hierarchy
How TikTok’s native levels map to the standard Clarisights levels:
Native level (TikTok) | Clarisights level |
Advertiser (Ad Account) | Account |
Campaign | Campaign |
Ad Group | Ad Group |
Ad | Ad |
Dimensions
Dimension | Level |
Account | Account |
Account ID | Account |
Account Balance | Account |
Campaign | Campaign |
Campaign ID | Campaign |
Campaign Status | Campaign |
Campaign Objective | Campaign |
Advertising Objective | Campaign |
Campaign Budget | Campaign |
Campaign Budget Mode | Campaign |
Campaign Start Date | Campaign |
Campaign Type | Campaign |
Smart Performance Status | Campaign |
Campaign Product Source | Campaign |
Adgroup | Ad Group |
Adgroup ID | Ad Group |
Ad Group Budget | Ad Group |
Ad Group Budget Mode | Ad Group |
Ad Group Optimize Goal | Ad Group |
Ad Group Status | Ad Group |
Ad Group Billing Event | Ad Group |
Ad Group Bid | Ad Group |
Ad Group Pace | Ad Group |
Ad Group Placement Type | Ad Group |
Ad Group Language | Ad Group |
Ad Group Operating System | Ad Group |
Ad Group Create Date | Ad Group |
Ad Group Start Date | Ad Group |
Ad Group End Date | Ad Group |
Ad Group Optimization Event | Ad Group |
Catalog ID | Ad Group |
Ad | Ad |
Ad ID | Ad |
Ad Status | Ad |
Ad Image Mode | Ad |
Ad Format | Ad |
Ad Start Date | Ad |
Ad Text | Ad |
Video ID | Ad |
Vertical Video Strategy | Ad |
ACO Status | Ad |
Ad Preview | Ad |
Metrics
Spend
Metric | Description |
Cost | Total spend converted to reporting currency |
Cost (Local Currency) | Spend in the account’s native currency |
Cost Charged by Cash / Cost Charged by Voucher | Cash- and voucher-funded portions of spend, in both reporting and local currency |
Core delivery
Metric | Description |
Impressions / Gross Impressions | Total ad impressions and pre-filtering gross impressions |
Clicks / Clicks (All) | Click-through count, plus any-engagement clicks |
Reach | Unique users reached |
Result / Real-time Result / Secondary Goal Result | Optimization-event results |
Conversions / Real-time Conversions | Total conversions and intra-day real-time count |
Video engagement
Metric | Description |
Video Views | Total video plays |
2-Second / 6-Second Video Views | Threshold-based view counts (continuous variants available) |
Video Views at 25% / 50% / 75% / 100% | Quartile completion counts |
6-second / 15-second Focused Views | Engaged-view variants |
Video Average Watch Time Per Video View / Per Person | Average watch duration |
Total Video Watch Time / Total Video Play Per Person Watch Time | Aggregate watch time |
Social engagement (paid)
Metric | Description |
Paid Likes / Comments / Shares / Follows | Engagements driven by ad spend |
Profile Visits | Visits to the brand profile |
Music Clicks / Duet Clicks / Stitch Clicks / Sound Usage Clicks | TikTok-specific creator-action clicks |
Anchor Clicks / Clicks on Hashtag Challenge | Anchor and challenge interactions |
Engaged View-Through Conversions | Conversions attributed to engaged views |
App events (in-app)
Metric | Description |
App Install / Real-time App Install | App installs and intra-day count |
Registration / Login / Subscribe / Start Trial / Search / Rate | Standard app events with Total / value variants |
Purchase / Add to Cart / Checkout / View Content / Add Payment Info / Add to Wishlist | Commerce-funnel events with Total / value variants |
Launch App / Complete Tutorial / Achieve Level / Generate Lead | Onboarding and lead-gen events with Total / value variants |
Day 2 Retention | Next-day open count |
In-App Ad Click / In-App Ad Impression | For apps that monetise via ads, with Total / value variants |
Create Group / Join Group / Create Role / Spend Credit / Unlock Achievement / Loan Apply / Loan Approval / Loan Disbursement | Gaming and finance app events with Total / value variants |
Custom App Event / Total Custom App Event Value | Customer-defined app events |
Web events (pixel)
Metric | Description |
Page View / Total Page View / Total Landing Page View | Page-load events |
Click Button / Submit Form / Download / Search / Contact / Complete Registration | Standard web events with value variants |
View Content / Add to Cart / Add to Wishlist / Initiate Checkout / Add Payment Info / Place an Order / Subscribe / Complete Payment | Commerce-funnel web events with value variants |
Custom Page Event / Total Custom Page Event Value | Customer-defined web events |
On-site Shop / Live
Metric | Description |
Total Purchases / Total Initiate Checkout / Total Product Details Page View | TikTok Shop on-site funnel events with value variants |
Total Add to Cart / Total Add to Wishlist / Total Add Billing | On-site cart events with value variants |
Total Form Submission / Total App Store Click / Total Destination Visit | On-site engagement events |
LIVE Views / LIVE Unique Views / Effective LIVE Views / LIVE Product Clicks | TikTok LIVE engagement metrics |
Playlist Page Visit | Visits to the brand’s playlist page |
Instant Experience & Add-ons
Metric | Description |
Instant Experience Video Component Views (25% / 50% / 75% / 100%) | Quartile views of Instant Experience videos |
Page Views / Outbound Clicks / Product Clicks (Instant Experience) | Instant Experience interactions |
Interactive Add-on Impressions / Destination Clicks / Activity Clicks | Add-on visibility and engagement |
Interactive Add-on Option A / Option B Clicks | Multi-option add-on choices |
Countdown Sticker Recall Clicks | Engagements with countdown stickers |
SKAN (iOS attribution)
Metric | Description |
App Install (SKAN) / App Installs (SKAN Privacy Withheld) | SKAN-attributed app installs and crowd-anonymised counts |
Conversions (SKAN) / Conversions (SKAN click time) | Total and click-time SKAN conversions |
Result (SKAN) / Registration / Purchase | Goal-event variants attributed via SKAN |
Conversions / App Install / Registration / Purchase (SKAN VTA & CTA) | View-through and click-through SKAN attribution |
Unique & Total SKAN events | Unique and total variants for Add to Cart, Checkout, View Content, Add Payment Info, Add to Wishlist, Launch App, Complete Tutorial, Achieve Level, Generate Lead, In-App Ad Click / Impression, Login, Rate, Search, Start Trial, Subscribe, Create Group, Join Group, Create Role, Spend Credit, Unlock Achievement, Loan Apply / Approval / Disbursement — with value variants |
View-through & click-through (non-SKAN)
Non-SKAN VTA / CTA variants are exposed for Conversions, App Install, Registration, and Purchase.
Offline events
For advertisers uploading offline conversion data, the following are exposed with value variants: Complete Payment, Contact, Subscribe, Submit Form, Add Payment Info, Add to Cart, Add to Wishlist, Click Button, Complete Registration, Download, Initiate Checkout, Place an Order, Search, View Content.
Custom conversions
Each custom conversion configured in TikTok Events Manager appears in Clarisights with the same naming as the source event.
Limitations & known constraints
Asset-level permissions: a Business Center Admin role does not automatically grant admin access to ad accounts or catalogs. If you connected the integration but some ad accounts are missing, verify the authorising user has admin access to each asset.
Catalog-driven dimensions: Catalog ID and product-feed details require the authorising user to hold Catalog Management or Ad Promotion access on the relevant catalogs.
Reporting delay: TikTok metrics are typically available within 24 hours but can take up to 48 hours to fully reconcile, especially for SKAN and offline-conversion metrics.
SKAN postback windows: SKAN metrics arrive on TikTok’s postback schedule and may be partially populated for the most recent days.
Reservation TopView: data for reservation buying-type campaigns is fetched separately and follows a different cadence than auction campaigns.
Token revocation: if a user revokes Clarisights’ access in TikTok Business Center, the integration stops syncing until the token is refreshed from the Integrations page.
Ad previews: Not available for 'Spark' Ads
Operating notes
Refresh schedule: data is pulled daily at the account, campaign, ad group, and ad levels.
Lookback: rolling 90 days; older data is not refreshed unless a manual backfill is requested via Clarisights support.
Ad Previews: Clarisights renders ad previews directly from TikTok and refreshes them with each daily pull. Previews are subject to the same access requirements as the underlying ad asset.
Adding new ad accounts: when a new advertiser ID is granted to your TikTok user, return to the Integrations page and reopen the TikTok integration to discover and select it.
Currency conversion: TikTok returns spend in the account’s native currency. Clarisights stores both the local-currency value and a converted value in your reporting currency.
Credential rotation: refresh the access token from the Integrations page if a user’s TikTok password changes or an “invalid_token” error appears against an account.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and account ID (Integrations → TikTok)
The exact error message or screenshot
The step where the issue occurred
When the issue started