Facebook 转换 API (CAPI)

2 min read

Facebook 转换 API (CAPI) #

将像素事件直接发送到 Facebook 的服务器,绕过浏览器限制或广告拦截器

如何使用 PixelYourSite 设置 CAPI 事件以及如何测试它们

转换 API (CAPI) #

Conversion API 允许您的网站将事件直接发送到 Facebook 的服务器。这些事件与您的像素相关联,并由 Facebook 像浏览器事件一样处理。

CAPI 事件的主要优点是它们将绕过浏览器的限制或广告拦截器。

如何使用 PixelYourSite 配置 CAPI #

获取令牌 #

前往活动管理器

选择要配置的像素,然后单击Settings。 

向下滚动,直到看到“Conversion API”,然后单击“Generate Access Token”

通过单击复制令牌。

将令牌添加到 PixelYourSite #

打开您的 PixelYourSite 插件并在 Pixel ID 下的专用字段中添加令牌。选中发送 CAPI 事件、滚动页面和保存的选项。

PixelYourSite 将开始随浏览器事件一起发送 CAPI 事件。作为最后一步,您应该删除网站上可能存在的任何缓存。这将确保将最新版本的代码立即提供给您的用户。

如何测试 CAPI 事件 #

要测试 CAPI 事件,请进入您的事件管理器

单击测试事件并复制测试代码。

打开 PixelYourSite 插件并在像素 ID 下方的专用字段中添加文本代码。滚动页面,然后保存。如果您有缓存插件,请删除缓存。 

开始浏览您的网站以触发事件。 

确保您不使用排除的角色进行测试。您在插件的主页上有此选项。 

返回事件管理器,您将看到测试下报告的事件。

您将开始看到成对的浏览器和服务器事件,其中服务器事件被删除了重复数据。 

单击事件以查看其参数或其事件 ID。

只有在打开事件管理器的浏览器窗口中触发的浏览器事件才会在测试中报告。如果您在隐身窗口或其他浏览器中浏览您的网站,则会记录浏览器事件,但不会报告。在这种情况下,您将只看到重复数据删除的服务器事件。

要查看活动的服务器事件,请安装广告拦截器并浏览您的网站。Facebook 将只获取服务器事件,因此不会对它们进行重复数据删除。

可能会不时看到警告。其中一些警告可能是误报。我们注意到与旅行无关的事件缺少旅行参数相关的警告。

完成测试后,从 PixelYourSite 中删除测试代码。 

CAPI 事件是浏览器事件的备份 #

转换 API 事件不会取代浏览器事件,它们作为备份工作。如果由于某种原因浏览器事件不起作用,Facebook 将使用 CAPI 事件。

这意味着每个事件实际上被发送两次,一次使用浏览器,一次使用转换 API。

重复数据删除事件 #

为了让您的事件报告准确无误,Facebook 会在发送浏览器事件时对服务器事件进行重复数据删除。重复数据删除意味着当浏览器和服务器事件都收到时,浏览器事件被处理,服务器事件被丢弃。

事件编号 #

在对事件进行重复数据删除时,Facebook 使用两个重要信号:事件名称和事件 ID。当一对服务器和浏览器事件具有相同的名称和相同的 ID 时,服务器事件将被删除重复。

PixelYourSite 始终为每对浏览器-服务器事件广告一个唯一的事件 ID。

去重事件和缓存 #

事件重复数据删除的关键元素是事件 ID。这对于每对浏览器/服务器事件必须是唯一的。 

缓存问题 #

有时缓存插件会存储页面的完整代码,包括事件 ID。这意味着当页面被不同的用户访问时,相同的事件 ID 将一次又一次地传递。对于 Facebook 而言,这些事件可能看起来是相互关联的,因此被忽视了。 

解决方案 #

为了克服这个问题 PixelYourSite 用户 admin-ajax,以这种方式绕过缓存。 

您可以从插件的主页启用或禁用 admin-ajax 的使用。

如果禁用 admin-ajax,最好检查事件 ID 对于每对事件是否确实是唯一的。 

测试事件 ID #

您可以使用Pixel Helper Chrome 扩展程序或事件管理器测试工具来完成

在隐身窗口中打开一个页面。使用 Pixel Helper 检查事件并查找其事件 ID。刷新页面并检查相同的事件。如果事件 ID 不同,则没问题。这意味着事件 ID 未缓存且重复数据删除工作正常。

请记住,Pixel Helper 仅显示浏览器事件,但对于本次测试,这已经足够了。在此页面上,您还将学习如何测试服务器事件。

CAPI 事件数据 #

参数 #

发送 CAPI 事件时,PixelYourSite 会尝试发送与浏览器事件相同的一组事件参数。我们无法收集的唯一参数与访问者的浏览器时间有关,因此仅针对浏览器事件发送这些参数。

匹配键和用户数据键 #

CAPI 事件还会发送附加信息,帮助 Facebook 将用户与 Facebook 帐户进行匹配。

浏览器 ID、Facebook 点击 ID (FBC)、Facebook 浏览器 ID (FBP) 是使用 Facebook 自己的库收集的。这些被称为匹配键。

如果可能,事件还包含有关您的用户的数据,例如电子邮件、名字、IP 地址、姓氏、电话、城市州、邮政编码。这些被称为用户数据密钥。

该插件可以在访问者登录您的网站时发送用户数据密钥,并且存在与 WordPress 帐户相关联的数据。WooCommerce 和 Easy Digital Downloads Purchase 事件可以从订单的详细信息中获取。

赛事比赛质量 #

使用匹配键和用户数据键,Facebook 尝试将事件与 Facebook 帐户匹配。

由于购买事件可以访问更好的用户数据键,因此您可以期望它们获得更好的匹配分数。未登录的访问者触发的事件的分数可能较低。

诊断 #

有时,您会在“诊断”选项卡下看到一些与 CAPI 事件报告相关的错误。有时这些错误是误报或可以忽略。


服务器发送事件的无效匹配键参数 #

您的服务器正在为您的事件发送无效的 fbp、ip_address、user_agent 参数值。这可能是因为参数值存在错误。
这可能会导致使用此事件的广告活动的归因和投放优化出现问题。

我们不时看到这个错误。这可能是由机器人触发像素引起的,脚本无法正确识别 fbp、ip_address、user_agent 值。

它是边缘的,你可以忽略它。


许多事件实例收到相同的事件 ID #

您为多个事件实例发送相同的事件 ID。事件 ID 是唯一标识符,用于对从您的 Pixel 像素代码和 Conversions API 接收到的相同事件进行重复数据删除,这样它们就不会被计算两次。为确保 Facebook 准确统计您的事件,每个唯一事件实例都需要自己唯一的事件 ID。
这可能会导致事件衡量和广告活动归因出现问题。

这确实与之前解释的缓存问题有关。测试您的事件并确保每个浏览器/服务器事件都有唯一的事件 ID。

另一种可能的解释是页面源被其他网站复制和提供。这可以是 Google 的缓存、Google 翻译或其他东西。您只能从事件管理器设置页面限制像素在您的域上触发。查找流量权限并创建允许列表。

它也可能只是一个误报。

测试并确认每对浏览器/服务器事件的事件 ID 是唯一的,并将像素仅限于您的域。一旦你做到了这些,你就可以忽略这个问题了。


发送数据的新域 #

您的像素最近开始从这些域发送事件

这可能是也可能不是错误。解决方案是创建一个允许列表,其中包含可以使用像素的域。

转到事件管理器,单击设置,查找流量权限,然后创建一个允许列表。