Facebook转换API目的地


Facebook API转换允许广告商直接向Facebook发送服务器的活动。服务器端事件链接到像素,并处理如浏览器像素事件。这意味着以与浏览器像素事件相同的方式在测量,报告和优化中使用服务器端事件。

服务器事件参数要求

2021年2月15日,Facebook开始对服务器事件参数实施新的要求。在此日期之后,发送到Conversions API的不满足新需求的事件可能无法用于优化、定位或度量。有关如何实现这些需求的详细信息,请参见服务器事件参数要求

目的地名称改变

Facebook转换API已从Facebook像素服务器端重命名。

部分支持的其他Facebook目的地

这一页是关于Facebook API转换目的地。关于其他Facebook目的地的文档,包括Facebook Pixel,请参阅下面链接的页面。

Facebook的目的地 支持的角色
Facebook应用程序事件 是的
Facebook定制的观众 是的
Facebook脱机转换 是的
Facebook的像素 没有

开始

接下来,设置像素以与Facebook Conversions API目标一起工作。你可以使用已经设置好的Facebook像素,也可以新建一个。如果您还没有配置Facebook的像素,请按照下面的“新像素”说明创建一个。

选项1 -创建一个新的像素

  1. 去做Facebook业务吧事件管理器并点击连接数据源
  2. 选择“Web”、“App”或“Offline”,单击开始
  3. 选择“Conversions API”,然后点击连接
  4. 从合作伙伴列表中选择“Segment”。
  5. 启用“授权段连接”的设置,然后单击继续

选项2 -配置一个现有的像素

  1. 去做Facebook业务吧事件管理器像素设置
  2. 向下滚动到通过合作伙伴集成建立部分并单击选择合作伙伴
  3. 从合作伙伴列表中选择“Segment”。
  4. 启用“授权段连接”的设置,然后单击继续

分段设置

  1. 从段应用程序中的目标目录页面,单击添加目的地
  2. 在目标目录中搜索“Facebook Conversions API”,并选择“Facebook Conversions API”目标。
  3. 选择哪个源应该将数据发送到“Facebook Conversions API”目的地。
  4. 去做Facebook业务吧事件管理器像素设置,查找并复制“像素ID”。
  5. 在“Facebook转换API”的目标设置中输入“像素ID”。

看到配置选项部分介绍其他实现步骤

配置选项

Facebook的转换率API为你提供了多种实现转换率跟踪的方法。你可以用它来赞美Facebook的像素,或者作为一个独立的替代品。

以下实现选项可用:

  1. 从浏览器和服务器发送相同的事件
  2. 发送不同的事件;有些来自浏览器,有些来自服务器
  3. 只从服务器发送事件

从浏览器和服务器发送相同的事件

这种方法提供了冗余,确保最大的信号可靠性。以前从浏览器发送时可能丢失(由于多种原因)的事件,现在可以使用conversions API捕获。如果您不想错过来自浏览器的任何事件,您可以使用它。

匹配率的考虑

为了这个选项可以最好地发挥作用,你必须通过它external_id来自浏览器和服务器源。为此,请转到段中的Facebook像素目的地设置,并启用使用用户Id或匿名Id作为外部Id。默认情况下,Facebook Conversions API目的地使用用户标识(或者anonymousId如果没有)设置外部Id,这样当你设置Facebook Pixel使用相同的设置,Facebook就可以匹配用户。

您还可以通过发送来提高来自服务器源的事件的匹配率track events上下文对象中的用户特征。您还可以从浏览器收集其他字段,例如userAgent,知识产权地址,Facebook参数(fbp, fbc)并将其传递给服务器,并手动将它们添加到事件中。

重复数据删除的考虑

只有发送相同的事件时,事件才会重复数据删除第一个从浏览器和然后从服务器。当按照这个顺序接收事件时,服务器事件将被丢弃。如果事件是从服务器发送的然后浏览器,他们创建了一个副本。如果发送两个具有相同信息的连续浏览器事件,则两个事件都不会被丢弃。如果连续发送两个具有相同信息的服务器事件,都不会被丢弃。

发送不同的事件——一些来自浏览器,另一些来自服务器

如果您想要将跟踪用户浏览器上完成的事件与在浏览器外完成的事件(例如基于服务器的支付系统)分离开来,则可以使用这种方法。敏感信息最好避免出现在浏览器之外,因此不希望向用户公开的任何数据都应该使用服务器源发送。你还可以设置Conversions API来衡量更深层次的客户行为。看到这些更深层次的漏斗事件意味着你可以更准确地衡量你的广告是如何帮助你实现商业目标的。

匹配率的考虑

为了使这个选项工作得最好,相同的external_id需要从浏览器和服务器传递。为了容易实现这一点,去你的细分目标设置Facebook像素和切换设置调用使用用户Id或匿名Id作为外部Id。Facebook转换API目标使用userid(或anonymousid,如果不存在)默认设置外部ID。因此,在Facebook像素上实现此功能将允许Facebook匹配用户。

您还可以通过发送来提高来自服务器源的事件的匹配率track events上下文对象中的用户特征。您还可以从浏览器收集其他字段,例如userAgent,知识产权地址,Facebook参数(fbp, fbc)并将其传递给服务器,并手动将它们添加到事件中。

重复数据删除的考虑

如果选择此选项,每个源将发送不同的事件,不需要重复数据删除。

只从服务器发送事件

如果您不想使用Facebook Pixel从浏览器跟踪用户,可以使用这种方法。默认情况下,Facebook Pixel收集cookie数据以及诸如IP地址和用户代理等浏览器数据,其中一些您可能不希望收集。通过从一个段服务器源发送到Facebook的转换API,你可以控制你传递给Facebook的标识符。

匹配率的考虑

如果您单独使用Facebook Conversions API,而不使用从浏览器收集的特定数据字段,那么匹配率可能不会像包含它们那样高。

您还可以通过发送来提高来自服务器源的事件的匹配率track events上下文对象中的用户特征。您还可以从浏览器收集其他字段,例如userAgent,知识产权地址,Facebook参数(fbp, fbc)并将其传递给服务器,并手动将它们添加到事件中。

重复数据删除的考虑

如果选择此选项,则只发送一次事件,不需要重复数据删除。

跟踪

目前,Facebook Conversions只支持追踪电话。

有关跟踪调用的更多信息,请参见跟踪方法在分段规格中。

服务器事件参数要求

从2021年2月15日开始,Facebook要求action_source发送到Conversions API的所有事件的服务器事件参数。此参数用于指定发生转换的位置。如果action_source被设置为“网站”那么client_user_agent.event_source_url.参数也是必需的。2月15日之后发送到Conversions API的不符合要求的事件可能无法用于优化、定位或测量。

服务器事件参数 要求 实现
action_source 总是要求 它是自动设置的,但也可以手动设置。
client_user_agent. 只需要如果action_source= "网站" 如果使用服务器库,则必须手动设置。如果使用段web库,它将自动设置。
event_source_url. 只需要如果action_source= "网站" 如果使用服务器库,则必须手动设置。如果使用段web库,它将自动设置。

行动的源

action_source默认值设置为“website”。如果使用移动图书馆的话action_source默认为“应用程序”。

你可以设置action_source通过将其作为跟踪事件的属性来手动传递。您可以使用snake case或camel case来包含action_source作为轨道事件中的财产。

行动源值 描述
应用程序 使用你的应用程序进行转换。
聊天 通过消息传递应用程序,短信或在线消息传递功能进行转换。
电子邮件 转换是通过电子邮件进行的。
其他 转换的方式没有列出来。
phone_call 这是通过电话进行的转换。
physical_store 我是亲自到你的实体店皈依的。
system_generated 转换是自动发生的,例如,订阅续期设置为每月自动支付。
网站 在你的网站上进行了转换。

客户端用户代理

client_user_agent.是通过包括context.userAgent在径赛项目中。所使用的值应该是发生转换事件的浏览器的用户代理。如果您正在使用服务器库,setclient_user_agent.手动。如果你正在使用网段库,client_user_agent.自动设置。

事件源URL.

event_source_url.是通过包括context.page.url在径赛项目中。所使用的值应该是发生转换事件的浏览器URL。如果您正在使用服务器库,setevent_source_url.手动。如果你正在使用网段库,event_source_url.自动设置。

实现服务器事件参数要求

如果action_source设置为“网站”时,会出现context.userAgentcontext.page.url字段是必需的。段服务器端库不收集context.userAgentcontext.page.url默认情况下。必须从客户机手动检索该数据并将其传递给服务器。

下面的代码片段提供了一个示例产品添加事件使用node . js。注意,在这个例子中action_source参数未通过将此字段传递到事件中手动设置。的action_source参数将默认为“网站”。自从action_source=“网站”client_user_agent.event_source_url.参数是必需的。因此,context.userAgentcontext.page.url字段已手动传递到事件中。

分析跟踪({上下文:{userAgent:"Mozilla / 5.0(Macintosh;英特尔Mac OS X 11_1_0)AppleWebkit / 537.36(如壁虎)Chrome / 88.0.4324.96 Safari / 537.36",页面:{url:"//www.asianminres.com/"}},用户标识:"97980 cfea0067",事件:"产品添加",属性:{品牌:"孩之宝",cart_id.:"skdjsidjsdkdj29j",类别:"游戏",优惠券:"maydeals.",image_url:"https://www.example.com/product/path.jpg.",的名字:"垄断:第3版",位置:3.,价格:18.99,product_id:"507F1F77BCF86CD799439011",数量:1,sku:"G-32",url:"https://www.example.com/product/path",变体:"200块"},});

默认映射到Facebook标准事件

下面的映射是自动的,不需要额外的设置。下表中的任何电子商务事件都将作为相应的Facebook标准事件发送。你可以在Facebook pixel上了解更多标准事件文档

部分电子商务活动 Facebook标准事件
结账开始了 InitiateCheckout
订单完成了 购买
产品添加 AddToCart
产品列表查看 ViewContent
产品已浏览 ViewContent
产品搜索 搜索

Facebook要求用户在“购买”活动时使用一种货币——如果你不使用这种货币,该网站会将其默认值设置为“美元”。

自定义映射到Facebook标准事件

将你的任何片段事件(未列在上表中)映射到Facebook上标准事件,使用标记为的段目标设置将您的活动映射到标准FB事件。然后,当Segment接收到映射中出现的事件时,该事件将作为您指定的标准事件发送到Facebook。事件中包含的所有属性都作为事件属性发送。

Facebook自定义事件

任何未映射的事件自动发送到Facebook转换为自定义事件。如果Facebook预定义的标准事件不适合您的需要,您可以跟踪自己的自定义事件,也可以使用它来定义定制的观众广告优化。自定义事件还支持参数,您可以包含用于提供有关每个自定义事件的其他信息。

自定义事件名称的长度不能超过50个字符。

到Facebook属性的默认映射

段映射以下段特征到Facebook的属性:

部分财产 像素属性 笔记
context.ip user_data.client_ip_address
context.page.url event_source_url.
context.traits.address.city user_data.ct 散列
context.traitra.address.postalcode. user_data.zp. 散列
context.traitra.address.state. user_data.st 散列
context.traits.birthday user_data.db 散列
context.traitra.email. user_data.em 散列
context.traits.firstName user_data.fn 散列
context.traits.lastName user_data.ln 散列
context.traits.phone user_data.ph 散列
context.userAgent user_data.client_user_agent
事件 event_name.
消息id event_id
properties.action_source action_source
属性.Currency. custom_data.currency 默认为USD(如果未设置)
properties.fbc 流化床燃烧器
properties.fbp 出口押汇
properties.products [x] .price custom_data.contents [x] .item_price 必须为整数
properties.products [x] .product_id custom_data.contents [x] .id 必须是字符串
properties.products [x] .quantity custom_data.contents [x] .quantity 必须为整数
properties.products. custom_data.contents 必须是一个数组。num_items.设置为这个的长度吗
properties.query custom_data.search_string.
properties.revenue custom_data.value 可定制的,看可供选择的值属性
属性.Status. custom_data.status.
时间戳 Event_time.
用户标识 external_id 来自广告客户的任何唯一ID,如会员ID、用户ID和cookie ID。看到替代外部id

访问上下文context.traits在轨道调用中的对象,您可以使用context-traits格式如下面的例子所示。

分析跟踪("点击电子邮件",{emailCampaign:首先触摸},{特征:{的名字:"John Doe"}});

自定义映射到Facebook属性

你所发送的任何属性都将通过“自定义数据”部分发送到Facebook。

替代外部id

缺省情况下,Segment发送用户标识作为,如果用户标识缺席是退步吗anonymousID。要在您的负载中使用不同的字段作为外部ID,请使用“替代外部ID字段”。此设置的示例值为properties.externalId

选择“值”的特性

对于大多数事件段,为像素值字段发送收入,但对于预购买事件“已查看的产品”和“产品添加”,段使用“值字段标识符”设置的值来确定用于“的属性”价值“字段。此字段默认为价格

有限的数据使用

2020年7月,Facebook发布了这一消息有限的数据使用特性帮助企业遵守加州消费者隐私法(CCPA)。这项功能限制了所有选择不出售数据的加州居民存储和处理用户数据的方式。您可以在每个事件上向Facebook发送有限的数据使用数据处理参数,以便Facebook可以适当地应用用户的数据选择。Segment建议您首先熟悉这个特性和Facebook接受数据处理选项

此目标支持以下参数:

  • 数据处理选项
  • 数据处理方案
  • 数据处理选项状态

属性可以启用该特性有限的数据使用目标设置和使用数据处理初始化参数控制它。

有限的数据使用目的地设置是禁用的默认为所有Facebook目的地除了Facebook像素。这必须从目标设置手动启用,如果你使用其他Facebook目的地。

数据处理目标设置

你可以改变有限的数据使用目的设置启用或禁用有限的数据使用。如果您希望将数据处理参数作为有限数据使用特性的一部分发送,则必须启用(设置为“on”)。

初始化参数

您设置的数据处理参数是Segment向Facebook发送数据时使用的数据处理选项。缺省情况下,Segment使用以下数据处理参数:

数据处理参数 默认值 它意味着什么
数据处理选项 [" LDU "] 使用Facebook有限的数据使用处理
数据处理方案 0 使用Facebook的地理位置来确定国家
数据处理选项状态 0 使用Facebook的地理位置来确定状态

Facebook使用context.ip以确定事件上是否存在地理位置。

您可以通过向该设置添加设置来手动更改数据处理参数集成对象。下面的示例显示如何在Node中设置自定义数据处理参数。

// node.js库示例分析跟踪({事件:会员升级,用户标识:97234974,集成:{"Facebook转换":{"dataProcessingOptions":[[],1,1000]}}})

在Facebook上验证事件

开始发送事件后,您应该在二十分钟内开始看到它们。您可以确认Facebook收到它们:

  1. 转到事件管理器。
  2. 点击相应的像素。
  3. 概述选项卡,查找“连接模式”所在的事件服务器

笔记:事件显示在活动管理器中可能需要几分钟时间。

此页面上次修改:2021年2月17日



从分段开始

细分是将网站和移动应用数据整合到300多个分析和增长工具的最简单方法。
创建免费帐户