1. 视频版讲解

扫码获取推送 ID

2. 概述

App push 触达通道测试发送功能支持扫码自动获取推送 ID(send_id),若需开启此功能,需开启设备的「调试模式」。在神策新版本 iOS SDK(1.10.22+) 和 Android SDK(3.0.3+) 中,将调试模式(Debug 模式)都预置为关闭的状态。若进行手动开启,则在 App 进程关闭后,会被重置为关闭状态。可以使用调试的设备,通过扫描网页二维码的方式,开启该设备的「调试模式」。

3. 如何开启调试模式?

3.1. 步骤1:添加并配置 scheme

在需要开启调试模式的 App 内集成神策 SDK 并添加 URL scheme

3.1.1. iOS 添加 scheme

 iOS SDK 需要 SDK 版本号为 1.10.22+

获取 scheme

使用 admin 账号,登录到神策分析相应的项目,点击右上方 admin 账号 选择【数据接入】,然后在客户端埋点中点击【复制scheme】获取 scheme,如下图所示:


配置 scheme

点击项目 target 选择选项卡 Info,添加 URL Types,将第一步获取到的 scheme 配置到 URL Scheme 中。

添加代码

在 AppDelegate 中,添加如下代码:

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    if ([[SensorsAnalyticsSDK sharedInstance] handleSchemeUrl:url]) {
        return YES;
    }
    return NO;
}
CODE


3.1.2. Android 添加 scheme

Android SDK 需要 SDK 版本号为 3.0.3+

获取 scheme

使用 admin 账号,登录到神策分析相应的项目,从【数据接入】页面获取 scheme 的值。

配置 scheme

在 AndroidManifest 中 MainActivity 的标签内,配置 scheme :

<activity android:name=".SplashActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

<activity android:name=".MainActivity">
    <!-- 在主 Activity 中配置 scheme-->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data 
			android:scheme="您项目的 scheme 值" />
    </intent-filter>
</activity>
XML

Scheme 配置注意

在配置 <intent-filter> 的时候需要注意确保只有一个 <data> 字段,不要随意修改或者合并神策 SDK 相关的 <intent-filter> ,关于 <intent-filter> 的解释,可以参考 Google 官方文档


3.2. 步骤2:打开调试模式二维码

在神策分析中打开「设置设备调试模式」二维码。

二维码位置:「神策分析」——「埋点」——「导入实时查看」——「Debug 数据」——「设置设备调试模式」

3.3. 步骤3:扫描二维码

使用需要开启调试模式的设备,通过扫码工具扫描图中二维码。使用浏览器打开二维码网址。

3.4. 步骤4:唤起 App

若 App 已经成功集成 SDK 则会直接唤起 App 或提示询问是否唤起 App


若 App 集成 SDK 存在问题或未安装 App,则会进入到如下报错界面,请检查您的 App 配置。

3.5. 步骤5:选择调试模式

连接成功后,会在 App 内弹窗提示。

在弹窗中,选择想要切换的调试模式即可。

调试模式(导入数据):打开调试模式,校验数据,并将数据导入到神策分析中

调试模式(不导入数据):打开调试模式,校验数据,但不进⾏行数据导入

3.6. 步骤6:自动获取推送 ID (send_id )并填入

4. 如何退出调试模式?

当 App 从后台退出进程,或通过工具关闭进程后,SDK 将自动关闭调试模式。

扫码获取推送 ID 讲解视频