mcpField
T
tiktok-ads-integration

tiktok-ads-integration

github.com/finsilabs营销与增长60112 次安装5 天前更新
代码仓库

关于 tiktok-ads-integration

面向电商营销人员的 TikTok Ads 配置与优化技能,涵盖多种商店平台。内容包括 Pixel 与 Events API 追踪、商品目录同步、广告系列设置、Spark Ads 和效果检查。

主要功能

  1. 01Pixel 与 Events API 设置
  2. 02商店平台连接指南
  3. 03商品目录同步
  4. 04广告系列与 Spark Ads 设置
  5. 05效果衡量与故障排查

适用场景

  1. 01为电商商店投放 TikTok Ads
  2. 02Pixel 转化漏报时接入 Events API
  3. 03设置购物广告与商品目录
  4. 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.json
evals/campaign-structure-and-creative-strategy/
criteria.json
task.md
evals/catalog-feed-generation/
criteria.json
task.md
evals/server-side-events-api-with-deduplicatio/
criteria.json
task.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目录同步
ShopifyTikTok for Shopify(官方应用)是(内置)是(自动)
WooCommerceTikTok for WooCommerce 插件是(内置)是(自动)
BigCommerceChannel Manager 中的 TikTok 渠道是(内置)是(自动)
自定义/无头TikTok Pixel JS + Events API REST手动实现手动生成 Feed
第 2 步:设置 TikTok Ads

Shopify
  1. 前往 Shopify Admin → Sales Channels → + → TikTok
  2. 安装 TikTok for Shopify,并连接 TikTok Business 账户和广告账户
  3. 在 Pixel & Events 下,选择 Maximum Data Sharing — 这会启用服务器端 Events API,以及浏览器 Pixel
  4. Shopify 会自动:
    • 在所有页面安装 TikTok Pixel
    • 触发 ViewContent、AddToCart、InitiateCheckout 和 CompletePayment 事件
    • 通过 Shopify 的服务器使用 EAPI 发送相同的事件
    • 将商品目录同步到 TikTok Catalog Manager,以用于 Shopping Ads
  5. 前往 TikTok Ads Manager → Assets → Events,查看 Pixel 的事件质量评分 — 目标为 7+/10
  6. 在 TikTok Business Center → Catalogs 中查看目录同步状态

WooCommerce
  1. 从 WordPress 插件目录安装 TikTok for WooCommerce(TikTok 官方插件)
  2. 前往 WooCommerce → TikTok → Connect,并使用 TikTok Business 账户登录
  3. 在数据共享设置下启用 Enhanced Matching(EAPI)
  4. 插件会自动将 WooCommerce 商品目录同步到 TikTok Catalog Manager
  5. 在 TikTok Events Manager → Data Sources → [Your Pixel] 中验证事件

BigCommerce
  1. 前往 BigCommerce Admin → Channel Manager → Add a Channel → TikTok
  2. 连接 TikTok Business 账户和广告账户
  3. 在设置过程中启用服务器端事件跟踪
  4. BigCommerce 会自动将商品目录同步到 TikTok
  5. 在 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(推广自然内容)
  1. 在 TikTok Ads Manager 中,前往 Assets → Creative → Spark Ads
  2. 推广自己的自然帖子:搜索帖子 URL 并申请授权
  3. 推广创作者帖子:创作者必须通过 TikTok 的授权流程授予 Spark Ad 授权 — 他们前往 Creator Tools → TikTok for Business 并生成授权码
  4. 授权码有效期为 30 天 — 请将续期安排纳入工作流
第 5 步:衡量 TikTok Ads 成效
指标目标查看位置
Pixel 事件质量评分7+/10TikTok Events Manager → Pixel
视频播放率(2 秒)> 25%Ads Manager → Campaign Analytics
点击率> 1%Ads Manager
单次购买费用你的目标 CPAAds 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