TikTok Ads connection

What it reads

For each connected ad account, Growth Dept MTA reads spend, impressions and clicks by ad and day for auction ads in every status, with the names and IDs of campaigns, ad groups and ads.

It also reads hourly spend, view-through conversions, and TikTok's own reported purchases (complete_payment) and their value, which fill the TikTok platform-reported columns.

A pull runs about once an hour and re-reads the last 7 days, and a nightly pull re-reads the last 30. Each pull replaces the rows for its window, so days that TikTok restates end up matching TikTok. Spend is converted to the brand's currency as it arrives, at the European Central Bank rate for each day.

Connecting

1. Sign in to Growth Dept MTA as an owner or admin of the brand's organization. Other members can see Settings > Connections but cannot change it.
2. Open Settings > Connections and click Connect on the TikTok Ads card.
3. TikTok shows its own sign-in and permission screen. Sign in as a TikTok user who can see the ad accounts you want, and approve the request.
4. Back in Growth Dept MTA, the page lists every ad account that login reaches. Tick the ones that belong to this brand and click Connect.
5. Each account you chose appears on the card, and a backfill starts over the brand's lookback window (Settings > Lookback window), or as far back as TikTok keeps data if that is shorter. Scheduled pulls take over from there.

To add accounts later, click Connect beside Link an additional ad account on the same card. If the list comes up empty, the login you used reaches no ad accounts: connect again as a user who has access to them.

If you have been sending TikTok Ads spend through the spend API or a spreadsheet, remove those rows before you connect. They carry their own account ID, so they would be counted on top of the connected account's spend. Settings > Data Spreadsheets lists each upload. Once the connection is live, the spend API and spreadsheets refuse new TikTok Ads rows.

If the card says “TikTok Ads connection is not set up on this server yet.”, the Connect button stays off until Growth Dept registers its TikTok app. Email support@growthdept.ai if you see it.

Tracking parameters

Add these parameters to the URL of each TikTok ad. TikTok also adds its own click ID, ttclid. Settings > UTM guide in Growth Dept MTA shows the same string with a copy button.

utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_term=__AID_NAME__&utm_content=__CID_NAME__&nbt=nb:tiktok::__CAMPAIGN_ID__:__AID__:__CID__

Limits

• Growth Dept MTA only reads from TikTok. It does not change campaigns, budgets or ads.
• TikTok's reported conversions are TikTok's own credit, under TikTok's attribution settings. They fill the TikTok platform-reported columns and are not part of Growth Dept MTA's attribution.
• When TikTok flags a report as cut short by its rate limits, the pull fails rather than keep the shortened report, and a later pull reads those days again.
• If TikTok rejects the stored token, or refuses to refresh it, the account's row on the card shows the error, and the account has to be connected again.

Disconnecting

Each linked account has its own Disconnect button in its row on the TikTok Ads card. Only owners and admins can use it. After you confirm:

• Syncing for that account stops.
• The stored access token is deleted.
• Data already pulled stays in your reports.

Connecting the account again later starts a new backfill.