Communitygithub.com

ooiyeefei/ccc

在网站上设置 Meta Pixel(Facebook/Instagram 广告跟踪),并端到端触发一个转化事件(Lead、CompleteRegistration、Purchase)。引导用户完成 Business Suite / Events Manager 操作,创建或查找 Pixel/Dataset ID,安装基础代码,触发标准事件,并在投放广告前使用 Meta Pixel Helper 进行验证。

ccc 是什么?

该技能旨在帮助开发者或网站运营者在自己的网站上完整部署 Meta Pixel(Facebook/Instagram 广告跟踪),从账户准备、Pixel 创建、代码安装、事件触发到广告投放前的验证,形成闭环。它特别强调两个常见陷阱:一是 Meta 设置向导会积极推荐更复杂的“Conversions API(CAPI)”,但技能建议先从简单的浏览器端 Pixel 开始,仅在确认浏览器信号损失(如广告拦截器、iOS ATT)可衡量且已解决好隐私/同意问题时才考虑添加 CAPI;二是创建数据集时,Meta 要求选择数据类别,但技能指出金融、健康等敏感类别可能触发 Meta 的限制数据处理策略,导致广告优化受阻,因此建议除非绝对必要,否则留空。该技能支持 Next.js、纯 HTML、WordPress、Shopify、GTM 等主流技术栈,并强调在投放广告前必须使用 Meta Pixel Helper 或 Events Manager 的测试事件功能验证转化事件正确触发,否则广告优化会丢失方向。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ooiyeefei/ccc/tree/HEAD/skills/meta-pixel-setup

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

ccc preview

文档

Meta Pixel 设置

让 Meta Pixel 在网站上跟踪真实的转化事件,经过验证,从而为 Facebook/Instagram 广告优化提供真实的学习数据。两件事经常让人困惑,本技能会提前处理它们:Pixel vs. Conversions-API 的决策(Meta 的向导会激进地推荐更重的那种)和需要声明的数据类别(错误的选择可能会限制你的广告)。

命名说明:Meta 已将 UI 中的 "Pixel" 重命名为 "Dataset"。一个数据集包含 pixel,且其 Dataset ID = Pixel ID(一个约 15-16 位的数字)。将这两个词视为同一事物。

从用户当前的位置开始

设置是一个链条:Facebook 主页 → 商业账户 → Events Manager → Pixel/Dataset(获取 ID)→ 网站上的基础代码 → 转化事件 → 验证。 人们可能从链条的中间进入。先问清楚,然后再介入——不要重新创建已经存在的东西(企业通常已有 pixel;重复使用它,而不是将数据碎片化到两个地方)。

询问(根据他们所说的内容进行调整):

  1. 你是否已经设置了 Facebook 主页和 Meta Business Suite / 商业账户?
  2. 你是否已经有 Pixel / Dataset(在 Events Manager 中)?如果有,Dataset ID(那个约 16 位的数字)是多少?把它粘贴出来——这可能就是全部所需。
  3. 哪个一个转化事件最重要(潜在客户/候补名单提交、注册、购买)?广告将针对这个进行优化。
  4. 网站的技术栈 + 域名(Next.js、纯 HTML、WordPress、Shopify)——决定代码如何嵌入。

如果他们已经拥有 Dataset ID 和一个主页,直接跳到安装(§3)。不要带他们回头重新创建他们已经完成的账户。

决策 1:仅 Pixel,还是 + Conversions API?(先从仅 Pixel 开始)

Meta 的设置向导会显示 “Conversions API and Meta Pixel(推荐)”,并附带一个闪亮的统计数据。不要不经思考就选择它。以下是诚实的权衡:

  • Meta Pixel(浏览器端)——网站上的代码片段从访问者的浏览器发送事件。简单,无需后端,立即可用。这是你启动所需的一切。
  • Conversions API(CAPI)——你的服务器直接向 Meta 发送事件。它是服务器到服务器的,“需要开发者支持”,并且要真正发挥作用,它需要向 Meta 发送客户个人身份信息(PII)(电子邮件、电话、IP)以进行匹配。这需要更多的构建工作以及更大的隐私/合规性风险(GDPR/PDPA/CCPA)。

因此:先用浏览器 Pixel 启动。 稍后再添加 CAPI,仅当浏览器信号损失(广告拦截器、iOS ATT)确实对你造成可衡量的影响,并且你已经解决了 PII/同意问题时才添加。将 CAPI 视为发布后的优化,而不是设置步骤。在连接它之前,请先阅读 references/conversions-api.md——它的存在是为了防止你意外地向 Meta 发送个人数据。

决策 2:Dataset“类别”——除非明确匹配,否则留空

创建数据集时,Meta 要求“选择任何适用的类别。” 这对于金融/健康/敏感产品来说是一个陷阱。 对话框警告:“根据类别和位置,数据共享可能受到限制或被阻止。”诸如 “金融服务”、“经济脆弱性”、“个人困境”、“国籍” 等类别会触发 Meta 的受限数据处理,并且可能限制或阻止你的广告优化。

规则:只有当某个类别准确且不可避免地描述了你的业务,并且你理解它会限制数据时,才勾选它。 预算/生产力/SaaS 工具是软件,而不是“金融服务”(该类别适用于贷款机构、信用报告、消费金融)。如有疑问,让类别保持为空(这是可选的)——空意味着没有限制,这正是普通的候补名单/注册测试所需要的。

1. 创建或查找 Pixel/Dataset(获取 ID)

在 Events Manager 中:

  1. 左侧边栏 → 连接数据(绿色 +)→ Web → Meta Pixel → 连接。(或者,如果数据集已存在,点击它——ID 就在其名称下方。)
  2. 以业务命名(例如“Acme Web”)。关于类别,请参阅决策 2(通常留空)。
  3. 复制 Dataset ID——名称下方那个约 16 位的数字。之后也始终可以在 Events Manager → Datasets 中看到。
  4. 如果它启动了一个“设置/连接你的网站”向导,提供 Conversions-API 与 Pixel-only 的选项——你可以关闭/跳过它。你只需要 ID;代码将手动放入(§3)。如果你确实继续,选择 仅 Meta Pixel(决策 1)。

2.(可选)重用现有的 pixel

一个 pixel 不像 GA4 属性那样是一道硬性的报告壁垒。一个 pixel 可以覆盖整个域名——主应用以及一个 /waitlist 落地页。通过事件和自定义参数(例如 content_name: 'waitlist')来区分漏斗,而不是使用第二个 pixel。如果企业已经有一个,请重用其 ID。

3. 安装基础代码

将其粘贴到每个页面的 <head> 中,替换 YOUR_PIXEL_ID。它会自动触发 PageView。(从 Events Manager 复制你的确切代码片段——它预填充了 ID——或者使用此规范形式。)

<!-- Meta Pixel Code -->
<script>
!function(f,b,e,v,n,t,s)
{if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t,s)}(window,document,'script',
'https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
  src="https://www.facebook.com/tr?id=YOUR_PIXEL_ID&ev=PageView&noscript=1"/></noscript>
<!-- End Meta Pixel Code -->

不要添加 integrity/SRI 哈希值——fbevents.js 是一个版本化的加载器,Meta 会就地更新且不发布稳定哈希值;SRI 会导致它出错。特定框架的安装(Next.js next/script、WordPress、Shopify、GTM)请参见 references/install-by-platform.md。

4. 在操作成功时触发转化事件

使用标准事件,以便 Meta 的优化和报告能够识别——Lead(候补名单/联系)、CompleteRegistration(注册)、Purchase(销售)。完整列表以及何时使用每个事件:references/standard-events.md。仅在实际操作真正成功之后才触发它,绝不要在捕获到错误时触发。

<script>
form.addEventListener('submit', async function (e) {
  e.preventDefault();
  try {
    await saveTheLead(/* ... */);          // 1. 先持久化——真正的成功
    if (window.fbq) fbq('track', 'Lead', { // 2. 然后,才计数(为拦截器做防护)
      content_name: 'waitlist',            // 可分段,仅非 PII 参数
      value_bucket: 'high'
    });
    window.location.href = '/thank-you';
  } catch (err) {
    showError('出现问题,请重试。');  // 不触发事件,不伪造成功
  }
});
</script>

PII 规则——不要通过浏览器 Pixel 发送个人数据

切勿将电子邮件、电话、姓名或地址作为事件参数传递。发送类别/桶(content_name、价值区间、角色)——足以分段,而不是识别身份。(Meta 确实使用哈希 PII 的唯一地方是 CAPI 的高级匹配,这是一个刻意的、经过同意的、服务器端的选择——请参见 references/conversions-api.md,而不是要混入浏览器事件中的东西。)

5. 在花钱之前验证——关卡

在真实网站/预览网站上进行一次真实的转化,然后确认:

  • 安装 Meta Pixel Helper Chrome 扩展。加载页面→它会显示 pixel + PageView。提交表单→它会显示 Lead 事件以及你的参数。
  • 或者 Events Manager → 你的 dataset → Test events,输入网站 URL,然后实时观察事件到达。
  • 仅在成功时触发: 制造一个失败,并确认该事件没有触发。

只有在你能够看到转化事件正确触发之后,才应该开始投放广告预算。错误连接的转化会使 Meta 针对错误的人群进行优化,而你无法从仪表盘中分辨出来。完整检查清单:references/verify-checklist.md。

“你能帮我设置这个吗?”

账户/主页/商业套件/Pixel 创建需要用户自己的 Meta 登录——无法代劳;这是一个简短的 UI 引导(本技能会指导)。获取 Dataset ID 是用户唯一的工作。助手可以在获得 ID 后,将基础代码和事件代码写入网站。按此分工——并根据上述两个决策,引导他们远离 CAPI 向导和敏感类别。

参考文件

  • references/install-by-platform.md —— 针对 Next.js、HTML、WordPress、Shopify、GTM 的基础代码安装。
  • references/standard-events.md —— Meta 标准事件名称及常见转化事件的参数。
  • references/conversions-api.md —— CAPI 是什么,何时值得使用,以及在连接之前的 PII/同意保护措施。
  • references/verify-checklist.md —— 投放前的验证关卡(Pixel Helper、Test Events、常见失败原因)。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能