将 Meta Pixel 和 Conversions API 连接到 cPixel

我该如何将 Meta 连接到 cPixel?

在 cPixel 中打开目的地,选择 Meta,并粘贴来自 Meta Events Manager 的两个值:位于您数据集 Settings 下的 Pixel ID,以及在同一标签页更下方生成的 Conversions API 访问令牌。当 Meta 询问时,选择 Set up without Dataset Quality API。然后在实时中查看 Meta 对每次服务器端发送的回复。

粘贴到 cPixel

  1. 在 cPixel 中打开目的地,点击连接平台下的 Meta 图标。设置 Meta 会打开并显示粘贴您的 ID。
  2. 粘贴Pixel / 数据集 ID(在哪里找到)和 Conversions API 访问令牌(如何获取)。没有令牌时,该账户将是仅浏览器端。
  3. 如果需要,可在为此账户命名(可选)中为账户命名,然后点击继续。
  4. 在选择选项中,保持从浏览器发送事件和从我们的服务器发送事件两项勾选。除非有其他工具向该数据集发送数据,否则请保持否——由 cPixel 负责 Meta(推荐);尽管名称如此,选择是——保留该应用,cPixel 将停止对 Meta 的服务器端发送会同时停止 cPixel 向该像素的浏览器端和服务器端发送(每个像素一个发送方)。高级设置是可选的(订单规则)。
  5. 点击保存并继续。测试一下会确认Meta 已连接。

已填写像素 ID 且以掩码形式粘贴了 Conversions API 访问令牌的“设置 Meta”对话框,可以点击继续

您可以连接多个 Meta 像素,它们会共享 cPixel 的事件 ID,但不能重复连接同一个像素。

Meta Pixel ID 在哪里可以找到?

在 Meta Events Manager 中选择您店铺的 Web 数据集并打开 Settings:其中的 Pixel ID(约 15 位数字)需要填入 cPixel 的Pixel / 数据集 ID字段。Meta 在几乎其他所有地方都将其称为数据集 ID。

  1. 找到您的数据集。Shopify 店铺使用的 Web 数据集带有显示器图标;电话图标表示应用数据集。

    Events Manager 概览页面列出了三个数据集及其集成方式和事件数量;Web 数据集带有显示器图标,应用数据集带有电话图标

  2. 选择它。在事件到达之前,新数据集会显示 Your pixel hasn’t received any activity。

    在 Events Manager 中选择了一个新的 Web 数据集,显示 Your pixel hasn’t received any activity 以及 Continue Pixel Setup 按钮

  3. 打开 Settings,复制 Details → Pixel ID 下方的数字。

    Events Manager 中数据集的 Settings 标签页,Details 下方有 Pixel ID 字段;ID、Creator 和 Owner 的值已打码

提示: 两个数据集可能使用相同的名称。如果只有其中一个能够生成令牌,那么它们其实是不同的数据集:请检查 ID。

我该如何获取 Conversions API 访问令牌?

在同一个 Settings 标签页的 Conversions API 下,选择 Set up without Dataset Quality API,然后点击 Generate access token。勾选该店铺的数据集,并立即复制以 EAA 开头的长字符串令牌:Meta 只会显示一次,也不会保存它。

  1. 将 Settings 向下滚动到 Conversions API。下面的截图与 Meta 自身的界面一样,在 Set up direct integration 下显示这些选项;而 Meta 的指南文字中写的是 Set up manually。请以您账户中实际显示的为准。

    数据集 Settings 中的 Conversions API 部分,在 Set up direct integration 下选中了 Set up without Dataset Quality API,并显示 Generate access token 按钮

  2. 选择 Set up without Dataset Quality API(原因)。
  3. 点击 Generate access token,并勾选该店铺的数据集。
  4. 在关闭面板之前复制令牌。Meta 的提示原文如此:Copy and save this token somewhere safe. It won’t be stored by Facebook.

    Meta 的令牌面板,上方提示 Copy and save this token somewhere safe, it won’t be stored by Facebook,下方是打码后的令牌

  5. 将其粘贴到 cPixel 的 Conversions API 访问令牌字段中。

重要: 如果 Generate access token 显示为灰色(悬停时提示 Missing prerequisite),说明您不是拥有该数据集的商务组合的管理员或开发者(Meta);使用个人广告账户创建的数据集就会出现这种情况。请联系商务组合的管理员,或在 Meta Business Suite 的 Settings 中的 Data sources 下将数据集添加到商务组合。

令牌只对您勾选的数据集有效。Meta 没有说明 Events Manager 生成的令牌能使用多久,但如果其系统用户失去了对该数据集的访问权限,令牌就会失效,Meta 会将其报告为权限错误。

我需要设置 Dataset Quality API 吗?

不需要。cPixel 不需要它,而且 Meta 的对话框会提示,一旦某个数据集使用了 Quality API,目前就无法选择退出。Meta 将其标记为 Recommended,并表示它会增加诸如事件匹配率之类的指标;不使用它创建的令牌仍会发送相同的事件。

如果不设置,cPixel 的事件质量页面可能会显示此种类型的令牌无法获取 Meta 的评分,这正是 Quality API 会额外提供的唯一项目。发送本身不受影响。

cPixel 会向 Meta 发送什么?

PageView、ViewContent、Search、AddToCart、InitiateCheckout 和 AddPaymentInfo 会同时从买家的浏览器和 cPixel 的服务器发送,二者共用同一个事件 ID。Purchase 只从服务器发送,由 Shopify 订单重新构建而成。这里没有需要配置的去重设置。

  • 只要 cPixel 向该像素的服务器端发送处于活动状态,浏览器端的 Purchase 就会被关闭。它只会在服务器端发送关闭或暂停时才会触发:没有令牌、令牌被拒绝、服务器端发送开关被关闭,或 Free 套餐暂停期间。
  • 浏览器端的路径运行在 Shopify 的 Web Pixel 中,会在包括结账页在内的每个页面上执行,因此不需要应用嵌入。
  • 服务器端发送携带经过哈希处理的邮箱、电话号码、客户 ID 和设备 ID,_fbp 和 _fbc,IP 地址和用户代理,以及默认情况下根据 IP 地址推测并经过哈希处理的位置信息。Meta 需要营销同意。详情请参阅cPixel 发送的内容,以及同意如何改变它。

我应该使用测试事件代码吗?

只有在您想使用测试连接时才需要。cPixel 只会将该代码用于该测试,以及对 7 天内没有成功发送记录的账户进行的夜间检查,无论向导中的提示怎么写,实际事件从不携带该代码。该测试会发送一个真实的 PageView,Meta 会保留它用于定向和衡量。

  • 从数据集的 Test events 标签页复制以 TEST 开头的代码,粘贴到测试事件代码(可选)中,然后点击测试连接:显示运行正常即表示 Meta 已接受该测试事件。
  • 真实事件不携带该代码,因此您的购买事件不会出现在 Test events 中;请在数据集的 Overview 中查看。

我该如何确认它已经生效?

在实时中开始一个会话并浏览您的店铺:每次向 Meta 发送的服务器端事件都会显示 Meta 的回复——已接受、已拒绝或错误,以及 HTTP 状态码。然后在 Events Manager 中确认,Meta 表示您应该能在 20 分钟内看到事件。

  1. 在 cPixel 中打开实时并点击开始会话。
  2. 在另一个标签页中查看某个商品并将其加入购物车。
  3. 打开一个服务器行:在发送至下,Meta 显示已接受。浏览器行不携带回复。
  4. 在目的地中,该账户现在会显示为已验证。

    Meta 目的地卡片,显示一个已连接的像素 1234567890123456,标记为已验证,浏览器和服务器发送均为开启,最近一次发送为刚刚

  5. 在 Events Manager 中,数据集的 Overview 会将 Purchase 的集成方式显示为 Conversions API,其他事件则显示为 Multiple,表示同时来自浏览器和服务器。

要查看购买事件,请下一笔真实订单:cPixel 默认会跳过测试订单。

如果不生效该怎么办?

如果 Meta 将访问令牌拒绝为无效或已过期,cPixel 会将该账户标记为令牌无效,停止其服务器端发送,并向您店铺的联系地址发送一封紧急提醒邮件;首页会显示修复 Meta。浏览器跟踪会继续运行。

  1. 点击首页上的修复 Meta,或在目的地中点击该账户旁边的管理。
  2. 生成一个新令牌,并粘贴到已保存——粘贴新值即可替换上方。
  3. 点击继续,然后点击保存并继续。

像素 1234567890123456 的“管理 Meta”对话框,访问令牌标记为已保存,带有移除链接,并注明该令牌不会再次显示

您看到的情况 应对方法
Generate access token 显示为灰色 获取该数据集所属商务组合的管理员或开发者权限
测试连接:平台拒绝了此令牌 生成一个新令牌
测试连接:平台拒绝了该账户的测试事件 ID 有误,或该令牌属于另一个数据集
首页上出现Meta rejected an event,原因是权限问题 恢复系统用户的访问权限,或生成一个新令牌
实时中购买显示已跳过 查看原因,然后参阅购买未显示
购买被重复计算 有其他工具正在向该数据集发送数据:每个像素一个发送方

在管理 Meta中点击移除会停止发送并删除已保存的令牌;您可以使用相同的 ID 重新连接。Meta 官方指南:Conversions API: get started。

需要 cPixel 方面的帮助?请发送电子邮件至 support@b2bgold.app。