中文
登录
后可查看全部文档
增长参谋/技术接入文档/广告监测服务/归因服务接入-Android
归因服务接入-Android
最近更新 2023-04-24 15:20:25

重要提示:

  1. 归因服务接入后,会关联归因接入兼容数据接入,全部联调成功后,需要有真实归因数据进来才能真正接入成功,需要创建推广活动,用生成的监测链接配置在对应投放平台上
  1. oppo渠道配置监测链接门槛:需连续7天投放消耗在1w以上
  2. 支持渠道:归因服务支持渠道

1. 环境准备

  • Gradle编译环境(Android Studio)

2. 导入SDK

2.1 使用远程引入安装SDK

project级别的build.gradle文件中添加Maven的仓库地址

示例:

如果需要使用无全埋点的基础版本,只需要引入下面的 Lite 文件,不需要引入插件

在主modulebuild.gradle文件添加SDK依赖

注意: 6.x 版本开始,app级别的build.gradle,需要添加kotlin相关依赖,如已经添加,可忽略implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.3.61"


2.2 手动安装SDK

如果已经远程引入安装SDK,请忽略此步骤。下载 RangersAppLog Android SDK 解压,将 aar、jar 引入项目libs文件夹。在AndroidStudio项目中,打开project级别的build.gradle,添加:

RangersAppLog-Lite-cn-6.14.2.zipRangersAppLog-Lite-cn-6.14.2.zip
596.21 KB

在app module的build.gradle并在dependencies中添加:


2.3 SDK所需的App权限

SDK需要以下权限:

序 号

权限

说明

1

android.permission.READ_PHONE_STATE

读取 IMEI等设备信息等作为设备标识

2

android.permission.ACCESS_WIFI_STATE

android.permission.ACCESS_NETWORK_STATE

android.permission.INTERNET

网络访问相关,wifi,获取网络状态

注:Android 6.0及以上版本,需要在运行时动态检查和申请权限。


3. 初始化SDK

在Application 中 onCreate 中初始化RangersAppLog(初始化需要尽可能早)。提示:本SDK默认支持多进程初始化

初始化参数说明

appid

channel

为增长参谋应用列表中生成的AppID




自定义,一般为应用市场名称


4.联调管理

此功能是参谋为了配合投放侧的联调,通过对设备加白,解除投放平台联调需要新设备的限制

4.1 启用延迟深度链接

在SDK初始化时,启用延迟深度链接,config.enableDeferredALink();

4.2 SDK集成onAttributionData方法

初始化时,通过在IALinkListener中增加onAttributionData方法来获取每一次安装用户的归因数据。

4.3 注意事项

  • 下载应用或者使用本地应用并打开时,需提前开启隐私授权,并保证在SDK初始化之前进行
  • 深度事件联调时需真机打开应用并保证触发,用于联调深度事件的设备需预先触发激活,可先联调激活,并于5min内继续联调深度事件
  • 监测留存事件,如监测失败,可选择手动上报快速完成联调
  • 联调管理加白的did要与实际联调设备的did保持一致,否则加白效果不生效

4.4 抓包验证

以上检查配置项都完成后,可以在窗口期内卸载重装通过抓包确认联调数据是否触发

抓包接口

  1. https://toblog-alink.ctobsnssdk.com/service/2/attribution_data
  2. https://alink.volceapplog.com/service/2/attribution_data
  3. 或者其他带有alink开头的域名,以上检测到任一一个接口即可

5. 深度事件回传(可选)

如果在广告投放平台进行投放时只统计激活数,可忽略此步骤。

如果需要此功能,须根据深度事件进行自定义埋点,然后在增长参谋创建推广活动的时候做关联

5.1 系统事件

系统深度事件

事件类型

事件名称(自定义)

上报时机

激活(系统自带,可以不用埋点)

activation

-

留存(系统自带,可以不用埋点)

app_launch

-

5.2 自定义事件

自定义深度事件

事件类型(固定)

事件名称(自定义)

上报时机(自定义)

注册

例:register

根据业务场景

付费

例:pay

根据业务场景

订单

例:order

根据业务场景

关键行为

例:key_behavior

根据业务场景

下载

例:download

根据业务场景

注:自定义埋点事件设计原则如下:

  • event 命名仅支持字母(建议小写)、数字和下划线,不要使用 launch、terminate等系统内置事件名
  • param 命名仅支持字母(建议小写)、 数字和下划线
  • _param 的值仅支持以下类型(请按实际数据类型填写,便于后续计算分析),不支持数组和对象
  • 字符串
  • 整型
  • 浮点型_
  • param 值空的含义,建议用“be_null”,不建议使用""或" "

5.3 BD_DID获取

客户端如需要唯一性ID来处理业务逻辑,可以通过SDK获取,建议使用方式二(获取率比较高)

方式一

注意:请在初始化完成的3秒后开始获取,否则可能返回为空

方式二

SDK提供addDataObserver方法,用以获取各类通知,建议放在 Application 中

设置iid、ssid、did、abconfig从本地加载和server加载成功的回调。 IDataObserver接口方法的参数说明如下:其中 onRemoteIdGet 方法中 s1参数为最新获取的bd_did

6. 埋点上报

用户行为日志采用事件event + 属性params的形式,事件一般对应多个属性,也可以仅有事件没有属性。代码埋点方案一般由数据分析师或产品运营设计。 仅上报事件的代码埋点,示例如下:

上报事件和对应属性的代码埋点,示例如下:

例如上报付费场景,自定义事件名称为pay,以下为两种上报方式示例,选择其中一种即可

7. 埋点验证

客户端埋点后,需要手动触发,并通过Charles抓包确认埋点是真实上报到服务端的

7.1 关闭加密开关

本地验证阶段,为方便抓包验证埋点,需要把加密开关关闭,上线后建议再开启

7.2 验证上报参数

自定义埋点触发后会通过相关接口上报埋点信息,需要确认下是否包括自定义埋点事件

7.2.1 激活上报

抓包接口:https://klink.volceapplog.com/service/2/app_alert_check/

接口返回报文如下代表激活已经成功上报

7.2.2 自定义埋点上报

抓包接口:https://toblog.volceapplog.com/service/2/app_log

检查请求参数中是否携带自定义的事件名称,如有代表自定义事件埋点成功且正常上报

以上激活和相关自定义埋点事件验证成功后,可以跟对应投放平台联调后进行投放


本篇目录
联系我们