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

TikTok Ads Integration

Overview

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

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

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

Related Skills

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

Adoption

finsilabs/tiktok-ads-integration

$ install --global

Security Scan Results

SKILL.md

TikTok Ads Integration

Overview

When to Use This Skill

Core Instructions

Step 1: Connect your platform to TikTok

Step 2: Set up TikTok Ads

Shopify

WooCommerce

BigCommerce

Custom / Headless

Step 3: Build your TikTok campaign structure

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

Step 5: Measure TikTok Ads performance

Best Practices

Common Pitfalls

Related Skills

Related Skills

finsilabs/wishlist-save-for-later

finsilabs/storefront-theming

finsilabs/search-autocomplete

finsilabs/responsive-storefront

finsilabs/tiktok-ads-integration

$ install --global

Security Scan Results

SKILL.md

TikTok Ads Integration

Overview

When to Use This Skill

Core Instructions

Step 1: Connect your platform to TikTok

Step 2: Set up TikTok Ads

Shopify

WooCommerce

BigCommerce

Custom / Headless

Step 3: Build your TikTok campaign structure

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

Step 5: Measure TikTok Ads performance

Best Practices

Common Pitfalls

Related Skills

Related Skills

finsilabs/wishlist-save-for-later

finsilabs/storefront-theming

finsilabs/search-autocomplete

finsilabs/responsive-storefront