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

# TikTok Ads Integration | Adspirer

> Create and manage TikTok ad campaigns with AI — 37 tools for Spark Ads, Carousel Ads, targeting, performance analytics, and budget optimization.

# TikTok Ads Integration

Reach TikTok's billion-plus users with AI-powered campaign management. Create In-Feed video, Spark, and Carousel ads, manage campaigns at every level, and analyze performance with 37 specialized tools. Includes rich targeting (interests, behavioral keywords, device, carrier, language), Layer-1 validity checks that catch errors before they reach TikTok's API, and atomic rollback on creation failures.

## Prerequisites

<Note>
  * TikTok Ads Manager account ([create one here](https://ads.tiktok.com))
  * A TikTok Business Center account with billing enabled
  * Admin access to the ad account you want to manage
  * Adspirer account connected via [Claude Code](/ai-clients/claude-code), [Cursor](/ai-clients/cursor), or any [supported AI client](https://www.adspirer.com/integrations)
</Note>

## Connecting TikTok Ads

Once you've set up Adspirer with your AI client, connect TikTok:

1. Open your AI assistant (ChatGPT, Claude, Claude Code, etc.)
2. Say: "Connect my TikTok Ads account"
3. Adspirer opens your browser for OAuth authorization
4. Sign in to TikTok Business Center and select the ad account you want to manage
5. Approve permissions (read campaign data, create ads, manage budgets)

Verify the connection:

```
Check my connected ad platforms
```

You should see your TikTok ad account listed with advertiser name, account ID, and active status.

## What You Can Do (37 Tools)

### Planning & Objective Selection

* `explain_tiktok_objective` -- Given your goal (leads, sales, traffic, app installs, video views), returns the correct TikTok campaign objective, recommended ad format, and compatibility constraints. Run this first if you're unsure which objective to use.

### Performance Analysis

* `get_tiktok_campaign_performance` -- Campaign summary with TikTok-specific video and engagement metrics
* `get_tiktok_ad_performance` -- Ad-level analysis with hook rate, video completion, and engagement
* `analyze_tiktok_wasted_spend` -- ROAS-based waste detection with campaign status awareness
* `optimize_tiktok_budget` -- Budget allocation recommendations based on performance
* `detect_tiktok_creative_fatigue` -- Hook rate decline as the primary fatigue signal
* `explain_tiktok_anomaly` -- Diagnose sudden changes in TikTok campaign performance
* `get_tiktok_audience_insights` -- Age/gender breakdown with CPA ranking
* `analyze_tiktok_geo_performance` -- Country-level performance analysis

### Creative Management

* `discover_tiktok_assets` -- Check existing video creatives in your TikTok account
* `validate_and_prepare_tiktok_assets` -- Verify video files meet TikTok's requirements (9:16 vertical, 5-60 seconds, MP4/MOV)
* `upload_tiktok_images` -- Upload images to TikTok Asset Library

### Campaign Creation

* `create_tiktok_campaign` -- Launch In-Feed video campaigns (created PAUSED)
* `add_tiktok_ad_group` -- Add ad groups with full targeting to existing campaigns
* `add_tiktok_ad` -- Add ads to existing ad groups (image, video, Spark Ads, Carousel)
* `create_tiktok_carousel_card` -- Create carousel cards from multiple images

### Campaign Management

* `list_tiktok_campaigns` -- List all campaigns with status, objective, and budget
* `get_tiktok_campaign_details` -- Detailed campaign info
* `update_tiktok_campaign` -- Update name, budget, budget mode
* `pause_tiktok_campaign` / `resume_tiktok_campaign` -- Control campaign status
* `list_tiktok_ad_groups` -- List ad groups, filter by campaign
* `update_tiktok_ad_group` -- Update name, budget, targeting, schedule
* `pause_tiktok_ad_group` / `resume_tiktok_ad_group` -- Control ad group status
* `list_tiktok_ads` -- List ads, filter by ad group or campaign
* `pause_tiktok_ad` / `resume_tiktok_ad` -- Control ad status

### Targeting & Research

* `search_tiktok_targeting` -- Search interests, keywords, regions, languages, action categories, carriers, and device models. This returns the **IDs** you then target with — interest keywords, for example, are passed as `interest_keyword_ids` (numeric IDs from this search), not as plain keyword strings.

## Campaign Creation Workflow

TikTok campaigns follow a 5-step workflow:

```
1. get_connections_status
   ↓ (verify TikTok Ads is connected)
2. search_tiktok_targeting
   ↓ (find your target audience by interests, keywords, regions)
3. discover_tiktok_assets
   ↓ (check existing videos in your account)
4. validate_and_prepare_tiktok_assets
   ↓ (verify video meets TikTok requirements: 9:16 vertical, 5-60 seconds)
5. create_tiktok_campaign
   ↓ (campaign created PAUSED — you review before launching)
```

### Adding ads to existing campaigns

```
1. list_tiktok_campaigns
   ↓ (find the campaign to add to)
2. add_tiktok_ad_group
   ↓ (create ad group with targeting)
3. add_tiktok_ad
   ↓ (add image, video, Spark Ad, or Carousel ad)
```

## Example Prompts

### Check Performance

<Prompt description="TikTok campaign metrics with video completion analysis." actions={["copy", "cursor"]}>
  Pull my TikTok Ads performance for the last 14 days.
  Show video views, engagement rate, conversions, and cost per conversion.
  Which campaigns have the best video completion rate?
</Prompt>

### Create a Campaign

<Prompt description="TikTok In-Feed campaign with video validation." actions={["copy", "cursor"]}>
  Create a TikTok campaign:

  * Product: Skincare brand targeting women 18-34
  * Audience: Women interested in beauty, skincare, wellness
  * Budget: \$50/day
  * Creative: \[provide video URL]
  * Objective: Website conversions

  Validate the video first, then build the campaign.
</Prompt>

### Upload and Validate Video

<Prompt description="Validate video specs for TikTok In-Feed ads." actions={["copy", "cursor"]}>
  Validate this TikTok video creative: \[your video URL]
  Check if it meets TikTok's specs for In-Feed ads.
</Prompt>

### Analyze What's Working

<Prompt description="Creative performance analysis with engagement metrics." actions={["copy", "cursor"]}>
  Show me my TikTok campaign performance for the last 30 days.
  Which ad creatives have the highest engagement rate?
  What's my average cost per conversion across all campaigns?
</Prompt>

## Creative Assets: What You Need to Know

TikTok is a video-first platform. All campaigns require video creative.

<Warning>
  Adspirer does NOT generate videos. You provide video URLs from Google Drive, Dropbox, S3, or any publicly accessible link. The `validate_and_prepare_tiktok_assets` tool checks that your video meets TikTok's specifications before campaign creation.
</Warning>

### TikTok's Creative Requirements

The `validate_and_prepare_tiktok_assets` tool checks these automatically:

* **Aspect ratio:** 9:16 (vertical) -- 1080x1920px recommended
* **Duration:** 5-60 seconds (9-15 seconds performs best for engagement)
* **Format:** MP4 or MOV
* **File size:** Under 500MB
* **Resolution:** Minimum 720p (1280x720px), 1080p recommended

### Supported Asset Sources

* Google Drive (public or shared links)
* Dropbox (public links)
* Amazon S3 (public URLs)
* Any publicly accessible video URL

### Creative Best Practices

* **Hook in the first 2 seconds:** TikTok users scroll fast. Grab attention immediately.
* **Native look and feel:** Ads that look like organic TikTok content outperform polished commercials
* **Vertical video only:** Horizontal or square videos perform significantly worse on TikTok
* **Sound on:** Unlike other platforms, most TikTok users watch with sound on. Use music and voiceover.
* **Short and punchy:** 9-15 seconds is the sweet spot for In-Feed ads

## Ad Formats

### In-Feed Ads

TikTok In-Feed ads appear in users' For You feed and blend with organic content. They support:

* **Traffic objective:** Drive users to your website or landing page
* **Conversions objective:** Optimize for specific conversion events (requires a TikTok Pixel ID and `optimization_event`)
* **App installs:** Drive mobile app downloads (APP\_PROMOTION objective)

In-Feed ads auto-play with sound as users scroll through their feed. Users can like, comment, share, and follow directly from the ad.

### Spark Ads

Boost existing TikTok organic posts as ads. Provide the `tiktok_item_id` of an organic post to promote it with paid reach while keeping all engagement (likes, comments, shares) on the original post.

### Carousel Ads

Multi-image carousel format for showcasing multiple products or features. Create carousel cards with `create_tiktok_carousel_card`, then reference the `card_id` when creating an ad.

### Conversion tracking

For campaigns with the CONVERSIONS objective, you need a TikTok Pixel ID and an `optimization_event`. The `optimization_event` tells TikTok which conversion action to optimize for.

Supported `optimization_event` values:

| Value                | Description                             |
| -------------------- | --------------------------------------- |
| `COMPLETE_PAYMENT`   | Purchase or payment completed (default) |
| `ON_WEB_CART`        | Add to cart                             |
| `ON_WEB_DETAIL`      | View content / product page             |
| `ON_WEB_REGISTER`    | Registration completed                  |
| `FORM`               | Form submission                         |
| `CONVERSION_LEADS`   | Lead generation                         |
| `INITIATE_ORDER`     | Checkout initiated                      |
| `PAGE_VISIT`         | Page view                               |
| `CLICK_LANDING_PAGE` | Landing page click                      |
| `ON_WEB_SUBSCRIBE`   | Subscription signup                     |
| `PHONE_CONNECT`      | Phone call connected                    |
| `CONSULT`            | Consultation request                    |
| `SEARCH`             | Site search                             |
| `SUBSCRIBE`          | Subscribe action                        |
| `DOWNLOAD_FINISH`    | Download completed                      |

Example prompt:

<Prompt description="TikTok conversion campaign with pixel tracking." actions={["copy", "cursor"]}>
  Create a TikTok campaign optimizing for add-to-cart events.
  Use pixel ID 12345, optimization event ON\_WEB\_CART.
  Budget: \$50/day, targeting women 18-34 interested in fashion.
</Prompt>

### Campaign Budget Optimization (CBO)

TikTok campaigns support campaign-level budget optimization via the `budget_optimize_on` parameter. CBO is on by default — set to `false` to manage budgets per ad group manually.

## Targeting Options

When creating TikTok campaigns through Adspirer, you can target by:

### Demographics

* **Age:** 13-17, 18-24, 25-34, 35-44, 45-54, 55+
* **Gender:** Male, Female, All
* **Location:** Country, state/region, city-level targeting

### Interests & Behaviors

* **Interests:** Beauty, Fashion, Food & Beverage, Technology, Fitness, Gaming, and 20+ categories
* **Behavioral signals:** Video interaction patterns, content engagement history
* **Device:** iOS, Android, specific device models

## Budget Guidelines

* **Minimum:** \$20/day per campaign (TikTok's requirement for campaign-level budgets)
* **Ad group minimum:** \$20/day
* **Recommended:** \$50+/day for meaningful data collection
* **Testing:** Start with \$50/day on a single ad group to gauge performance before scaling
* **CPC range:** Expect \$0.50-2.00 per click (varies by industry and targeting)
* **CPM range:** \$6-10 per thousand impressions

## Best Use Cases for TikTok Ads

* **E-commerce:** Products that photograph/film well (fashion, beauty, gadgets, food)
* **Brand awareness:** Reaching younger demographics (Gen Z and Millennials) at scale
* **Product launches:** New product reveals with authentic, native-feeling video content
* **App installs:** Mobile-first audience with high app download intent
* **Direct-to-consumer brands:** Brands that can create authentic, engaging short-form video

**Not ideal for:** B2B lead generation (use [LinkedIn Ads](/ad-platforms/linkedin-ads)), high-intent search capture (use [Google Ads](/ad-platforms/google-ads)), audiences over 45 (limited reach on TikTok).

## Troubleshooting

### "Ad account not connected" error

Re-authenticate your TikTok Business Center account:

```
Connect my TikTok Ads account
```

Make sure you select the correct advertiser account during OAuth. If you manage multiple accounts in TikTok Business Center, you may need to reconnect and select the right one.

### "Asset validation failed" error

Common causes:

* Video is not in 9:16 vertical format (horizontal or square videos are rejected)
* Video duration is outside 5-60 second range
* File too large (over 500MB)
* Unsupported format (use MP4 or MOV)
* Video URL is private or not publicly accessible

Run validation separately to diagnose:

```
Validate this TikTok video creative: [your URL]
```

### "Invalid media format" or TikTok page URL error

If you pass a TikTok page URL (e.g., `https://tiktok.com/@user/video/123`) as a video URL, the tool returns an error because that's a web page, not a downloadable video file. Two options:

* **Spark Ads:** Use the `tiktok_item_id` parameter instead to boost the organic post as a Spark Ad
* **Video ad:** Provide a direct link to the video file (MP4 or MOV) from Google Drive, Dropbox, S3, or any publicly accessible URL

### "Campaign creation failed" error

Most common reason: skipping the asset validation step. TikTok campaigns require `validate_and_prepare_tiktok_assets` before `create_tiktok_campaign`. The validation tool uploads and processes the video in TikTok's system.

If you're using [agent skills](/agent-skills/overview), the AI enforces the correct workflow automatically.

### Low video completion rates

Your creative may not be engaging enough for TikTok's audience. Common fixes:

* Stronger hook in the first 2 seconds
* Use trending sounds or music
* Make it feel organic, not like a traditional ad
* Shorter duration (try 9-12 seconds instead of 30+)
* Test multiple video variations to find what resonates

## FAQ

<AccordionGroup>
  <Accordion title="Can I create image ads on TikTok through Adspirer?">
    Yes. You can create image ads, Carousel Ads (multi-image), and Spark Ads in addition to video ads. Use `upload_tiktok_images` to upload images, then reference the image IDs when creating ads with `add_tiktok_ad`. For Carousel, create cards first with `create_tiktok_carousel_card`.
  </Accordion>

  <Accordion title="Does Adspirer generate TikTok video content?">
    No. Adspirer manages campaigns, not video production. You create videos using your preferred tools (CapCut, Canva, Adobe Premiere, or even your phone) and provide the video URL. For AI-generated video, tools like Runway, Pika, or HeyGen can help. Upload the result to Google Drive or Dropbox and provide the link to Adspirer.
  </Accordion>

  <Accordion title="What's the difference between TikTok Ads and Meta Ads?">
    **TikTok Ads:** Video-first platform with a younger audience (Gen Z, Millennials). Content feels native and authentic. Strong for brand discovery and impulse purchases. Lower CPM but requires video creative.

    **[Meta Ads](/ad-platforms/meta-ads):** Supports image, video, and carousel formats. Broader age demographics. More advanced targeting and retargeting options. Better for retargeting and full-funnel campaigns.

    Many advertisers run both: TikTok for awareness and discovery, Meta for retargeting and conversion optimization.
  </Accordion>

  <Accordion title="Can I boost existing TikTok organic posts?">
    Yes. Spark Ads let you promote existing organic TikTok posts as paid ads. Provide the `tiktok_item_id` of the organic post when creating an ad with `add_tiktok_ad` or `create_tiktok_campaign`. All engagement (likes, comments, shares) stays on the original post.
  </Accordion>

  <Accordion title="How much does Adspirer cost for TikTok Ads?">
    Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: $49/mo for 150 calls. Pro: $99/mo for 600 calls. Max: \$199/mo for 3,000 calls. A typical TikTok campaign creation uses 4-6 tool calls. See [full pricing](https://www.adspirer.com/pricing).
  </Accordion>

  <Accordion title="Is my TikTok advertising data secure?">
    Yes. Adspirer uses OAuth 2.1 authentication -- your TikTok credentials are never stored on Adspirer's servers. All connections are HTTPS-encrypted with strict security protocols. You can revoke access at any time from your TikTok Business Center.
  </Accordion>
</AccordionGroup>

## Related Documentation

* [Google Ads Integration](/ad-platforms/google-ads)
* [Meta Ads Integration](/ad-platforms/meta-ads)
* [LinkedIn Ads Integration](/ad-platforms/linkedin-ads)
* [Campaign Creation Workflows](/agent-skills/workflows)
* [TikTok Ads + AI Integration](https://www.adspirer.com/integrations/tiktok-ads)
* [Pricing & Plans](https://www.adspirer.com/pricing)