Facebook应用事件目的地


Facebook应用程序事件从段的移动SDK中收集所需信息(iOS安卓)并将其从Segment的服务器发送到Facebook应用程序事件服务器。这服务器到服务器连接不适用于我们的服务器端库。Facebook应用程序目标是开源。您可以浏览GitHub上的代码iOS

本文件最后更新于2018年10月4日。如果您注意到任何漏洞、过时的信息或只是想留下一些反馈来帮助我们改进文档,让我们知道!!

Segment支持的其他Facebook目的地

这一页是关于Facebook应用程序事件.对于其他Facebook目的地的文档,请参阅下面链接的页面。

Facebook目的地 由人格来支持
Facebook应用程序事件 是的
Facebook脱机转换 是的
Facebook Pixel.
Facebook自定义受众 是的
Facebook自定义受众网站 是的

入门

在开始之前,请确保Facebook App Events支持您选择实现的源类型和连接模式。您可以了解更多信息联系方式在这里

网络 移动 服务器
Device-mode
☁️云模式
  1. 在“片段”网页应用中,点击目录
  2. 搜索目录中的“Facebook应用程序事件”,选择它,并选择将目的地连接到的哪些源。
  3. 在目标设置中,输入您的Facebook应用程序ID,可以从您的中检索Facebook应用程序仪表板
  4. 一旦你在你的应用程序的片段项目中打开Facebook应用程序事件集成,我们将开始发送跟踪Facebook App Events端点的数据。

使用React原生设备模式的Facebook应用事件

Facebook App Events设备模式目标SDK仅适用于React Native。

将Facebook App Events Device-Mode SDK添加到a原生项目:

  1. 导航到项目的根文件夹,并运行纱添加facebook-app-events-ios命令将目标SDK添加到项目中。
  2. 添加一个进口对您的项目进行陈述,如下面的例子。
    进口FacebookAppEvents'@段/分析 - 反应原始伪造 -  iOS'
  3. 在同一项目文件中,将目的地添加到使用列表中等待命令。
    等待分析设置'your_write_key.'{//添加任何设备模式的目标。这确保在继续之前加载它们。使用FacebookAppEvents// ......})
  4. 最后,切换到你的iOS开发文件夹(CD iO.)和跑步圆荚体安装

屏幕

如果你不熟悉的部分规格,看看了解什么屏幕的方法所做的事。调用的示例如下:

[[SEGAnalyticsSharedAnalytics.]屏幕@“照片饲料”特性:@ {@“饲料类型”@“上市”}];

我们的集成也支持使用细分屏幕事件为跟踪事件。例如,如果你有屏幕事件命名确认你可以把这个调用映射到一个Facebook应用程序事件,就像你在Segment上一样跟踪事件。

要使用此功能,您必须使用命名的集成设置选择它使用屏幕事件作为跟踪事件.启用后,您应该开始查看屏幕事件在Facebook App events中很常见。您提供的屏幕名称将以这些单词为尾标浏览屏幕.所以,如果你有一个屏幕名称属性设置为的事件欢迎,它将在Facebook中显示为一个叫做的活动查看欢迎屏幕

注意,集成不会自动转换屏幕事件指定Facebook活动是我们的跟踪方法。如果您想将这些事件映射到特定的Facebook事件,您可以使用将你的事件映射到标准FB应用事件环境。请务必指定事件浏览名称屏幕在哪里名称是这个名字属性屏幕事件。

跟踪

如果你不熟悉的部分规格,看看了解什么跟踪方法所做的事。调用的示例如下:

[[SEGAnalyticsSharedAnalytics.]跟踪@“文章竣工”特性:@ {@“标题”@“如何创建跟踪计划”@“课程”@“介绍分析”}];

你打电话的时候跟踪Segment自动发送事件和它的属性到Facebook。在Facebook分析界面中,你可以使用事件属性来分割你的数据。

Facebook App Events不喜欢名字中有句点的事件如果你给我们一个名字中有句点的事件,我们会把所有句点转换为下划线。所以如果你的活动是朋友.Added.,我们将发送到Facebookfriend_added.由于Facebook的API约束,我们还截断了长度超过40个字符的事件。

Facebook的参数

我们自动翻译我们的规范会属性收入货币到适当的Facebook参数(valueToSumFBSDKAppEventParameterNameCurrency),也向Facebook的购买记录方法发送收入的活动(logPurchase).

如果你没有提供货币明确地,我们发送美元.如果任何属性与下面不匹配,我们将在发送给我们时传递它们。

收入 _Valuetosum.
货币 fb_currency.
名称 fb_description
product_id. fb_content_id.
类别 fb_content_type
询问 fb_search_string.
时间戳 _logTime
数量 fb_num_items.

Facebook活动

段会自动翻译与我们其中一个匹配的任何事件规格的事件映射到Facebook的指定事件。下表显示了集成中的开箱即用映射:

安装应用程序 mobile_app_install.
应用程序打开 fb_mobile_activate_app
搜索产品 fb_mobile_search
产品被 fb_mobile_content_view
加产品 fb_mobile_add_to_cart.
产品添加到愿望清单 fb_mobile_add_to_wishlist
付款信息输入 fb_mobile_add_payment_info.
付款开始 fb_mobile_initiated_checkout
订单完成 fb_mobile_purchase.

如果你发送一个跟踪事件与上述事件之一不匹配,我们将通过您提供段的名称发送到Facebook。

Facebook推荐的活动

能够帮助广告商提高广告ROI的最重要事件是转换事件或最接近转换的事件。这些事件标记为“*”在Segame的Facebook应用程序事件设置页面中。

此外,有动态广告的特殊要求。这些事件标有用于移动动态广告的“M”,以及“T”的动态广告,用于在段的Facebook应用程序事件设置页面中的旅行中的动态广告。

有限的数据使用

2020年7月,脸书发布有限的数据使用功能为了帮助企业遵守加州消费者隐私法案(CCPA)。此功能限制了用户数据存储和处理的所有加利福尼亚居民,该居民选择退出其数据。您可以在每个事件中向Facebook发送有限的数据将数据处理参数发送到Facebook,以便Facebook可以适当地应用用户的数据选择。细分建议您首先熟悉此功能和此功能Facebook接受数据处理选项

该目的地支持以下参数:

  • 数据处理选项
  • 数据处理选项国家/地区
  • 数据处理选项状态

您可以使用该功能使用使用有限的数据使用目标设置和控制它使用数据处理初始化参数。

使用有限的数据使用除Facebook像素外,所有Facebook目的地默认禁用目标设置。如果您使用其他Facebook目的地,则必须从目标设置中手动启用此功能。

数据处理目标设置

你可以改变使用有限的数据使用目标设置启用或禁用“有限数据使用”。如果你想发送数据处理参数作为有限数据使用功能的一部分,必须启用(设置为“on”)。

数据处理初始化参数

您设置的数据处理参数是数据处理选项段在向Facebook发送数据时使用。默认情况下,段使用以下数据处理参数:

数据处理参数 默认值 这是什么意思
数据处理选项 [“LDU”] 使用Facebook的有限数据使用处理
数据处理选项国家/地区 0. 使用Facebook的地理位置来确定国家
数据处理选项状态 0. 使用Facebook的地理位置来确定状态

Facebook使用了context.ip.确定事件的地理位置。

属性中添加设置,可以手动更改数据处理参数集成目的。

服务器端库

下面的示例显示了如何为段服务器库设置自定义数据处理参数。

//节点库示例分析跟踪({事件'会员升级'用户身份'97234974'集成{Facebook应用程序事件{dataProcessingOptions[[],11000]}}})

iOS设备模式

你必须使用Facebook App Events集成SDK版本2.0.0或者以后打电话setDataprocessingOptions.当你启用使用有限的数据使用目的地设置。从早期版本的Facebook App Events集成SDK发送的活动无法调用setDataprocessingOptions.,但Facebook仍然可以访问事件中的IP地址,以根据地理位置处理LDU。

当您使用段的移动库时,必须在应用程序委托实例中声明目标时设置数据处理选项。下面的示例显示了如何在IOS项目中设置自定义数据处理参数。

//添加Bundle FB Integration SDK//设置数据处理值。segfacebookappeventsItegrationFactory.*神奇动物=[segfacebookappeventsItegrationFactory.实例];[神奇动物setDataprocessingOptions.:@ [@“LDU”]福克斯特里1福特1000];[配置使用神奇动物];

Android和iOS云模式

要在iOS或Android上发送数据处理参数,可以在Integration对象中设置它们。下面的示例显示了如何在Android中设置自定义数据处理参数。

对象[]dataProcessingOptions=新的对象[3.]dataProcessingOptions[0.]={'LDU'}/ /选项dataprocessoptions.[1]=1/ /国家dataProcessingOptions[2]=1000/ /状态分析上下文).跟踪“采购项目”新的特性(),新的选项().setIntegrationOptions.“Facebook应用程序事件”新的ImmutableMap.建造者<细绳对象>()。“dateProcessingOptions”dataProcessingOptions).构建());

额外的iOS云模式设置为iOS 14

随着Segment最新的Analytics-iOS SDK的发布,其中包括对即将到来的iOS 14跟踪变化的支持,你必须决定你是否需要收集用户的IDFA。如果您不需要收集IDFA,您可以将Analytics-iOS SDK更新到下一个版本和段集device.adtrackingEnabled.,并开始删除device.advertisingId从有效负载中的上下文对象。如果你需要收集IDFA,您必须将IDFA Closure作为配置到库,或导入来自Apple的广告跟踪透明度框架。

如果没有必要的参数,Facebook返回一个4xx错误device.advertisingId键不会出现在有效载荷中。要解决这个问题,请启用当advertisingId键不存在时,返回到零IDFA当您启用此设置时,分段检查device.advertisingId键,如果没有存在,则设置广告商_ID.出站有效负载中“00000000-0000-0000-0000-000000000000”

其他特性

Facebook登录和Facebook对话框

整合不会自动支持框中的Facebook登录和Facebook对话框(无论如何都需要在此编写代码!)。要使用这些功能,您需要设置Facebook的应用委托钩子通过访问直接使用Facebook SDK

打包集成

除了可用于iOS和Android的集成之外,iOS上还有一个客户端打包集成。我们建议使用Segment服务器到服务器的集成,但如果你愿意,你也可以在iOS上使用打包集成。

预定义的事件和参数

整合目前只支持FBSDKAppEventNameActivatedApp预定义的事件(通过ActivateApp.处理程序)。所有其他事件转发为自定义事件.如果其他预定义事件对你来说很重要联系我们

故障排除

没有看到事件?

你必须确保idfa.工作在你的应用程序中,这涉及到添加IAD框架

类似地,在Android上,你需要包含Play Services Ads库这里提到为了让advertisingId填充。

一旦添加了这些,您将开始查看context.device.AdvertIsingid.填充和context.device.adtrackingEnabled.标志设置为真正的除非用户有AD跟踪限制或正在使用移动AD拦截器。

请注意:当网络被弃用,相关的iOS框架不是。

失踪的自定义事件

Facebook只接受具有字母数字名称的自定义事件(您可以在长度为2到40个字符之间的空格,“ - ”和“_”)。否则,Facebook将拒绝具有400个状态的事件有效载荷。

角色

您可以发送使用生成的计算特征和受众细分人格作为一名用户属性.要了解更多关于人物角色的信息,请联系我们演示

对于用户属性目的地,使用确认对于添加和删除的每个用户,呼叫被发送到目的地。属性名是受众名的蛇大小写版本,用true/false值表示成员关系。例如,当用户在最近30天内首次完成订单时,Personas会发送一个带有属性的Identify调用ORDER_COMPLETED_LAST_30DAYS:TRUE.当用户不再满足这个条件时(例如,从他们的上一个订单到现在已经超过30天了),Personas将该值设置为

当您第一次创建受众时,PersonAs为观众中的每个用户发送标识呼叫。后来的受众同步只为其成员身份自上次同步以来的成员身份更改的用户发送更新。

设置

分段允许您更改这些目标设置从分段应用程序,而不必接触任何代码。

应用ID.

您的Facebook应用程序ID可以从您的中检索Facebook应用程序仪表板

事件参数Allowlist

Facebook应用程序事件将事件参数的数量限制为25.您可以选择放置我们将发送到Facebook的属性的AlletList。此允许列表将被完全尊重(或根本没有,如果您选择不使用它),唯一的例外是我们将自动发送_eventName确保所有事件都是有效的。顶层属性将被精确地映射。(例如,如果你允许列表someProp然后我们会发送someProp的值)。除此之外,我们还会针对facebook指定的活动进行以下转换。控件上的值右手如果您希望在我们计算它们时发送这些属性。

收入:_Valuetosum价格:_Valuetosum货币:fb_content_id product_id:fb_content_id product_id:fb_content_id类别:fb_content_id类别:fb_content_id类别:fb_content_dype您的应用程序的版本:_appversion事件的时间戳:_logTime查询:fb_search_string数量:fb_num_items产品中的项目数:fb_num_items产品中的ID列表:fb_content_id

返回到归零IDFA,当广告资源不存在时(仅限服务器端)

如果使用Analytics-iOS V4.x SDK,如果AdtrackingEnabled设置为False,则将从事件中删除“广告”密钥。发送到Facebook应用程序API时,这些事件将失败。为了防止这些方案中的这些事件失败使得此设置可默认以将IDFA设置为零(即,即'00000000-0000000000')发送到Facebook应用程序事件时。

有限的数据使用

有限的数据使用(LDU)设置控制是否在Facebook的数据处理选项中设置了有限的数据使用模式。启用LDU时,段将发送默认用户地理选项以请求Facebook Geolocce事件。要覆盖默认地理选项,请设置值Facebook应用程序事件集成对象下面dataProcessingOptions关键。

将你的事件映射到标准FB应用事件

在左边输入您的事件,在右边输入要映射到的Facebook标准事件。Facebook承认某些标准事件可以跨定制受众、定制转换、转换跟踪和转换优化使用。当您将一个事件映射到一个标准的Facebook事件时,我们将按该名称发送事件。任何未映射的事件仍将作为自定义事件发送。

Facebook推荐的活动

能够帮助广告商提高广告ROI的最重要事件是转换事件或最接近转换的事件。这些事件用*标记。

此外,有动态广告的特殊要求。这些事件标有用于移动动态广告的动态广告的“M”,以及用于行驶动态广告的“T”。

使用屏幕事件作为跟踪事件

此设置允许您跟踪段屏幕事件,尽管它们是跟踪事件。如果启用,我们将从此源路由屏幕事件到格式化的Facebook应用程序事件名称屏幕(名称屏幕上的名字你指定)。

最后更改:2021年3月23日



开始分段

段是将网站和移动应用程序数据集成到超过300个分析和增长工具的最简单方法。
创建免费帐户