tiktok-ads-integration

Implements TikTok ad campaigns with Events API server-side tracking, Spark Ads, and catalog sync.

3|1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill tiktok-ads-integration-tomtoto757
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tiktok-ads-integration
Source: https://github.com/tomtoto757/ecomm-ai-team/tree/main/skills/marketing-growth/finsilabs/marketing-growth/tiktok-ads-integration
Command: npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill tiktok-ads-integration-tomtoto757

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Browser-only TikTok Pixel tracking under-reports conversions due to iOS privacy restrictions, ad blockers, and cookie consent rejections, leaving advertisers with unreliable attribution and poorly optimized campaigns. ## Core Features & Use Cases - Server-Side Events API: Pair the browser Pixel with TikTok's Events API using SHA-256 hashed PII, matching event_id deduplication, and ttclid attribution signals. - Campaign Architecture: Build a three-tier structure covering Video Shopping Ads prospecting, retargeting custom audiences, and Spark Ads for boosting creator content. - Catalog Sync: Generate TikTok Catalog Manager-compatible JSONL product feeds with correct price formatting, per-variant rows, and 24-hour auto-sync setup. - Use Case: A Shopify store sees TikTok Ads Manager report only 40% of actual purchases; use this Skill to enable Maximum Data Sharing and server-side EAPI events so conversions are tracked reliably. ## Quick Start Set up TikTok ads tracking for my Shopify store with server-side Events API and deduplicated purchase events.

Frequently Asked Questions about tiktok-ads-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up TikTok Events API server-side tracking?▼

Send purchase events from your order webhook to TikTok's pixel/track endpoint with an Access-Token header and a data array payload. Hash email and phone with SHA-256 after lowercasing and trimming, and include ttclid, ip, and user_agent for maximum match rate.

How to prevent double-counting between TikTok Pixel and Events API?▼

Pass an identical event_id in both the browser Pixel ttq.track call and the server-side Events API request for the same conversion. TikTok uses the matching event_id to deduplicate the two events automatically.

Does TikTok ads integration work with Shopify and WooCommerce?▼

Yes, the official TikTok apps for Shopify, WooCommerce, and BigCommerce install both the Pixel and Events API automatically. Enable Maximum Data Sharing or Enhanced Matching in the integration settings to activate server-side tracking.

What format does TikTok Catalog Manager require for product feeds?▼

TikTok Catalog Manager accepts JSONL format with one JSON object per line, using sku_id, image_link, and google_product_category fields. Prices must be formatted as 'XX.XX USD' with a space, and multi-variant products need one row per variant.

Why is my TikTok Pixel under-reporting conversions?▼

Browser-side tracking is blocked by iOS privacy restrictions, ad blockers, and cookie consent rejections. Adding the server-side Events API alongside the Pixel recovers lost signals, with ttclid being the strongest attribution parameter after iOS 14.

How long does TikTok Spark Ads authorization last?▼

Spark Ads authorization codes generated by creators are valid for 30 days. You must request renewal codes from creators before expiry and build this renewal cycle into your campaign workflow.