meta-ads-integration

Meta Ads 集成

概述

Meta（Facebook/Instagram）是电商领域占主导地位的付费社交渠道，但要实现可靠的归因，需要将基于浏览器的 Meta Pixel 与服务器端 Conversions API（CAPI）配合使用。iOS 14 发布后，仅靠浏览器信号会少报告 30–60% 的转化；CAPI 通过直接从你的服务器发送购买事件，恢复信号保真度。对于 Shopify、WooCommerce 和 BigCommerce，官方集成会自动处理 Pixel 和 CAPI，无需自定义代码。只有在“自定义/无头”部分才需要自定义代码。

何时使用此技能

• 为新的电商店铺设置 Meta 广告时
• iOS 14 发布后，Ads Manager 中的转化数据看起来少报时
• 启动动态商品广告（DPA）并需要同步商品目录 Feed 时
• ROAS 下降且需要恢复 Meta 算法所依赖的信号质量时
• 根据商品浏览和加入购物车事件添加再营销受众时

核心说明

第 1 步：选择集成方式

平台	推荐方式	CAPI 支持	商品目录同步
Shopify	原生 Meta 销售渠道	是（内置）	是（自动）
WooCommerce	Facebook for WooCommerce 插件	是（内置）	是（自动）
BigCommerce	Channel Manager 中的 Meta 渠道	是（内置）	是（自动）
自定义 / 无头	Meta Pixel + facebook-nodejs-business-sdk	手动实现 CAPI	手动生成 Feed

所有三大平台都提供官方 Meta 集成，可通过一次设置同时安装 Pixel 和 CAPI——请使用这些集成，而不要手动粘贴 Pixel 代码。

第 2 步：将平台连接到 Meta

---

Shopify

1. 前往 Shopify Admin → Sales Channels → + → Facebook & Instagram
2. 安装 Facebook & Instagram 销售渠道
3. 连接你的 Meta Business Manager 账户，并选择 Facebook 专页和广告账户
4. 在 Data Sharing 下选择 Maximum——这会在浏览器 Pixel 之外启用服务器端 CAPI
5. Shopify 会自动：
   • 在所有页面安装 Meta Pixel
   • 触发 ViewContent、AddToCart、InitiateCheckout 和 Purchase 事件
   • 通过 Shopify 服务器使用 CAPI 发送相同事件（自动处理去重）
   • 将商品目录同步到 Meta Commerce Manager，以用于动态商品广告
6. 前往 Facebook & Instagram → Overview，确认 Pixel 连接状态
7. 在 Meta Events Manager → Data Sources → [Your Pixel] 中检查 Event Match Quality（EMQ）评分——目标为 7+/10

---

WooCommerce

1. 从 WordPress 插件目录安装 Facebook for WooCommerce（Meta 官方免费插件）
2. 前往 WooCommerce → Facebook → Get Started，并连接你的 Meta Business Manager 账户
3. 在 Facebook Connection → Data Sharing Level 下选择 Maximum
4. 该插件会在所有页面安装 Meta Pixel，并自动触发标准事件
5. 在 Maximum 数据共享设置下会自动启用 CAPI
6. 前往 WooCommerce → Facebook → Product Sync，触发首次商品目录同步到 Meta Commerce Manager
7. 在 Meta Commerce Manager → Catalog → Data Sources 中确认商品目录同步状态

---

BigCommerce

1. 前往 BigCommerce Admin → Channel Manager → Add a Channel
2. 选择 Facebook & Instagram
3. 连接你的 Meta Business Manager 账户
4. 在设置过程中启用 Enhanced Conversions（CAPI）
5. BigCommerce 会自动同步你的商品目录，并将其注册到 Meta Commerce Manager，以用于动态商品广告
6. 在 Channel Manager → Facebook & Instagram → Products 中检查商品同步状态

---

自定义 / 无头

对于无头商店，必须手动安装浏览器端 Pixel 和服务器端 CAPI。

浏览器端 Pixel（添加到每个页面的 <head> 中）：

// Replace YOUR_PIXEL_ID with your Pixel ID from Meta Events Manager
fbq('init', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');

// Product page
fbq('track', 'ViewContent', {
  content_ids: [product.sku],
  content_type: 'product',
  value: product.price,
  currency: 'USD',
});

// Purchase — pass eventID for deduplication with CAPI
const purchaseEventId = `purchase-${orderId}`;
fbq('track', 'Purchase', {
  content_ids: order.lineItems.map(i => i.sku),
  value: order.subtotal,
  currency: order.currencyCode,
  order_id: order.id,
}, { eventID: purchaseEventId });

服务器端 CAPI（从订单 Webhook 发送）：

import { FacebookAdsApi, ServerEvent, UserData, CustomData, EventRequest } from 'facebook-nodejs-business-sdk';

FacebookAdsApi.init(process.env.META_CAPI_ACCESS_TOKEN!);

async function trackPurchaseCapi(order: Order, req: Request) {
  const eventId = `purchase-${order.id}`; // MUST match the eventID passed to fbq()

  const userData = new UserData()
    .setEmail(order.customerEmail)    // SDK hashes PII automatically (SHA-256)
    .setPhone(order.customerPhone)
    .setFirstName(order.customerFirstName)
    .setLastName(order.customerLastName)
    .setZip(order.shippingAddress?.zip)
    .setCountry(order.shippingAddress?.countryCode)
    .setClientIpAddress(req.ip)
    .setClientUserAgent(req.headers['user-agent'] as string)
    .setFbp(req.cookies['_fbp'])   // _fbp cookie = browser identity signal
    .setFbc(req.cookies['_fbc']);  // _fbc cookie = click identity signal

  const customData = new CustomData()
    .setValue(order.subtotal)
    .setCurrency(order.currencyCode)
    .setContentIds(order.lineItems.map(i => i.sku))
    .setContentType('product')
    .setNumItems(order.lineItems.length)
    .setOrderId(order.id);

  const event = new ServerEvent()
    .setEventName('Purchase')
    .setEventId(eventId)
    .setEventTime(Math.floor(Date.now() / 1000))
    .setUserData(userData)
    .setCustomData(customData)
    .setActionSource('website');

  await new EventRequest(process.env.META_CAPI_ACCESS_TOKEN!, process.env.META_PIXEL_ID!)
    .setEvents([event])
    .execute();
}

用于动态商品广告的商品目录 Feed： 生成 CSV Feed，并通过稳定的 URL 提供。前往 Meta Commerce Manager → Catalog → Data Sources → Add Data Feed 注册。

// Generate CSV with required columns: id, title, description, availability, condition, price, link, image_link, brand
// Schedule regeneration every 4 hours — serve at a stable /feeds/meta-catalog.csv endpoint

第 3 步：电商广告系列结构

在 Meta Ads Manager 中构建三级广告系列结构：

广告系列 1：潜在客户拓展

• 目标：销售 → 购买
• 预算：Meta 总预算的 60%
• 受众：广泛（美国，18–65 岁，不按兴趣定向）——使用 Advantage+ 定向
• 广告：3–5 个创意素材（静态图片、视频、轮播、UGC）
• 使用 Advantage+ Shopping Campaigns (ASC)——对于电商，Meta 的自动化格式表现始终优于手动广告系列结构

广告系列 2：再营销

• 预算：Meta 总预算的 30%
• 广告组 1：浏览过商品但未加入购物车（最近 7 天）
  • 受众：网站自定义受众 → ViewContent 事件，最近 7 天
  • 广告：展示浏览过商品的动态商品广告（DPA）轮播
• 广告组 2：已加入购物车但未购买（最近 3 天）
  • 受众：网站自定义受众 → AddToCart，最近 3 天；排除最近 3 天的 Purchases
  • 广告：DPA + 紧迫感文案

广告系列 3：留存 / LTV

• 预算：Meta 总预算的 10%
• 广告组：客户名单受众（从 Shopify → Customers 导出中上传）
  • 排除最近 30 天内购买过的客户
  • 广告：新品、交叉销售商品
• 广告组：顶级购买者的 1% 相似受众（非常适合潜在客户拓展）

第 4 步：设置动态商品广告

对于 Shopify 和 WooCommerce，官方集成会自动同步商品目录。请验证设置：

1. 前往 Meta Commerce Manager → Catalogs → [Your Catalog]
2. 检查 Data Sources——确认平台 Feed 正在同步，且上次更新时间在 24 小时内
3. 检查 Items——验证商品显示的价格、库存情况和图片是否正确
4. 在 Ads Manager → Create Ad Set 中：在 Catalog Sales 广告系列目标下选择你的商品目录
5. 选择 Dynamic formats and creatives——Meta 会自动为每位用户选择最佳广告格式

第 5 步：验证事件匹配质量

在 Meta Events Manager → Data Sources → [Your Pixel] → Overview 中：

信号	改进方法
EMQ 低于 6	发送更多用户数据（电子邮件、电话、fbp/fbc Cookie）
CAPI 未触发	检查平台集成是否设置为 Maximum data sharing
转化重复	验证去重设置——Pixel 与 CAPI 之间的 eventID 必须匹配
ViewContent 未触发	检查平台集成是否已启用，且商品页面上是否已安装 Pixel

最佳实践

• 使用 Advantage+ Shopping Campaigns (ASC) 拓展潜在客户——对于电商，Meta 的自动化广告系列类型表现始终优于手动结构；从这里开始，而不是手动广告系列
• 将 Shopify/WooCommerce 的数据共享设置为 Maximum——这一项设置即可启用 CAPI，归因准确度远高于默认设置
• 在 CAPI 中传递 _fbp 和 _fbc Cookie——这些是 iOS 14+ 归因中最强的身份信号；在每个 CAPI 事件中都应包含它们
• 使用 order_id 作为去重键——当 Pixel 和 CAPI 都针对同一笔购买触发时，可防止重复计算转化
• 将近期购买者排除在潜在客户拓展之外——在冷启动广告系列中添加 30 天购买者排除规则，以保护预算
• 每 4–6 周更新创意素材——Meta 广告系列很快会出现创意疲劳；每个广告组轮换 3–5 个版本

常见问题

问题	解决方案
Ads Manager 中购买转化次数重复	确保同一事件的 Pixel 和 CAPI 调用中的 eventID 完全相同；Shopify 的原生集成会自动处理此问题
iOS 14 发布后转化次数低于实际数量	在 Shopify Facebook 渠道设置中将数据共享设为 Maximum，或在 WooCommerce Facebook 插件中启用 CAPI
动态产品广告显示的价格错误	Shopify/WooCommerce 目录最多每 24 小时同步一次；如需及时更新价格，请手动触发同步
使用原生集成后 EMQ 评分仍然较低	前往 Meta Events Manager → 检查是否显示浏览器和服务端事件；确认集成已获得完整授权
iOS 14+ 广告系列覆盖人数较低	前往 Meta Business Manager → Brand Safety → Domains → 验证你的域名；启用 Aggregated Event Measurement
广告账户被停用	切勿通过 API 发送原始（未哈希）PII；请使用会自动对所有数据进行哈希处理的官方 SDK

相关技能

• @google-ads-ecommerce
• @tiktok-ads-integration
• @google-shopping-feed
• @email-marketing-automation
• @marketing-attribution-dashboard