> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect TikTok Ads

> Track TikTok ad campaigns in Hiveku

Bring your TikTok ad campaigns into Hiveku to track performance and report alongside your other paid channels.

<Info>
  TikTok Ads uses a manual token-paste flow — not OAuth. You create a developer app in TikTok's Marketing API portal, generate a long-term access token, and paste it into Hiveku with your advertiser ID.
</Info>

## Before You Start

* A [TikTok for Business](https://ads.tiktok.com) account
* Access to the TikTok Ads Manager advertiser account you want to connect
* A [TikTok Marketing API developer account](https://business-api.tiktok.com)

## Create a TikTok Developer App

<Steps>
  <Step title="Open the TikTok Marketing API portal">
    Go to [business-api.tiktok.com](https://business-api.tiktok.com). Sign in with your TikTok for Business account.
  </Step>

  <Step title="Create a new app">
    Navigate to **My Apps** and click **Create App**. Fill in:

    * App name — e.g., `Acme Hiveku`
    * App description
    * Required advertiser scopes (typically `Ad Account Management`, `Reporting`)

    TikTok reviews some apps — most read-only use cases are approved quickly.
  </Step>
</Steps>

## Generate an Access Token

<Steps>
  <Step title="Open your app settings">
    In **My Apps**, click into the app you created.
  </Step>

  <Step title="Generate a long-term access token">
    Use the TikTok flow to generate a long-term access token scoped to your advertiser account. In most apps this is done by:

    1. Starting the authorization flow from your app's dashboard
    2. Signing in with the TikTok account that has advertiser access
    3. Selecting which advertiser account(s) to grant access to
    4. Receiving an access token in the callback (or in the developer portal UI for simpler apps)

    Copy the token.

    <Warning>
      Access tokens are sensitive credentials. Don't share them or commit them to source control. Rotate them periodically for hygiene.
    </Warning>
  </Step>
</Steps>

## Find Your Advertiser ID

In [TikTok Ads Manager](https://ads.tiktok.com), open the account switcher or go to **Account Info**. The advertiser ID is a numeric string — copy it.

<Info>
  The Advertiser ID is a pure number. Don't confuse it with the account name or the app ID.
</Info>

## Connect in Hiveku

<Steps>
  <Step title="Open the integration">
    Go to **Marketing > PPC > Add Connection > TikTok Ads**.
  </Step>

  <Step title="Paste the token and advertiser ID">
    * **Access token:** the long-term access token from your TikTok developer app
    * **Advertiser ID:** the numeric ID from Ads Manager
  </Step>

  <Step title="Save">
    Hiveku validates the token against the TikTok Marketing API and saves the connection.
  </Step>
</Steps>

## What You Get

* **Campaign, ad group, and ad** metrics — spend, impressions, clicks, CTR, conversions
* **Creative-level performance**
* **Audience breakdowns** where available

Data refreshes on an ongoing schedule.

## Rotating the Token

If your token is revoked or you're rotating for hygiene:

<Steps>
  <Step title="Generate a new token">
    Go back through the TikTok authorization flow in your developer app.
  </Step>

  <Step title="Update in Hiveku">
    **Marketing > PPC > \[TikTok Ads connection] > Edit > paste new token > Save**.
  </Step>
</Steps>

## Connect Multiple Advertiser Accounts

Repeat the flow for each advertiser account. If the same TikTok user has access to multiple advertisers, the authorization flow typically lets you select which advertisers to authorize and issues a token scoped to those selections.

## Verify the Connection

* Connection status shows **Active**
* Campaigns list populates within a few minutes
* Metrics match TikTok Ads Manager (small delays are expected)

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid or expired token">
    Regenerate the access token from your TikTok Marketing API app. Make sure you're copying the access token, not an app secret or refresh token. Update it in Hiveku.
  </Accordion>

  <Accordion title="Wrong advertiser ID">
    The Advertiser ID is a numeric value only — not the advertiser name or app ID. Find it in TikTok Ads Manager under **Account Info**, or in the account switcher dropdown.
  </Accordion>

  <Accordion title="No data appears after connecting">
    New tokens can take a few minutes to propagate in TikTok's backend. If data still doesn't appear after 30 minutes, verify the campaign dates — some reporting endpoints only return data for campaigns active in the last N days.
  </Accordion>

  <Accordion title="'API not enabled' or 'feature not permitted'">
    Your TikTok developer app may not have the required permissions for certain endpoints (for example, detailed audience data). Check the scopes on your app in the Marketing API portal and request additional permissions if needed — some require TikTok approval.
  </Accordion>

  <Accordion title="Rate limit errors">
    TikTok enforces per-app rate limits. Space out requests or contact TikTok to request an increase if you have high-volume reporting needs.
  </Accordion>
</AccordionGroup>

## What's Next?

<CardGroup cols={2}>
  <Card title="Connect Meta Ads" icon="facebook" href="/how-tos/connect-meta-ads">
    Add Facebook and Instagram campaigns
  </Card>

  <Card title="Connect Google Ads" icon="google" href="/how-tos/connect-google-ads">
    Add Google Search and Display
  </Card>
</CardGroup>