• 《跨境公海》新年大福利送到!本站会员社区已正式开通,大家可以在社区建群、提问、交友、组织会员活动啦。社区介绍
  • 《跨境公海》分享最专业的知识、技能与资源,欢迎卖家企业与团队集体加入学习!加入社区
  • 《跨境公海》免费为您提供亚马逊和Shopify独立站选品与营销大数据服务,提交需求
  • 分享《跨境公海》好文到微信群或者收藏到个人朋友圈赚积分,还有机会可获得价值数万元的William亲授教学或顾问!

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

Facebook 米校 5个月前 (07-13) 246次浏览 已收录 0个评论 扫描二维码
文章目录[隐藏]

在本文中,您将学习如何设置 Facebook 的新转换 API

我们包含了视频、示例脚本/代码和示例决策树。请将其导入您的 LeadsHook 帐户。

假设

本指南将帮助您设置 Facebook 的对话 API。它不提供我们的免费支持,因为设置因企业而异,并且完成这些步骤所需的步骤适用于技术受众。

更新:2020 年 6 月 16 日

我们为 LeadsHook 添加了更新,因此消除了许多复杂性。

如果需要,我们确实提供付费帮助,或者请在 LeadsHook 用户组中发帖,以从我们出色的“技术”用户那里获得更多帮助。

我们假设您已经知道或拥有您的 Facebook 像素设置。

背景

随着Apple 新 iOS 更新(从 v. 14.5+ 开始)的引入,跟踪受到了严重限制。这些限制之一是 cookie 保持活动的时间长度。因此,未正确报告转换数。

这个来自 Facebook 的“新”转换 API(实际上它并不是新的)。Conversions API 已经提供了几年。iOS 更新使转换变得更加重要。

设置过程摘要

  1. LeadsHook:将浏览器信息保存到自定义字段中
  2. LeadsHook:将客户信息保存到自定义字段(决策树的一部分)中。
  3. LeadsHook:格式化数据
  4. LeadsHook:哈希数据
  5. LeadsHook:更新客户端事件以进行重复数据删除
  6. Facebook:设置 FB 转换 API
  7. Facebook:构建 API URL、插入 API 令牌、API 版本和像素 ID
  8. LeadsHook:向 Facebook 发送数据

这个转换 API 有什么特别之处?

由于像素的限制,在某些情况下,转换数据不会返回到 Facebook。此转换 API 使用 API 报告相同的转换。它也称为服务器端 API。基本上,转换信息是从服务器而不是从浏览器直接发送到 Facebook 的。

优点是 Apple 无法阻止服务器端 API 通信,因为到 Facebook 的消息是通过“反向通道”发送的,即直接从 LeadsHook 服务器到 Facebook 服务器的 API 调用。

任何服务器端转换 API 都是更强大的解决方案。

我还需要我的 Facebook Pixel 吗?

简答:是

长答案:您需要从 Facebook 传递一些信息,以便它知道哪些活动、广告集、广告(以及 Facebook 跟踪的一堆其他信息)导致了转化。

服务器端 API 所做的就是将这些详细信息发送回 Facebook,以便它可以匹配转换。

处理潜在的重复转换

现在,这产生了一个问题。基于像素的转换并没有死(它们只是不那么可靠)。

如果像素发送转换并且服务器端 API 也发送转换,会发生什么情况。这将记录 2 次转化,这显然夸大了您的转化。该技术术语称为DEDUPLICATION。我们将在下面的第 7 步中完成此操作

设置 Facebook 转换 API 的步骤

这是一个摘要视频来解释整个过程……

在此处下载决定: https : //www.leadshook.com/help/facebook-conversions-api-v3_2021-07-10/

2020 年 7 月 10 日更新:上述决策树已更新为用于 ViewContent 服务器端 API 调用的新 Webhook 节点。

#0:警告!设置可能很困难

希望本文能减少您花在此设置上的时间。

截至 2020 年 5 月,有关服务器端设置的 Facebook 文档存在一些不一致之处。

不一致之处之一是他们的服务器端 API 转换工具所说的需要与他们在一份更具技术性的文档中解释的不同。事件参数之一,“action_source”未在转换 API 转换工具中列为参数,但在像素助手中是必需的……

我们已将此参数包含在示例设置中(见下文)

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)
应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

#1:将正确的参数传递给 Facebook

您的转换 API 调用的匹配率取决于您需要发送的参数的质量。

发送到 Facebook 的数据有 4 种不同类别的参数……

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

在此处查看完整的参数列表:https : //developers.facebook.com/docs/marketing-api/conversions-api/parameters

接受事件所需的参数数量最少。

For a better match, you can send more info especially about your customers and leads.

There are params you need to send that helps with deduplication.

This article will give examples using ‘ViewContent’ and ‘Lead’ events but you can use any other standard event as well. Please see the complete list of standard events and their required parameters here: https://developers.facebook.com/docs/facebook-pixel/reference#standard-events

Here is a comprehensive list of parameters you can pass, what they mean and where do you get them from. You’ll also see numbers/letter and associated scripts below. These scripts are designed to grab and save the data into various custom fields.

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

TIP! Please ensure you have setup custom fields for ALL of the variables you want to pass in your api call. And, ensure the you are correctly formatting the values of our parameters. E.g. Event time is a NUMBER is not wrapped in inverted commas ” “.

TIP! When you import the sample decision tree above your LeadsHook account will auotmatically create all of the fields that we have used in the sample decision tree. If you are using the SAME custom fields then you do not need to setup any additional custom fields.

LeadsHook automatically provides quite a few of the custom fields you need for your serverside setup. Please watch the video above for more details.

Here are list of custom fields you’ll need…

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

EVENT_TIME: Use _c_eventtime

EVENT_ID: Use _c_eventid

EVENT_SOURCE_URL: Use _c_eventurl

CLIENT_USER_AGENT: Use _c_useragent

CLIENT_IP_ADDRESS: Use ip_address

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

FBC COOKIE and FBCLID: Add fbclid custom field & Node Level Script

Note: Grab this from the cookie and fbclid from the url parameters. Since LeadsHook automatically grabs urls params as long as the custom field exists, create a custom field called ‘fbclid’.

Please create a new ANSWER text field called ‘fbclid’…

TIP! Also add the script provided under FBP COOKIE VALUE and save the _fbc cookie into its own custom field in addition to fbclid url param method shown below. Only 1 is needed for the conversion API.

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

FBC Cookie: Save cookie into using this LeadsHook function, DT.grabCookie(‘custom_field’,’cookie_variable’)

Add this to any node level script BEFORE your API call to Facebook using a Webhook Node. In our sample decision tree, we added it to the first node.

<script>
DT.grabCookie('fbc', '_fbc')
</script>

FBP COOKIE 值:添加节点级脚本

FBP Cookie:使用这个 LeadsHook 函数保存 cookie,DT.grabCookie(‘custom_field’,’cookie_variable’)

在使用 Webhook 节点对 Facebook 进行 API 调用之前,将此添加到任何节点级脚本中。在我们的示例决策树中,我们将其添加到第一个节点。

<script>
DT.grabCookie('fbp', '_fbp')
</script>

#2 格式化参数值

请确保您以正确的格式发送参数。发送客户数据时,需要使用小写。这包括电子邮件地址。

在 LeadsHook 内的每个文本编辑器块上方,您会看到找到一种简单的方法来查找案例过滤器列表……

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)
应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

小费!您可以使用上面列出的 16 种情况中的任何一种来转换任何自定义字段值。对于 Facebook 转换 api,将小写过滤器添加到所有自定义字段,如下所示……

{custom_field:lowercase}
{first_name:lowercase}
{email:lowercase}

下面提供的示例决策树和代码包含更多示例。

此处的客户信息参数和格式要求的完整列表:https : //developers.facebook.com/docs/marketing-api/conversions-api/parameters/customer-information-parameters

电话特殊格式要求

电话号码需要格式化,以便它们不包含任何空格、括号或任何特殊字符,如“+”。

示例:这款手机的不同格式:

  • +1(415)963 9564
  • 0011 1 415 963 9563
  • +1415 963 9564
  • 415-963-9563
  • 415 963 9563
  • (415) 963 9563

…需要“清理”,所以最终数字是

14159639564

在 LeadsHook 中将电话号码转换为正确的格式非常容易。您可以使用过滤器来转换数据。

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

使用以下过滤器将您的电话号码转换为 Facebook 要求的格式

raw|international|no_leading_plus

请注意!您还没有完成 – 在 Facebook 接受您的 API 调用之前,您仍然需要添加 HASH 过滤器。

#3:如何在发送到 Facebook 之前散列您的客户信息参数

在 LeadsHook 中散列信息非常简单。事实上,我们为您提供了 5 种不同的哈希过滤器。Facebook 要求使用 SHA256 对客户信息进行哈希处理。

您可以散列 Facebook 的任何自定义字段数据添加以下过滤器…

sha256

小费!使用可以使用这个测试工具来确认你的哈希值:https : //emn178.github.io/online-tools/sha256.html

您的最终 API 调用将包含带有大小写过滤器、数据格式过滤器和散列过滤器的自定义字段。这里有些例子…

Email hashed: {email|sha256}
Phone formatted & hashed: {phone_number|raw|international|no_leading_plus|sha256}
First name, lowercase & hashed: {first_name:lowercase|sha256}
Last name, lowercase & hashed: {last_name:lowercase|sha256}

#4:Facebook 像素设置和检查

本文不会介绍设置像素的基本知识。假设您已经知道如何执行此操作。

您可以打开高级匹配,如下所示。我们将使用手动匹配,因为它提供了更大的灵活性并且适用于更多用例。

如果您在受监管的垂直行业工作,则无法做到这一点。您仍然可以手动设置它,如步骤 4 中所见。

如果您的企业在受监管的行业中,请使用手动高级匹配:我们不允许受监管的行业中的企业使用自动高级匹配。

https://www.facebook.com/business/help/930861050579797

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

#5:Facebook 转换 API 设置

服务器端 URL 格式:

https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events?access_token={TOKEN}

以下是获取 API_VERSION、PIXEL_ID 和 TOKEN 值的方法……

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

在您添加帐户中变量的值后,它应该看起来像这样……

https://graph.facebook.com/v10.0/12345679891234567/events?access_token= ecewocon38dy82dh423h2444f44wcehwche48c843

#6:重复数据删除设置

重复数据删除只是一种奇特的说法,如果您通过像素发送数据,即像 ViewContent、Lead 这样的客户端事件,并且还通过服务器端 API 发送相同的信息,那么您发送的是重复的转换数据。

Facebook 提供了一种删除任何重复项的方法,而且非常简单,因为我们已经完成了上述工作。 🙂

关于重复数据删除的视频…

方法一(脸书推荐)

发送事件名称和事件 ID。

方法二

发送事件名称、fbp 像素值和/或外部 ID。

我们已经有了事件名称和 fbp 像素值。对于外部 ID,我们建议您使用 LeadsHook、lead_id,因为它既简单又有效。但是您也可以自由使用任何其他 ID。您需要做的就是在将其发送到 Facebook 之前对其进行哈希处理。

我们建议全部发送:事件名称、事件 id、fbp 像素和外部 id。在左侧的“服务器端转换”下标记为黄色)。

您需要对客户端事件进行最后的小调整。在右侧的“客户端转换”下标记为黄色。

重要的!请确保为您的服务器端和客户端事件使用相同的事件 ID 值,如下所示。

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

#7:测试与确认SETU p

从上面下载示例决策树

  1. 从你的像素中获取测试参数……
应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

2. 使用“test_event_code”参数更新您的有效负载,如下所示。

应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

3) 为您的潜在客户事件添加一个 Webhook 节点

您还可以添加查看内容事件

4)按如下方式设置您的网络钩子……

添加到 Webhooks 节点的示例负载。

小费!请根据需要进行调整。我们留下了一些散列值用于测试。例如性别(ge):用于测试。对于您的有效负载,您必须添加一个自定义字段,如 {fb_gender:lowercase|sha256}。以下值需要使用您的自定义字段进行更新。下面的散列值仅用于快速测试。

{
    "data": [
        {
            "event_name": "Lead",
            "event_time": {_c_eventtime},
            "action_source": "website",
            "event_id": "{_c_eventid}",
            "event_source_url": "{_c_eventurl}",
            "user_data": {
                "client_user_agent": "{_c_useragent}",
                "client_ip_address": "{ip_address}",
                "fbc": "{fbc}",
                "fbp": "{fbp}",
                "em": "{email|sha256}",
                "ph": "{phone_number|raw|international|no_leading_plus|sha256}",
                "fn": "{first_name:lowercase|sha256}",
                "ln": "{last_name:lowercase|sha256}",
                "db": "531764f38242ecae4d34116402255481859cf83552a545cad2b03268a4204f1a",
                "ge": "62c66a7a5dd70c3146618063c344e531e6d4b59e379808443ce962b3abd63c5a",
                "ct": "6d5809aba9e26ace73438fc81a5d012738b61a5b6fc913d5100e449e72d80ee2",
                "st": "4b650e5c4785025dee7bd65e3c5c527356717d7a1c0bfef5b4ada8ca1e9cbe17",
                "zp": "b83c588da0c6931625f42e0948054a3ade722bfd02c27816305742ed7390ac6c",
                "country": "9b202ecbc6d45c6d8901d989a918878397a3eb9d00e8f48022fc051b19d21a1d",
                "external_id": "{lead_id|sha256}"
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52",
                "content_name": "Content Name",
                "content_category": "Content Category",
                "content_ids": ["Content ID"]
            }
        }
    ],
   "test_event_code": "TEST34465"
}
应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)

#8 故障排除

关于如何解决问题的简短视频


本文标题:应对iSO14升级,获取更全广告跟踪数据必做的Facebook转化API配置教程大全(九)
转载请完整注明:
转自《跨境公海》,原文链接:https://www.kjgh.net/how-to-setup-the-facebook-conversions-api/
喜欢 (0)
[bullyy@163.com]
分享 (0)
关于作者:
米校是跨境电商数字整合营销专家,在Google广告,Facebook广告、社交营销和亚马逊运营推广上拥有超过10年的经验,擅长在独立站建站、页面优化、SEO、广告、社交媒体营销和亚马逊运营推广以及电商大数据方面帮助中小型企业扩展在线销售。
发表我的评论
取消评论
表情 贴图 加粗 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址