一 什么是 App渠道追踪

如果您的 App 在某个平台投放了广告，您想知道每天安装 App 的用户是通过哪个广告平台引入的，就可以使用神策的 App 渠道追踪功能，采集用户的渠道信息，存放在 AppInstall 事件（即 App 激活事件）中，以及用户属性 「广告系列来源」等广告属性中。
采集这些渠道信息之后，就可以分析不同渠道下的新增用户，次日留存，订单数量等相关指标。
对于精准渠道来讲，客户不仅想知道回传的激活，还想知道该渠道来的用户后续的注册、下单、购买等指标，此时需要客户在精准渠道配置回传事件，配置后可以通过事件属性带上的「广告系列来源」等广告属性去分析不同渠道的行为的指标情况。

二 App渠道追踪的分类和追踪原理

App 渠道追踪的方式有三种：模糊渠道追踪，精准渠道追踪，以及渠道包渠道追踪。

|

| 1.媒体平台用户点击神策链接触发「渠道监测链接$AppChannelMatching」，渠道相关信息存入缓存
2.「APP激活$AppInstall」上报，匹配点击缓存
3、精准匹配失败，采用模糊匹配兜底 | 用户激活 App 时，直接获取用户安装包内填写的渠道信息，不同渠道需要使用不同的渠道包 | 1.媒体平台用户点击神策链接触发「渠道监测链接$AppChannelMatching」，渠道相关信息存入缓存
2.「APP激活$AppInstall」上报，匹配点击缓存
3、精准匹配失败，采用模糊匹配兜底 | | 归因逻辑 | 查找两个事件 $matching_key_list 字段记录的IP、UA 是否相同。
-匹配优先级
ip+UA > ip （使用 ip 匹配时，需要点击和激活均没有采集到$os_version ）

-匹配成功：
激活事件带上utm_xxx 参数
用户属性会写一次utm_xxx参数

| 查找两个事件中 $matching_key_list 字段记录的设备id是否一致。
-匹配优先级
ios：idfa > caid > ip+ua
andriod：oaid>imei>andriod id>ip+ua
-匹配成功：
激活事件带上utm_xxx 参数
用户属性会写一次utm_xxx参数 | -匹配成功：
激活事件带上 downloadChannel 参数
用户属性会写一次downloadChannel参数（后续不在更新） | 查找两个事件中 $matching_key_list 字段记录的设备id是否一致。
-匹配优先级
ios：idfa > caid > ip+ua > ip_unknow
andriod：oaid>imei>andriod id>ip+ua
当设备 id 匹配失败后走模糊匹配，此时会过滤掉设备ID不一致的模糊匹配（os 8+，andriod id 除外），此类数据不予匹配。
-匹配成功：
全量事件挂上 channel_utm_xxx 属性
用户属性会挂上first_channel_xxx属性及first_channel_utm_xxx，后续不会更新用户属性（渠道后端） | | 使用场景 | 所有 App 的广告投放，微信推广，短息推广，App 内的推广等 | App 内的推广，神策仅支持部分 App 内推广的精准匹配，比如今日头条，广点通，百度信息流等 | 不同渠道使用不同的渠道包，将渠道信息标记在渠道包内即可 | App 内的推广，神策仅支持部分 App 内推广的精准匹配，比如今日头条，广点通，百度信息流等 | | 优点 | 支持所有 App 广告投放 | 精准，每个手机的 IMEI、oaid（Android）/IDFA（iOS） 都是唯一的 | 精准 | 精准，每个手机的 IMEI、oaid（Android）/IDFA（iOS） 都是唯一的 | | 缺点 | 不准确，有可能用户 A 激活 App 时，IP，UA，Date 与用户 B 点击的广告信息匹配成功 | 仅支持部分 App 内推广 | 每个渠道都要单独打一个包；
每次发版本都需要重新打包。 | 仅支持部分 App 内推广 |

2.1 App 模糊和精准渠道追踪原理

如图 1 、图 2 所示，为 App 模糊和精准渠道追踪的实现原理。
（1）在第三方渠道平台使用神策链接生成工具生成的 App 通用渠道追踪链接（模糊匹配）或者 App 精准渠道链接（精准匹配）。
（2）当用户点击链接之后会跳转到 App 下载页，并且神策系统中会记录该用户点击链接时的 IP、Date、User Agent （模糊匹配）或者 IDFA/IMEI（精准匹配）值，同时也会记录链接中提填写的广告信息（即 utm_source 等广告属性值）。
（3）当用户通过该链接进入下载页面并下载安装 App，第一次启动 App 时，App 端通过调用 trackInstallation （需要您们的App开发人员，在初始化 SDK 代码之后，开启全埋点代码之前，调用 trackInstallation 接口），采集 事件，并在该事件中记录手机的 IP、Date、User Agent ，IMEI/IDFA，传给神策服务器进行匹配。
（4）神策服务器将 App 端接收到的信息与之前点击广告时保存的信息进行匹配，如果匹配成功，则把对应的渠道信息（ utm_source 等 属性）自动加入 AppInstall 事件中（即 trackInstallation 接口中填写的事件），同时也会通过 profileSetOnce 把渠道信息设置到用户属性「广告系列来源」中（多次匹配成功的话，用户属性仅记录第一次有值的渠道值）。

三 渠道追踪投放步骤

第一步：需要您们开发人员在您们的 App 中 ，调用 trackInstallation 接口 ，采集 AppInstall 事件（即 App 激活事件）。
iOS 调用接口文档：https://www.sensorsdata.cn/manual/App_channel_tracking.html#12-ios-App-%E8%B0%83%E7%94%A8-trackinstallation
Android 调用接口文档：https://www.sensorsdata.cn/manual/App_channel_tracking.html#3-App-%E5%86%85%E6%8E%A8%E5%B9%BF
注：（1）如果使用精准匹配，iOS 端需要开启获取 IDFA 权限。
（2）不可以直接在 trackInsatllation 接口中给 utm_soure 等 utm 属性赋值。
（3）可把渠道包信息，直接设置为 AppInstall 事件的事件属性，比如渠道属性 downloadChannel ：huawei。
第二步：如需要使用深度回传事件，需要上报渠道回传属性。（如果不需要，请跳过该步骤）
客户端事件调用接口文档： https://manual.sensorsdata.cn/sa/latest/tech_sdk_client_android_super-7538650.html#id-.SDKAPI(Android)v1.13-追踪并进行渠道匹配和回传v1.13-追踪并进行渠道匹配和回传)
服务端事件上报方法文档： https://manual.sensorsdata.cn/sa/latest/channel_track_common_problem-22254799.html#id-.渠道追踪常见问题v2.2-后端埋点的深度回传事件配置
注：（1）深度回传两个属性，$is_channel_callback_event 属性值根据业务需求判定，回传为ture，不回传为false 、$channel_device_info 属性值为非空 string 类型任意值，该属性不入库。
（2）客户想要回传事件都需要加上，全部事件添加并不会有影响。
第三步：使用神策提供的创建渠道链接功能 ，将渠道信息填写在渠道链接中。
（1）模糊渠道追踪：使用 App 通用渠道链接生成工具 （见下图）。

（2）精准渠道追踪：

第三步：联调测试：
精准渠道链接 ，需要将生成的渠道链接投放到第三方平台，进行联调测试。
模糊渠道链接：直接用手机在本地点击链接测试即可。
联调测试的步骤如下：
（1）首先找一个测试手机先点击这个渠道链接
注意⚠️ 2.2.13 版本以下 iOS SDK 必须是从未安装过此 App 的手机，如果是卸载重装的 App 的手机，再次启动 App 时不会再触发 AppInstall 事件，也就无法匹配。
（2）然后使用该手机下载 安装App
尽量保证点击广告 和 安装 App 时，手机的 IP 是不变的。
（3）在神策分析页面，通过如下查询查看匹配效果

第四步：联调测试成功之后，将渠道链接正式投放出去。
如果联调失败，没有找到该广告来源的 App 激活事件，请按第四节的步骤排查原因。

四 如何在神策系统中查看渠道追踪的相关指标

仅 AppInstall 事件（即 App 激活事件）的事件属性 以及用户属性中。如果要分析其它事件的渠道指标，请使用「用户属性」分析。

4.1 查看指定渠道的激活用户数

4.2 查看不同渠道的回传事件用户数

4.3 查看不同渠道，从激活到注册成功的转化人数