You need to enable JavaScript to run this app.
导航

自定义设备 ID

最近更新时间2023.01.06 11:33:36

首次发布时间2023.01.06 11:33:36

本文为您介绍设置自定义 ID 的功能介绍、如何设置自定义 ID 和查询单点追查数据等内容。

功能介绍

视频点播提供单点追查能力,即对用户的单次播放行为进行全链路追踪和问题定位。您可通过点播 SDK 和视频点播质量平台实现该能力。默认情况下,点播 SDK 会自动生成唯一的设备 ID,您可在质量平台追查该设备 ID 的播放记录。但是如果您自己已有一套独立的用户 ID 体系,希望通过用户 ID 来追查单个用户的单次播放行为,则可参考本文设置自定义 ID。

设置自定义 ID

在初始化点播 SDK 时,支持您设置自定义 ID。详细的操作步骤如下所示。

初始化自定义 ID

SDK 初始化自定义 ID,实现的代码示例如下所示。

private void initVodSDK(Context context, String userUniqueId) {
    // 1. 根据 “快速开始” 文档初始化点播 SDK
    Env.init(new Config.Builder()
        // ... 省略
        .build());
    // 2. 获取 AppLog 实例设置 userUniqueId
    IAppLogInstance applog = AppLogWrapper.getAppLogInstance();
    if (applog != null && !TextUtils.isEmpty(userUniqueId)) {
        applog.setUserUniqueID(userUniqueId); 
    }
}

移除自定义 ID

您的用户注销登录,移除自定义 ID,实现的代码示例如下所示。

// 您的用户注销登录时调用
private void onUserLogout() {
    IAppLogInstance applog = AppLogWrapper.getAppLogInstance();
    if (applog != null) {
        applog.setUserUniqueID(null);
    }
}

更新自定义 ID

您的用户成功或者切换登录,更新自定义 ID,实现的代码示例如下所示。

// 登录成功/切换后调用
private void onUserLogin(String userUniqueId) {
    IAppLogInstance applog = AppLogWrapper.getAppLogInstance();
    if (applog != null) {
        applog.setUserUniqueID(userUniqueId);
    }
}

查询单点追查数据

自定义 ID 配置完成后,您可登录视频点播控制台,选择左侧导航栏质量平台>单点追查,进入单点追查页面,查询单点追查数据。详细操作说明请见单点追查