What is the TikTok ads integration agent skill?

TikTok is a primary discovery channel for ecommerce, particularly for fashion, beauty, home, and consumer goods. What sets it apart is how it narrows social content into one specific workflow rather than a broad, generic prompt.

What inputs does TikTok ads integration need?

Context for social content: your goals, audience, constraints, and any source material the skill asks for.

What does TikTok ads integration output?

A ready-to-use result for social content: the analysis, copy, or recommendations the agent produces.

TikTok ads integration

Quick answer

01What is it?: TikTok is a primary discovery channel for ecommerce, particularly for fashion, beauty, home, and consumer goods. What sets it apart is how it narrows social content into one specific workflow rather than a broad, generic prompt.
02Inputs: Context for social content: your goals, audience, constraints, and any source material the skill asks for.
03Output: A ready-to-use result for social content: the analysis, copy, or recommendations the agent produces.

Add this skill

Install-only

Install as a package

Installs this one skill package for your coding agent, including any supporting files that skill ships with — not every skill in the repository. Read the tutorial.

Terminal

$ npx skills add finsilabs/awesome-ecommerce-skills --skill tiktok-ads-integration

Skill instructions

The instruction file for this skill. The skill also includes other files you need to install to use it.

SKILL.md

Preview only — coding agent install

TikTok Ads Integration

Overview

TikTok is a primary discovery channel for ecommerce, particularly for fashion, beauty, home, and consumer goods. Reliable attribution requires pairing the browser-based TikTok Pixel with the server-side Events API (EAPI) — similar to Meta's CAPI approach. For Shopify, WooCommerce, and BigCommerce, the official TikTok integrations install both Pixel and EAPI automatically. Custom implementation only belongs in the Custom/Headless section.

When to Use This Skill

When launching TikTok as a new paid acquisition channel
When TikTok Pixel is under-reporting conversions and you need Events API
When setting up Product Shopping Ads or Video Shopping Ads
When boosting organic creator content as Spark Ads
When syncing your product catalog for Dynamic Showcase Ads

Core Instructions

Step 1: Connect your platform to TikTok

Platform	Integration Method	Pixel + EAPI	Catalog Sync
Shopify	TikTok for Shopify (official app)	Yes (built-in)	Yes (automatic)
WooCommerce	TikTok for WooCommerce plugin	Yes (built-in)	Yes (automatic)
BigCommerce	TikTok channel in Channel Manager	Yes (built-in)	Yes (automatic)
Custom / Headless	TikTok Pixel JS + Events API REST	Manual implementation	Manual feed generation

Step 2: Set up TikTok Ads

Shopify

Go to Shopify Admin → Sales Channels → + → TikTok
Install TikTok for Shopify and connect your TikTok Business account and Ad account
Under Pixel & Events, select Maximum Data Sharing — this enables server-side Events API alongside the browser Pixel
Shopify automatically:
- Installs the TikTok Pixel on all pages
- Fires ViewContent, AddToCart, InitiateCheckout, and CompletePayment events
- Sends the same events via EAPI from Shopify's servers
- Syncs your product catalog to TikTok Catalog Manager for Shopping Ads
Go to TikTok Ads Manager → Assets → Events and check your Pixel's event quality score — aim for 7+/10
Check catalog sync status in TikTok Business Center → Catalogs

WooCommerce

Install TikTok for WooCommerce from the WordPress plugin directory (official TikTok plugin)
Go to WooCommerce → TikTok → Connect and sign in with your TikTok Business account
Enable Enhanced Matching (EAPI) under the data sharing settings
The plugin syncs your WooCommerce product catalog to TikTok Catalog Manager automatically
Verify events in TikTok Events Manager → Data Sources → [Your Pixel]

BigCommerce

Go to BigCommerce Admin → Channel Manager → Add a Channel → TikTok
Connect your TikTok Business account and Ad account
Enable server-side event tracking during setup
BigCommerce syncs your product catalog to TikTok automatically
Check product sync status in Channel Manager → TikTok → Products

Custom / Headless

For headless stores, install both the browser Pixel and server-side Events API:

Browser Pixel (add to <head> on every page):

ttq.load('YOUR_PIXEL_ID');
ttq.page();

// Product page
ttq.track('ViewContent', {
  content_id: product.sku,
  content_type: 'product',
  content_name: product.name,
  value: product.price,
  currency: 'USD',
});

// Purchase — pass event_id for deduplication with Events API
const purchaseEventId = `purchase-${order.id}`;
ttq.track('CompletePayment', {
  content_id: order.lineItems.map(i => i.sku).join(','),
  value: order.subtotal,
  currency: order.currencyCode,
  order_id: order.id,
}, { event_id: purchaseEventId });

Server-side Events API (send from your order webhook):

async function trackTikTokPurchase(order: Order, req: Request) {
  const eventId = `purchase-${order.id}`; // MUST match Pixel event_id for deduplication
  const { createHash } = await import('crypto');
  const sha256 = (val: string) => createHash('sha256').update(val.toLowerCase().trim()).digest('hex');

  await fetch(
    `https://business-api.tiktok.com/open_api/v1.3/pixel/track/?business_id=${process.env.TIKTOK_BUSINESS_ID}`,
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Access-Token': process.env.TIKTOK_ACCESS_TOKEN!,
      },
      body: JSON.stringify({
        data: [{
          pixel_code: process.env.TIKTOK_PIXEL_ID,
          event: 'CompletePayment',
          event_id: eventId,
          event_time: Math.floor(Date.now() / 1000),
          user: {
            email: sha256(order.customerEmail),
            phone_number: sha256(order.customerPhone?.replace(/\D/g, '') ?? ''),
            ip: req.ip,
            user_agent: req.headers['user-agent'],
            ttclid: req.cookies['ttclid'], // TikTok click ID — strongest attribution signal
          },
          properties: {
            value: order.subtotal,
            currency: order.currencyCode,
            contents: order.lineItems.map(i => ({ content_id: i.sku, content_type: 'product' })),
            order_id: order.id,
          },
          page: { url: `${process.env.STORE_URL}/checkout/thank-you` },
        }],
      }),
    }
  );
}

Step 3: Build your TikTok campaign structure

In TikTok Ads Manager, build a three-tier campaign structure:

Campaign 1: Prospecting — Video Shopping Ads

Objective: Product Sales
Ad Group audience: Broad (target country, age 18–45, no interest targeting)
Bidding: Lowest Cost (let the algorithm learn for the first 2 weeks)
Ads: Video Shopping Ads — TikTok auto-generates product videos from your catalog, or upload your own UGC-style vertical videos
Budget: 60% of total TikTok budget

Campaign 2: Retargeting — Engaged Users

Objective: Conversions
Ad Group 1: Viewed product in last 7 days but did not add to cart
- Custom Audience: Website Event → ViewContent, last 7 days
Ad Group 2: Added to cart but did not purchase (last 3 days)
- Custom Audience: AddToCart, last 3 days; exclude CompletePayment
Ads: Dynamic product ads showing the specific product the viewer engaged with
Budget: 30% of total TikTok budget

Campaign 3: Spark Ads — Boost Organic Content

Objective: Conversions
Use Spark Ads to boost your top-performing organic TikTok posts or authorized creator posts
Spark Ads outperform most polished brand content because the social proof (likes, comments) carries over
Budget: 10% of total TikTok budget

Step 4: Set up Spark Ads (boosting organic content)

In TikTok Ads Manager, go to Assets → Creative → Spark Ads
To boost your own organic posts: search for the post URL and request authorization
To boost creator posts: the creator must grant Spark Ad authorization via TikTok's authorization process — they go to Creator Tools → TikTok for Business and generate an authorization code
Authorization codes are valid for 30 days — plan renewal into your workflow

Step 5: Measure TikTok Ads performance

Metric	Target	Where to Find
Pixel Event Quality Score	7+/10	TikTok Events Manager → Pixel
Video play rate (2s)	> 25%	Ads Manager → Campaign Analytics
Click-through rate	> 1%	Ads Manager
Cost per Purchase	Your target CPA	Ads Manager → Conversions
ROAS	> 2× for broad / > 4× for retargeting	Ads Manager → Revenue

Best Practices

Use Maximum Data Sharing in Shopify/WooCommerce TikTok integration settings — this enables EAPI and is the most important single setting for attribution quality
Pass ttclid in all EAPI events — capture the TikTok click ID from landing page URLs (?ttclid=xxx) and store in a cookie; it is the strongest attribution signal after iOS 14
Use 9:16 vertical video exclusively — horizontal or square ads significantly underperform in TikTok's full-screen feed
Refresh creatives every 3–4 weeks — TikTok audiences fatigue faster than Meta; plan a continuous creative pipeline
Start with Lowest Cost bidding — before you have enough conversion data for Cost Cap bidding, Lowest Cost generates the purchase history the algorithm needs
Exclude recent purchasers (30 days) from prospecting — upload a customer list as a custom audience exclusion in all prospecting ad sets

Common Pitfalls

Problem	Solution
Double-counting purchases in Events Manager	Ensure `event_id` in Pixel and Events API match exactly for the same event
Catalog feed rejections	Check that `price` format is `"XX.XX USD"` (space between amount and currency code is required)
Low match rate in Events Manager	Send `ttclid`, `ip`, and `user_agent` in addition to hashed email for maximum attribution
High CPMs but low click-through rate	First 2 seconds of video must be visually arresting — no logo cards or slow product reveal intros
Spark Ad authorization expired	Request new auth codes every 30 days; set calendar reminders for creator-authorized content

Related Skills

@meta-ads-integration
@tiktok-shop-integration
@google-ads-ecommerce
@ugc-campaign-management
@marketing-attribution-dashboard

Common questions

How do I install TikTok ads integration in Cursor, Claude Code, or Codex?

Run npx skills add finsilabs/awesome-ecommerce-skills --skill tiktok-ads-integration in the project where you want it, then ask your agent for the skill by name. The --skill flag installs only TikTok ads integration, not every skill in the repository.

Where does TikTok ads integration come from and what license is it under?

TikTok ads integration comes from the finsilabs/awesome-ecommerce-skills repository on GitHub. That repository has 34 GitHub stars. The skill is published under the MIT license.

Prefer plain text? Read the TikTok ads integration guide as markdown.