关于 tiktok-ads-integration
面向电商营销人员的 TikTok Ads 配置与优化技能,涵盖多种商店平台。内容包括 Pixel 与 Events API 追踪、商品目录同步、广告系列设置、Spark Ads 和效果检查。
主要功能
- 01Pixel 与 Events API 设置
- 02商店平台连接指南
- 03商品目录同步
- 04广告系列与 Spark Ads 设置
- 05效果衡量与故障排查
适用场景
- 01为电商商店投放 TikTok Ads
- 02Pixel 转化漏报时接入 Events API
- 03设置购物广告与商品目录
- 04通过 Spark Ads 推广自然内容
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ finsilabs/ awesome-ecommerce-skills --skill tiktok-ads-integration安装后在 Claude Code 中输入/tiktok-ads-integration确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
tile.jsonevals/campaign-structure-and-creative-strategy/criteria.jsontask.mdevals/catalog-feed-generation/criteria.jsontask.mdevals/server-side-events-api-with-deduplicatio/criteria.jsontask.md详细介绍
TikTok Ads 集成
概述
TikTok 是电商的重要发现渠道,尤其适用于时尚、美妆、家居和消费品。要实现可靠的归因,需要将基于浏览器的 TikTok Pixel 与服务器端 Events API(EAPI)配合使用,类似于 Meta 的 CAPI 方案。对于 Shopify、WooCommerce 和 BigCommerce,官方 TikTok 集成会自动安装 Pixel 和 EAPI。只有自定义实现才需要放在“自定义/无头”部分。
何时使用此技能
- 将 TikTok 作为新的付费获客渠道启动时
- TikTok Pixel 低报转化,而你需要使用 Events API 时
- 设置 Product Shopping Ads 或 Video Shopping Ads 时
- 将创作者的自然内容推广为 Spark Ads 时
- 为 Dynamic Showcase Ads 同步商品目录时
核心说明
第 1 步:将平台连接到 TikTok
| 平台 | 集成方式 | Pixel + EAPI | 目录同步 |
|---|---|---|---|
| Shopify | TikTok for Shopify(官方应用) | 是(内置) | 是(自动) |
| WooCommerce | TikTok for WooCommerce 插件 | 是(内置) | 是(自动) |
| BigCommerce | Channel Manager 中的 TikTok 渠道 | 是(内置) | 是(自动) |
| 自定义/无头 | TikTok Pixel JS + Events API REST | 手动实现 | 手动生成 Feed |
第 2 步:设置 TikTok Ads
Shopify
- 前往 Shopify Admin → Sales Channels → + → TikTok
- 安装 TikTok for Shopify,并连接 TikTok Business 账户和广告账户
- 在 Pixel & Events 下,选择 Maximum Data Sharing — 这会启用服务器端 Events API,以及浏览器 Pixel
- Shopify 会自动:
- 在所有页面安装 TikTok Pixel
- 触发 ViewContent、AddToCart、InitiateCheckout 和 CompletePayment 事件
- 通过 Shopify 的服务器使用 EAPI 发送相同的事件
- 将商品目录同步到 TikTok Catalog Manager,以用于 Shopping Ads
- 前往 TikTok Ads Manager → Assets → Events,查看 Pixel 的事件质量评分 — 目标为 7+/10
- 在 TikTok Business Center → Catalogs 中查看目录同步状态
WooCommerce
- 从 WordPress 插件目录安装 TikTok for WooCommerce(TikTok 官方插件)
- 前往 WooCommerce → TikTok → Connect,并使用 TikTok Business 账户登录
- 在数据共享设置下启用 Enhanced Matching(EAPI)
- 插件会自动将 WooCommerce 商品目录同步到 TikTok Catalog Manager
- 在 TikTok Events Manager → Data Sources → [Your Pixel] 中验证事件
BigCommerce
- 前往 BigCommerce Admin → Channel Manager → Add a Channel → TikTok
- 连接 TikTok Business 账户和广告账户
- 在设置过程中启用服务器端事件跟踪
- BigCommerce 会自动将商品目录同步到 TikTok
- 在 Channel Manager → TikTok → Products 中查看商品同步状态
自定义/无头
对于无头商店,同时安装浏览器 Pixel 和服务器端 Events API:
浏览器 Pixel(添加到每个页面的 <head> 中):
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 });
服务器端 Events API(从订单 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` },
}],
}),
}
);
}
第 3 步:搭建 TikTok 广告系列结构
在 TikTok Ads Manager 中搭建三级广告系列结构:
广告系列 1:拓展新客 — Video Shopping Ads
- 目标:商品销售
- 广告组受众:广泛(目标国家、18–45 岁、不进行兴趣定向)
- 出价:最低费用(让算法在前 2 周进行学习)
- 广告:Video Shopping Ads — TikTok 会根据你的商品目录自动生成商品视频,也可以上传自己的 UGC 风格竖屏视频
- 预算:TikTok 总预算的 60%
广告系列 2:再营销 — 互动用户
- 目标:转化
- 广告组 1:过去 7 天查看过商品但未加入购物车的用户
- 自定义受众:网站事件 → ViewContent,过去 7 天
- 广告组 2:加入购物车但未购买的用户(过去 3 天)
- 自定义受众:AddToCart,过去 3 天;排除 CompletePayment
- 广告:动态商品广告,展示用户互动过的特定商品
- 预算:TikTok 总预算的 30%
广告系列 3:Spark Ads — 推广自然内容
- 目标:转化
- 使用 Spark Ads 推广表现最佳的 TikTok 自然帖子或已获授权的创作者帖子
- Spark Ads 的效果优于大多数精心制作的品牌内容,因为社交证明(点赞、评论)会保留下来
- 预算:TikTok 总预算的 10%
第 4 步:设置 Spark Ads(推广自然内容)
- 在 TikTok Ads Manager 中,前往 Assets → Creative → Spark Ads
- 推广自己的自然帖子:搜索帖子 URL 并申请授权
- 推广创作者帖子:创作者必须通过 TikTok 的授权流程授予 Spark Ad 授权 — 他们前往 Creator Tools → TikTok for Business 并生成授权码
- 授权码有效期为 30 天 — 请将续期安排纳入工作流
第 5 步:衡量 TikTok Ads 成效
| 指标 | 目标 | 查看位置 |
|---|---|---|
| Pixel 事件质量评分 | 7+/10 | TikTok Events Manager → Pixel |
| 视频播放率(2 秒) | > 25% | Ads Manager → Campaign Analytics |
| 点击率 | > 1% | Ads Manager |
| 单次购买费用 | 你的目标 CPA | Ads Manager → Conversions |
| ROAS | 广泛受众 > 2× / 再营销 > 4× | Ads Manager → Revenue |
最佳实践
- 在 Shopify/WooCommerce TikTok 集成设置中选择 Maximum Data Sharing — 这会启用 EAPI,是提升归因质量最重要的单项设置
- 在所有 EAPI 事件中传递
ttclid— 从落地页 URL(?ttclid=xxx)中获取 TikTok 点击 ID 并存入 Cookie;在 iOS 14 之后,这是最强的归因信号 - 只使用 9:16 竖屏视频 — 在 TikTok 全屏信息流中,横屏或方形广告的表现明显更差
- 每 3–4 周更新创意素材 — TikTok 受众比 Meta 受众更快产生疲劳;请规划持续的创意素材产出流程
- 从最低费用出价开始 — 在积累足够的转化数据以使用 Cost Cap 出价之前,最低费用出价可以帮助积累算法所需的购买历史记录
- 从新客拓展广告组中排除近期购买者(30 天) — 将客户名单上传为自定义受众,并在所有新客拓展广告组中设置排除
常见问题
| 问题 | 解决方案 |
|---|---|
| 在 Events Manager 中重复计算购买次数 | 确保同一事件在 Pixel 和 Events API 中的 event_id 完全一致 |
| 商品目录 Feed 被拒 | 检查 price 格式是否为 "XX.XX USD"(金额和货币代码之间必须有空格) |
| Events Manager 中匹配率低 | 除经过哈希处理的电子邮件外,还要发送 ttclid、ip 和 user_agent,以最大限度提高归因效果 |
| CPM 高但点击率低 | 视频的前 2 秒必须在视觉上足够吸引人 — 不要使用 Logo 卡片或缓慢展示商品的开场 |
| Spark Ad 授权已过期 | 每 30 天申请新的授权码;为创作者授权的内容设置日历提醒 |
相关技能
- @meta-ads-integration
- @tiktok-shop-integration
- @google-ads-ecommerce
- @ugc-campaign-management
- @marketing-attribution-dashboard
评论
支持 Markdown