Tracking & Intelligence

ViewsBase separates internal creator tracking from competitor/reference tracking. This keeps payable creator work clean while still giving the campaign team a place to save outside examples and market context.

Tracking Modes

Individual video tracking is the default. Watched accounts are optional and disabled until an admin or editor turns them on.

Manual Video Tracking

Use manual tracking when you know the exact TikTok or Instagram post URLs.

Internal Posts

Open Posts -> Track Videos and paste one URL per line.

For internal creator posts:

• The post author is normalized and matched against active creators in the campaign
• If the creator handle does not exist, the row is blocked and the user should add the creator first
• If the creator is paused, new submissions are blocked
• Added posts appear in Posts immediately without a full page reload
• Stats are fetched right away when the platform API is available

Competitor Posts

Open Intelligence -> Track Video and paste competitor/reference URLs.

For competitor posts:

• No creator record is required
• Source author metadata is fetched when available
• Posts appear in Intelligence, not Posts
• Payment fields are suppressed
• Competitor posts are excluded from internal reports and payment summaries

Row-Level Outcomes

Bulk manual tracking is row-level. A mixed paste can partially succeed:

• Added - the row created a tracked video
• Already tracked - the campaign already has that post
• Duplicate input - the same URL was pasted more than once
• Invalid row - the URL cannot be parsed or the platform is unsupported
• Stat fetch failed - the video was added but the first stat fetch failed; retry from the row

This means one bad URL does not reject the whole batch.

Watched Accounts

Watched accounts discover recent and future posts from a TikTok or Instagram account.

Initial Import

When watching an account, choose how much history to scan:

• Do not fetch recent posts
• Last 5 posts
• Last 10 posts
• Last 15 posts
• Last 30 posts

The default is last 5 posts. Thirty posts is the maximum initial import option.

Ongoing Refresh

Watched accounts are checked on the normal 6-hour refresh. You can also click sync now for a specific account.

Each account has one of these states:

• Active - included in scheduled syncs
• Syncing - currently being checked
• Failed - last sync failed and shows an error
• Paused - saved but not synced

There is no delete action exposed for watched accounts. Pause an account when it should stop syncing.

Internal Creator Accounts

Watch an internal creator account from the expanded creator row. The account is tied to that creator, and imported posts use that creator's campaign terms.

If a creator is paused, their watched account is paused too. Existing posts stay in the campaign.

Competitor Accounts

Watch a competitor account from Intelligence. The account does not need a creator record, and imported posts stay in Intelligence.

Competitor account imports are useful for recurring market monitoring, not payment operations.

Platform Behavior

TikTok

TikTok tracking fetches:

• Views
• Likes
• Comments
• Shares
• Author handle and profile metadata when available
• Thumbnail and caption when available

Instagram

Instagram tracking fetches:

• Views when available
• Likes
• Comments
• Author handle and profile metadata when available
• Thumbnail and caption when available

Watched Instagram accounts import Reels only. Slideshows can lack public view counts, so they are not watched automatically. Admins can enter manual views only when platform views are unavailable, and they must include an audit note.

Duplicates

ViewsBase checks for duplicates inside the campaign before creating videos. The same post should not appear twice in one campaign.

Internal and competitor tracking are scoped by campaign, so another campaign can track the same public post independently.

Failure Handling

Tracking can fail when a post is private, deleted, malformed, rate-limited, or unavailable from the platform provider.

Failure states are shown on the affected row only. Other rows in the same batch keep their successful status.