首页 帮助中心 听云App Android可视化操作命名

听云App移动端可视化操作命名说明文档

Android

准备工作

请接入最新版本SDK,并把集成SDK的App安装到您的手机。
请确保使用已发布的最新版App进行“可视化操作命名”,以防因为版本不同,出现数据量偏差。

注意

  • “可视化操作命名”功能仅支持Android 5.0 系统以上设备
  • 安卓移动端“可视化操作命名”需要您的应用开启悬浮窗权限
  • 参考步骤:设置-更多应用-找到您要设置权限的App-权限管理-找到悬浮窗权限-设置为允许

相关权限

<!--使用可视化操作命名功能需配置悬浮窗权限-->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
<uses-permission android:name="android.permission.SYSTEM_OVERLAY_WINDOW" />

配置 URL Scheme

1、获取URL Scheme

当您在听云报表“新建App”时,您可以看到URL Scheme。

您也可以随时进入“修改配置”页面中找到您的应用对应的URL Scheme。

2、可视化操作命名需要在AndroidMainfest.xml文件的启动Actvitiy增加scheme配置。
示例如下:

<activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
  <!--请添加这里的整个intent-filter区块,并确保其中只有一个data字段-->
            <intent-filter>
                <data android:scheme="tingyun.xxxx" />
<!--请将scheme中的“tingyun.xxxx”替换为您应用的URL Scheme-->
                <action android:name="android.intent.action.VIEW"/>
                <category android:name="android.intent.category.DEFAULT"/>
                <category android:name="android.intent.category.BROWSABLE"/>
            </intent-filter>
  <!--请添加这里的整个intent-filter区块,并确保其中只有一个data字段-->
 </activity>

3、设置控件ID

听云SDK会采集用户操作的控件ID,建议您在Layout文件中添加控件ID。对于动态生成的控件,可以使用 setViewId() 方法对它设置唯一的ID。示例如下:

public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); LinearLayout layout = findViewById(R.id.layout); final Button button = new Button(this); button.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT)); button.setText("Login"); //viewId最多包含32个字符,支持英文、数字、下划线 NBSAgent.setViewId(button, "bt_login"); }

配置可视化操作命名

  1. 进入听云报表 “用户体验分析” 模块中的“操作体验分析”页面,点击页面下方的“操作配置”
  2. 点击“可视化操作命名”按钮,弹窗显示二维码。
  3. 手机扫码(确保安装了嵌有SDK的目标应用),微信扫码需要在浏览器中打开以下页面(支持浏览器扫码),在手机上点击“进入应用”可直接唤起应用。
  4. 启动“可视化操作命名”后,会在您应用的界面上出现一个“红点”。
  5. 拖动“红点”至目标控件上,松开手指即进入“可视化操作命名设置界面”。设置界面中显示该控件原始页面名称(Activity或Fragment名称)和原始操作名称(控件ID)。
  6. 在页面名称和操作名称中输入您要设置的别名(长度限制为32个字符)。
  7. 点击上传,会自动关闭可视化操作命名设置页面,提示上传成功。
  8. 您可以继续按照步骤5、6、7对新的控件进行“可视化操作命名”设置别名。操作完成后,在报表的“操作配置”中点击“刷新”,即可找到设置的别名。
  9. 可在“截图”下校验“可视化操作命名”上传操作截图是否与目标控件一致,若截图或设置别名与目标控件不符,可重新上传。

FAQ

Q:点击“进入应用”后无法启动?
A:请确保手机安装了使用听云最新版本SDK的应用,且应用的Manifest文件中正确配置了scheme。
Q:报表扫码提示“token已过期,请重新扫码”。
A:关闭当前二维码页面,刷新后重新点击“可视化操作命名”扫码。
Q:扫码唤起应用后,未显示“可视化操作命名”按钮。
A:请确认应用的Manifest文件中配置了悬浮窗权限,手机设置中该应用开启了悬浮窗权限。或者杀掉应用进程,重新扫码打开应用。
Q:如何退出“可视化操作命名”?
A:关闭正在进行“可视化操作命名”的应用即可。