appsflyer目的地


AppsFlyer是全球领先的移动归类和营销分析平台,帮助世界各地的应用营销人员做出更好的决策。我们的AppsFlyer目标代码是开源的。你可以在GitHub上浏览代码iOS安卓

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

开始

在你开始之前,确保AppsFlyer支持你选择实现的源类型和连接模式。你可以了解更多联系方式在这里

网络 移动的 服务器
设备模式
☁️云模式
  1. 从网段应用程序,单击目录
  2. 在目录中搜索“AppsFlyer”,选择它,并选择将目标连接到哪个源。
  3. 在目标设置中,输入您的AppsFlyer Dev关键,可以从AppsFlyer帐户的App Settings部分获取。
  4. 遵循GitHub repos中的说明:iOS SDKAndroid SDK
  5. 在您构建和发布到App Store后,我们开始自动翻译和将数据发送到AppSflyer。

重要的:如果您计划为一个Android项目使用服务器端目的地,请确保输入您的Android应用程序ID。如果你只使用移动SDK, Android项目只需要AppsFlyer Dev关键。iOS项目总是需要这两个AppsFlyer Dev关键苹果应用程序ID。另外,请注意,如果您使用服务器端目的地,您将无法使用段仪表板选择性地禁用发送到AppsFlyer的调用。

额外的设备模式设置为iOS 14支持

段更新了appsflyer ios sdk使用版本6.0 beta.准备跟踪IOS 14的更改。SDK Beta版本与Apple发布的IOS 14的Beta版本兼容,并支持AppsFlyer的汇总归因和AppleAppTrackingTransparency框架,等等。看到AppsFlyer博客文章关于AppSflyer的新隐私归属模型。

要使用最新的AppsFlyer SDK收集IDFAs,请执行以下步骤:

  1. 升级以使用Xcode12。
  2. 更新你的段AppsFlyer SDK到版本6.0.2或更高。
  3. 导入并实现AppTrackingTransparency (ATT)框架。
    • 导航到您的项目info.plist.并添加“隐私跟踪使用描述”。当iOS 14中应用程序初始化时,这个描述会出现在一个弹出窗口中。用户会被提示是否允许跟踪。
  4. 在您的appdelegate.m.上的文件didfinishlaunchingwithoptions.允许Appsflyer收集IDFA。

    //以下块用于希望收集IDFA的应用程序。// for iOS 14及更高版本 - 将提示用户收集IDFA的权限。//如果授予权限,IDFA将由SDK收集。//对于iOS 13及更早版本 -  IDFA将由SDK收集。将不会提示用户进行许可。如果#available(ios 14,*){//设置SDK在处理应用程序启动前等待IDFA收集的超时时间AppsFlyerLib共享()waitForAdvertisingIdentifier(withtimeoutinterval.:60.)//显示Apple IDFA同意对话框(AppTrackingTransparency)//可以在任何地方调用ATTrackingManagerRequestTrackingAuthorization.{(地位)}}
  5. 遵循分部收集IDFA指南

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

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

如果你有可以省略appsflyerid.设置启用,但没有发送一个IDFA(要么因为你没有传递一个,或者用户拒绝收集它的权限),AppsFlyer拒绝事件。

要防止这种情况发生,您可以启用新的当advertisingId密钥不存在时,回退发送IDFV设置在AppSflyer目标设置中。使用此启用,当您使用云模式发送数据(通过段服务器),段发送用户的IDFV(device.id)当device.advertisingId是缺失或空白,并且“可以省略AppsFlyerID”是启用的。

额外的React本机设备模式设置

将AppSflyer设备模式SDK添加到a原生项目:

  1. 导航到项目的根文件夹,并运行a纱添加appsflyer命令将目标SDK添加到项目中。
  2. 添加一个进口声明,如下面的示例所示。
    进口AppsFlyer@segment / analytics-react-native-appsflyer
  3. 在同一项目文件中,将目的地添加到使用清单在等待命令。
    等待分析设置(YOUR_WRITE_KEY,{//添加任何设备模式目标。这可以确保在继续之前加载它们。使用:AppsFlyer// ......})
  4. 最后,更改为您的iOS开发文件夹(cd ios)和运行POD安装

服务器

AppsFlyer提供了一个扩大的服务器端HTTP API旨在沿AppSflyer移动SDK使用。使用云模式目的地移动SDK将使用归属用户和设备链接应用外部事件(例如网站或脱机购买)。

重要的:云模式目标不是替换设备模式目的地,并且您不应自动使用云模式目的地。AppSflyer要求您捆绑移动SDK以正确地属性用户操作。请记住,如果你通过appsFlyerId在云模式呼叫中,你不能阻止事件从Segment app发送到AppsFlyer。

如果您只想使用AppSflyer服务器端,请联系AppsFlyer代表,因为这是企业客户功能。

识别

如果你对细分市场的规格不熟悉,可以看一看识别方法做。一个例子看起来像:

[[塞纳利斯sharedAnalytics]识别:@“12091906 - 12091906”特征:@{@“电子邮件”:@“john.doe@example.com”});

当你打电话。确认(),我们将使用appsflyer的setCustomerUserID发送用户标识这是通过的。

注意:识别目前不支持使用AppsFlyer的HTTP API调用。您只能发送。确认如果你捆绑了AppsFlyer SDK,就调用它。

追踪

如果你对细分市场的规格不熟悉,可以看一看跟踪方法做。一个例子看起来像:

[[塞纳利斯sharedAnalytics]追踪:@“文章竣工”特性:@{@“标题”:@“如何创建跟踪计划”,@“课程”:@“介绍分析”});

当你打电话追踪, Segment自动翻译它,并将事件发送给AppsFlyer。

我们将所有事件属性作为回调参数包含在AppsFlyer事件中,并自动转换properties.revenue.到适当的AppsFlyer购买事件属性基于我们指定的属性。

最后,我们自动使用appsflyerTransmactionID.发送一个时重复数据删除orderid.(见电子商务规范)。

服务器

如果希望将脱机事件与某个用户或设备关联,则可以使用服务器端目的地。

AppsFlyer需要以下属性进行此属性:

appsflyer设备ID

发送appsflyer设备ID每一项活动集成.aptations.appsflyer.appsflyerid.,参见下面的示例。这个标识符对每个设备都是唯一的,并且可以是使用appsflyer sdk检索。将这个值存储在外部数据库中是一个好主意,服务器或网站环境可以很容易地访问它。

设备类型

AppsFlyer要求用户的设备类型为“苹果”或者'安卓'通过在context.device.type对象,请参见下面的示例。

广告ID

AppsFlyer需要通过一个广告ID(称为idfa.在ios和广告ID在Android)在context.device.advertisingId,见下面的例子:

// node.js库示例分析追踪({事件:会员升级,用户标识:97234974,语境:{设备:{类型:ios,advertisingid.:159358.}},一体化:{AppsFlyer:{appsFlyerId:1415211453000 - 6513894}}});

检查你的具体服务端库文档有关如何正确格式化方法的具体细节。

最后,Serverside组件将寻找以下内容特性并特别处理它们:

  • IP.(这应该是IP.这并不是由Segment的图书馆收集的)
  • 时间戳(请参阅appsflyer的文档它们如何处理时间戳。由于我们的图书馆生成了一个时间戳,我们将始终设置此值)
  • 货币(默认为“美元”)
  • 收入(订单完成了事件,优先考虑全部的,回来了properties.revenue.)

所有其他的特性将被发送到AppsFlyer作为自定义属性内部eventValue

注意:请确保在AppsFlyer的仪表板中校准/更新时间窗口以查看您的事件!

安装由

客户

段将自动触发安装由事件,如果有trackAttributionData在你的设置中启用,并在你的应用程序中安装Segment-AppsFlyer集成。事件有效载荷将坚持我们的安装由事件规范文档这里并传播到其他下游目的地。

服务器

如果你是在服务器端跟踪事件,AppsFlyer仍然可以发送归因回发,但你需要在你的AppsFlyer帐户中配置此功能。要启用这一点,导航到你的AppsFlyer应用程序,并在主屏幕的侧边栏上单击综合合作伙伴搜索细分市场。系统将提示您几个配置选项,并要求您输入段写入键。一旦启用,成功的应用安装将开始显示为安装由类似于上面记录的客户端行为的事件。

如果你自己发送属性数据,对于iOS,请确保以下属性是在campaign对象中发送的安装由或者申请已打开事件SO Appsflyer可以将其正确归因于Apple Search AD事件。应由这些值返回苹果搜索广告API:

“活动”:{“内容”:“keyword1keyword2”、“ad_creative”:“OrgName”、“conversion_date”:“2018 - 03 - 07年t04:05:50z”、“ad_group”:“US-iOS-campaign-Exact”、“id”:“123”,“ad_group_id”:“456”,“名字”:“US-iOS-campaign”,“click_date”:“2018 - 03 - 06 t04:05:50z”、“lineitem_id”:“789”,“归因”:“真正的”、“lineitem_name”:“US-iOS-campaign-Name”}

例如,来自归因伙伴的归因事件是这样的:

[[塞纳利斯sharedAnalytics]追踪:@“安装归属”,特性:@ {@“提供者”:@“appsflyer / tune / kochava / branch”,@“活动”:@ {@“来源”:@“网络/ FB / AdWords MoPub /源”,@“名称”:@“活动名称”,@“内容”:@“有机内容标题”,@“ad_creative”:@“红色Hello World广告”,@“ad_group”:@“红色的”,@“conversion_date”:@“2018 - 03 - 07 - t04:05:50z”,@“id”:@“123”,@“ad_group_id”:@“456”,@“click_date”:@“2018 - 03 - 06 - t04:05:50z”,@“lineitem_id”:@“789”,@“归因”:@“true”,@“lineitem_name”:@“US-iOS-campaign-Name”}});

其他特性

收入的跟踪

目的地自动识别规格收入并将其转化为AppsFlyer的收入跟踪方法。

事务重复数据删除

目的地自动识别规格orderid.属性,并将其作为事务ID发送给AppsFlyer,以便消除收入重复。

内购发票

目的目前不支持应用内购买收据。如果这对您很重要,请发送电子邮件@ appsflyer.com。

deeblinking.

目的地不会自动支持开箱即用的Deeplinking(无论如何您需要在此编写代码!)。

因此,你可以使用AppsFlyer的OneLink集成,这是一个单一的、智能的跟踪链接,可以用于跟踪Android和iOS。OneLink跟踪链接可以在你的应用安装完成后启动,而不是将用户重定向到应用商店。

有关更多细节,请参阅AppsFlyer OneLink设置指南。更多信息可在AppsFlyer SDK集成指南(iOS,安卓)和Segment的移动常见问题(iOS,安卓)。

角色

您可以发送使用的计算特征和受众使用细分人格到达这个目的地用户属性。要了解更多关于人物角色的信息,请联系我们演示

对于用户属性目的地,一个识别调用被发送到目的地,针对正在添加和删除的每个用户。属性名称是受众名称的Snake_cased版本,具有真正/假值以指示成员资格。例如,当用户首先在过去30天内完成订单时,PersonAs会向属性发送标识呼叫order_completed_last_30days:真。当用户不再满足这种情况时(例如,自上次订单以来已经超过30天),Personas将该值设置为错误的

当您第一次创建受众时,Personas为受众中的每个用户发送一个识别呼叫。之后的用户同步只会向自上次同步后成员发生变化的用户发送更新。

设置

段允许您从段应用程序更改这些目标设置,而无需触摸任何代码。

Android应用程序ID

你的Android应用程序的ID。在你的AppsFlyer ' s ' My App ' dashboard中找到这个。它应该看起来像com。appsflyer。myapp。这对于Android项目是必需的,如果你想发送事件使用服务器端集成。

Apple App ID(iOS)

你的应用ID,可以从iTunes或AppsFlyer ' s ' My App ' dashboard中访问。这对于Android项目是可选的,仅对于iOS项目是必需的。

AppsFlyer Dev关键

你在AppsFlyer中唯一的开发者ID,可以通过你的AppsFlyer帐户访问。

可以省略appsflyerid.

仅适用于AppSflyer的业务层客户使用服务器端或云模式目的地。manbetx客户端应用下载请联系您的AppsFlyer代表以获取更多信息。此设置允许使用广告ID作为AppSflyer ID。

启用HTTP回退(Android)

如果选中,HTTPS调用将回退到HTTP上

当advertisingId键不存在时,回退发送IDFV(仅服务器端)

随着更新使用analytics-ios v4。x SDK如果adTrackingEnabled设置为false,那么advertisingId key将从事件中删除。如果你启用了“可以省略AppsFlyerId”的设置,这些事件将会在发送到AppsFlyer API时失败。要在此场景中防止这些事件失败,请启用此发送IDFV。当“Can Omit AppsFlyerId”设置启用时,如果IDFA被置零,我们也将发送一个IDFV时,该设置启用。

Roku App ID

重要的:为了发送Roku数据,你必须请联系您的Appsflyer代表,因为这种类型的数据流需要完整的服务器到可用的服务器集成,但被门控作为AppsFlyer企业客户功能。如果没有Appsflyer的同意,我们无法转发您的Roku数据。您的Roku应用程序的ID。在你的AppsFlyer ' s ' My App ' dashboard中找到这个。如果您想使用服务器侧集成发送事件,则这是Roku项目所必需的。

跟踪归因数据

将归类数据作为追踪调用发送给Segment和其他工具(仅限移动库)。

最后更改:2021年3月23日



开始使用细分

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