1. 集成 SDK

1.1. 神策 SDK 接入

神策 SDK 接入文档：https://manual.sensorsdata.cn/sa/latest/tech_sdk_client-1573786.html 。


激活支持 GAID 匹配

随着 Android 系统版本不断升级，在 Android Q 版本中已经禁止普通 App 获取 IMEI 号，该功能会影响激活功能的使用。同时对于海外客户，海外手机基本使用的是谷歌服务，基于此种情况需采用 GAID 的方式来进行渠道追踪，所以神策 Android SDK 中新增 GAID 的支持。

第一步：客户调用 trackAppInstall 并传入 $gaid 属性（注：需要先确认元事件中存在 $AppInstall 事件，否则会影响事件采集）

try {
    JSONObject properties = new JSONObject();
    properties.put("$gaid", "e4fe9bde-caa0-47b6-908d-ffba3fa184f2");
    SensorsDataAPI.sharedInstance().trackAppInstall(properties);
} catch (Exception e) {
    e.printStackTrace();
}

第二步：Android SDK 内部处理结果

{
    "_track_id": 1288325158,
    "time": 1563592064368,
    "type": "track",
    "distinct_id": "4f295025f34c171a",
    "lib": {
        "$lib": "Android",
        "$lib_version": "3.2.1",
        "$app_version": "1.0",
        "$lib_method": "code",
        "$lib_detail": "com.sensorsdata.analytics.android.sdk.SensorsDataAPI##trackEvent##SensorsDataAPI.java##3067"
    },
    "event": "$AppInstall",
    "properties": {
        "$lib": "Android",
        "$os_version": "8.0.0",
        "$device_id": "4f295025f34c171a",
        "$lib_version": "3.2.1",
        "$model": "FRD-AL10",
        "$os": "Android",
        "$screen_width": 1080,
        "$screen_height": 1920,
        "$manufacturer": "HUAWEI",
        "$app_version": "1.0",
        "$wifi": true,
        "$network_type": "WIFI",
        "$ios_install_source": "android_id=4f295025f34c171a##imei=##mac=B0:55:08:28:14:7C##gaid=e4fe9bde-caa0-47b6-908d-ffba3fa184f2",
        "$is_first_day": true
    }
}

注意

  • properties 里已没有 $gaid 属性
  • 属性 $ios_install_source 内容为："android_id=4f295025f34c171a##imei=##mac=B0:55:08:28:14:7C##gaid=e4fe9bde-caa0-47b6-908d-ffba3fa184f2"

1.2. Appsflyer SDK 接入

Appsflyer SDK 接入文档：https://support.appsflyer.com/hc/zh-cn/sections/6551164458257-%E5%AF%B9%E6%8E%A5AppsFlyer-SDK

2. 神策后台配置

2.1. 打开“渠道匹配结果 激活”事件开关

当您需要使用神策的“导入第三方归因数据工具”时，需要开启「渠道匹配结果」开关：

2.2. 设置 Appid

请您向 Appsflyer 申请获取到 appid。appid 是登陆 AF 后台的这个 app，链接里的最后一块就是，ios 的 app id 和安卓的 appid 如下所示：

appid 示例：

  • ios的id：id1493xxxx08
  • 安卓的id：com.Lingxiang.HundouLuo

获取到的 appid 配置到神策后台：

2.3. 自定义参数配置

神策海外归因新增自定义参数功能，支持用户以自定义参数方式接收更多 Appsflyer 变量数据。

添加自定义参数时，左侧输入框填写用户自定义参数名，右侧输入框填写 Appsflyer 支持的参数名。

2.4. 获取神策 URL

  • 点击“复制”图标复制 Appsflyer 列的 URL

注意：以上配置完成后，请务必联系神策对接人员帮忙重启海外归因服务，方可进行后续操作。

3. Appsflyer 后台配置

3.1. 开启 push API

  1. 请您登录 AppsFlyer 后台，左侧导航栏点击「API数据接口」；
  2. 下滑找到 Push API，选择勾选回调参数；

注意：

1、push API 选择回调参数时，推荐全选所有参数；

2、push API 设置的时候一定要选择添加  AppsFlyer_ID 这个参数；

3.2. 填写渠道信息

  1. 请您在 HTTP 方式中选择「GET」，回传网址请填写神策提供的 URL 地址，填好后点击「发送测试」；
  2. 事件类型仅需选择激活，注意不论自然流量还是非自然流量，都需勾选回传给神策，否则数据不准确，
  3. 请确认全部配置完成，点击屏幕右下角的「保存」；

注意：当前仅支持推送激活事件类型，有其他事件推送需求，请咨询神策对接人员。

4. 联调测试

  1. 请您准备一台专用海外版的测试手机设备，参考下列链接将测试设备加入白名单：
  2. 成功加入白名单后，下载安装并激活您的 App；
  3. 请您登陆神策分析（SA），选择分析→事件分析，查看访问渠道追踪链接、App激活、渠道匹配结果激活 这三个事件数据；
  4. 确保客户已下载安装并激活了集成 神策 SDK 和 appsflyer SDK 的 App ，请查看：
    • 访问渠道追踪链接 事件（ $AppChannelMatching ）：存放 AF 传过来的激活事件；
    • App 激活 事件（ AppInstall ）：存放神策 SDK 上报的激活事件；
    • 渠道匹配结果激活 事件（ $ChannelMatchedInstall ）：存放神策和 Appsflyer 匹配结果的激活事件，携带渠道信息并可用于渠道追踪分析。
  5. 若某事件没有找到联调设备设备号（一般为 gaid），请联系神策技术支持人员逐一排查问题。若以上三个事件都有数据且联调设备号能对应上，则表示联调成功。

现在，您便可在 SA 上进行多维度渠道追踪数据分析了。