一、 渠道追踪的原理

如下图所示,为 APP 精准渠道追踪的实现原理。

(1)在第三方渠道平台使用神策的 APP 精准渠道监测链接。

(2)当用户点击广告商的广告链接之后会跳转到 App 下载页,并且神策服务器会记录该用户点击链接时的 IDFA/IMEI(精准匹配)值,同时也会记录链接中填写的广告信息(即 utm_source 等属性值)。

(3)当用户通过该链接进入下载页面并下载安装 App,第一次启动 App 时,App 端通过调用 trackInstallation (需要您们的 App 开发人员,在初始化 SDK 代码之后,开启全埋点代码之前,调用 trackInstallation 接口)获取 IDFA/IMEI,并传给神策服务器进行匹配。

(4)神策服务器将 App 端接收到的信息与之前点击广告时保存的信息进行匹配,如果匹配成功,则把对应的渠道信息( utm_source 等 属性)自动加入 AppInstall 事件中(即 trackInstallation 接口中填写的事件),同时也会通过 profileSetOnce 把渠道信息设置到用户属性「广告系列来源」中(多次匹配成功的话,用户属性仅记录第一次有值的渠道值)。

二、渠道投放步骤

第一步:需要您们的开发人员在 APP 内调用 trackInstallation 接口,采集 AppInstall 事件(APP激活事件)

iOS 文档:

https://www.sensorsdata.cn/manual/ios_sdk.html#%E8%AE%B0%E5%BD%95%E6%BF%80%E6%B4%BB%E4%BA%8B%E4%BB%B6

Android 文档 :

https://www.sensorsdata.cn/manual/android_sdk.html#32-%E8%AE%B0%E5%BD%95%E6%BF%80%E6%B4%BB%E4%BA%8B%E4%BB%B6

注:(1)如果使用精准匹配,iOS 端需要开启获取 IDFA 权限(您的 App 里需要引入 AdSupport 库),Android 端要保证 APP 可以获取到 IMEI 权限(即 Android SDK 文档中动态申请 android.permission.READ_PHONE_STATE 

(2)不可以直接在 trackInsatllation 接口中给 utm_source 等 utm 属性赋值,否则 APP 激活时,就不会进行渠道匹配,而是使用代码中填写的渠道信息设置属性值。

(3)可把渠道包信息,直接设置为 AppInstall 事件的属性,比如渠道属性 downloadChannel:huawei。

AppInstall 事件采集成功后,可以在神策系统查看是否有相应的 AppInstall 事件(即 App激活事件):

第二步:生成渠道链接

(1)如果神策分析是 1.14 及之后的版本,直接在神策分析-渠道管理页面,创建 Bilibili 的链接。


(2)如果神策分析是 1.13 及之前的版本,需手动拼接渠道链接。

iOS APP :

http(s)://神策地址/cb/installation_track?utm_campaign=广告系列名称&utm_source=广告系列来源&project=神策英文项目名&channel_name=bilibili_track&tp_os=__OS__&tp_track_id=__TRACKID__&click_time=__TS__&idfa=__IDFA__&ip=__IP__&ua=__UA__
CODE

Android APP :

http(s)://神策地址/cb/installation_track?utm_campaign=广告系列名称&utm_source=广告系列来源&project=神策英文项目名&channel_name=bilibili_track&tp_os=__OS__&tp_track_id=__TRACKID__&click_time=__TS__&ip=__IP__&imei=__IMEI__&android_id=__ANDROIDID__&ua=__UA__
CODE
  • 神策地址 :是指神策数据接收地址的域名。
  • 项目名:是指神策数据接收地址中的项目名。

  • 如果数据接收地址后面有 token,需要在链接的 project 参数后面用 & 拼接符,拼接一个 token 参数。

  • utm_source 参数值可以自定义,并且还可以添加其它 utm 参数,比如 utm_content,使用 & 符号拼接。

举例说明:

假如神策数据接收地址为 :http://systemtest.datasink.sensorsdata.cn/sa?project=support

则神策地址:http://systemtest.datasink.sensorsdata.cn,项目名:project=support

拼接的 Android 链接为:

http://systemtest.datasink.sensorsdata.cn/cb/installation_track?utm_source=bilibili&project=support&channel_name=bilibili_track&tp_os=__OS__&tp_track_id=__TRACKID__&click_time=__TS__&ip=__IP__&imei=__IMEI__&android_id=__ANDROIDID__&ua=__UA__


注意如果需要增加 $utm_ 属性之外的自定义属性,必须按照下面的步骤把自定义参数添加到链接里的 $sd_import_keys 中,这样才会将自定义参数写入到事件表以及用户表中:

例如 添加的自定义属性是 source ,channel 两个参数

$sd_import_keys=source,channel

将上面的 $sd_import_keys=source,channel 等号前后分别进行 UrlEncode编码:%24sd_import_keys=source%2Cchannel

将编码结果拼接到监测链接后面,例如:
http://systemtest.datasink.sensorsdata.cn/cb/installation_track?utm_source=bilibili&project=support&channel_name=bilibili_track&tp_os=__OS__&tp_track_id=__TRACKID__&click_time=__TS__&ip=__IP__&imei=__IMEI__&android_id=__ANDROIDID__&ua=__UA__&%24sd_import_keys=source%2Cchannel&source=xxx&channel=xxx


注⚠️:

问题:如何验证拼接了链接是否正常?

回答:将生成的渠道链接输入到浏览器的地址栏,按回车键,看下是否返回了 {"ret":0,"msg":"OK"}。如果返回则说明监测地址是通的。


第三步:将渠道链接投放到 B 站的后台,进行联调测试。

在如下截图“点击监控”处,填写第二步生成的神策渠道链接: (建议使用这个方式)

或将渠道链接填写在 DMP 后台的 API 链接填写位(具体由客户方的代理商投放同学支持) 


注⚠️:要注意投放的是 Android 渠道链接还是 iOS 渠道链接,不同的渠道链接要用不同操作系统的手机去下载 B 站 APP(哔哩哔哩)并登录账号进行联调测试


第四步:使用 B 站投放后台的预览功能进行联调测试

需要先在 Bilibili App 后台获取 MID 和 验证码,B 站 MID 绑定成功后,创建一条信息流测试创意同时点击预览按钮,静候 5 分钟(可能不需要这么长时间,具体可以咨询 bilibili 相关人员),即可在手机端刷新到广告。然后点击广告,下载并激活 App。

(1)获取 MID 方式 ( UID=MID )

下载哔哩哔哩 APP 注册并登录,点击主页头像标识,进入个人主页 


点击头像 ——编辑资料


获取 UID( UID=MID )

(2)获取验证码

在 B 站广告后台,将上面获取的 UID 填写到如下位置,点击’获取‘按钮, B 站后台会给 bilibili App 发送一条验证码

进入 bilibili 首页,点击右上角的“信封”图标


点击“系统通知“图标 


查看验证码消息 


(3)预览绑定

在B 站广告后台,MID 和 验证码填写完成之后,按照如下截图点击保存,进行“添加绑定”  

点击“预览”按钮,稍后即可在 bilibili APP 里看到投放的广告



(4)在 bilibili APP 里点击广告,下载安装并打开要投放的App (此步为必要操作步骤,如果是 iOS 手机,需要使用之前从未安装过要投放的 App 手机)

第五步:App激活成功之后,在匹配成功的情况,神策会给 B 站回调匹配成功信息

通过点击广告链接下载 APP 安装并启动,在渠道匹配成功之后(神策会将激活信息回调给 B 站),测试手机会向神策发送一个 带有 $utm_source 属性的 AppInstall 事件,并且也会通过 profileSetOnce 设置用户属性 $utm_source。


在哔哩哔哩 DMP 系统后台查看激活数

注意!!!

在第三方平台联调成功后,必须要在神策系统中查询到对应包含渠道信息匹配成功的 App 激活事件,才能投放链接(因为目前一些广告商后台提示联调成功的方式和神策要求的方式不一样,比如广点通仅测试链接格式是否正确,并不会测试是否有回调)


三、如何在神策查询渠道匹配成功对应的 App 激活事件?

在神策分析的对应项目中,选择 AppInstall 或 App激活事件,按以下方式查看

App 激活事件匹配成功查询结果应如下显示正确的 utm 渠道参数值,并且渠道追踪匹配模式为精确匹配。如果两者没有同时显示,比如广告系列来源为【未知】、渠道追踪匹配模式为模糊匹配或【未知】,说明渠道追踪精准匹配失败,请联系神策值班同学,进一步排查精准匹配失败原因。