Claude
Skills
Sign in
← Back

tiktok-ads-integration

Included with Lifetime
$97 forever

Launch TikTok ad campaigns for ecommerce with Events API server-side tracking, Spark Ads, catalog sync, and shopping ads for product discovery

marketing-growthtiktoktiktok-adsspark-adssocial-advertising

What this skill does


# 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

1. Go to **Shopify Admin → Sales Channels → + → TikTok**
2. Install TikTok for Shopify and connect your TikTok Business account and Ad account
3. Under **Pixel & Events**, select **Maximum Data Sharing** — this enables server-side Events API alongside the browser Pixel
4. 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
5. Go to **TikTok Ads Manager → Assets → Events** and check your Pixel's event quality score — aim for 7+/10
6. Check catalog sync status in **TikTok Business Center → Catalogs**

---

#### WooCommerce

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

---

#### BigCommerce

1. Go to **BigCommerce Admin → Channel Manager → Add a Channel → TikTok**
2. Connect your TikTok Business account and Ad account
3. Enable server-side event tracking during setup
4. BigCommerce syncs your product catalog to TikTok automatically
5. 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):**
```javascript
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):**
```typescript
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)

1. In TikTok Ads Manager, go to **Assets → Creative → Spark Ads**
2. To boost your own organic posts: search for the post URL and request authorization
3. 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
4. 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
Files: 8
Size: 25.3 KB
Complexity: 42/100
Category: marketing-growth
Source: https://github.com/finsilabs/awesome-ecommerce-skills/tree/main/skills/marketing-growth/tiktok-ads-integration

Related in marketing-growth

email-list-segmentation

Included

Create dynamic email segments based on purchase behavior, RFM scores, engagement signals, and lifecycle stage with automated rebalancing and list hygiene

marketing-growth

cart-abandonment-recovery

Included

Win back shoppers who leave items in their cart by setting up timed email, SMS, and push sequences with escalating incentives to complete their purchase

marketing-growth

google-ads-ecommerce

Included

Build and optimize Google Ads campaigns for ecommerce with Performance Max, Shopping feeds, conversion tracking, and Smart Bidding strategies for ROAS

marketing-growth

meta-ads-integration

Included

Set up and optimize Meta (Facebook/Instagram) ad campaigns with Conversions API server-side tracking, dynamic product ads, and catalog sync for ecommerce

marketing-growth

video-commerce-integration

Included

Enable shoppable video experiences with live shopping events, interactive product hotspots, and one-click checkout directly from video and livestream content

marketing-growth

google-shopping-feed

Included

Generate and optimize a product feed for Google Merchant Center so your products appear in Google Shopping ads with correct attributes

marketing-growth
Sign up & unlock — $97