視頻版講解

掃碼獲取推送 ID

概述

App push 触达通道测试发送功能支持掃碼自動獲取推送 ID(send_id),若需開啟此功能,需開啟設備的「調適模式」。在神策新版本 iOS SDK(1.10.22+) 和 Android SDK(3.0.3+) 中,將調適模式(Debug 模式)都预置为關閉的状态。若進行手動開啟,则在 App 進程關閉後,会被重置为關閉状态。可以使用調適的設備,通过掃描網页二維碼的方式,開啟该設備的「調適模式」。

如何開啟調適模式?

步骤1:添加並配置 scheme

在需要開啟調適模式的 App 内集成神策 SDK 並添加 URL scheme

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 {
    <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="0ac8deea-c87a-4480-9e5b-2a3914e0930d"><ac:plain-text-body><![CDATA[ <span style="color: #336699"><strong>if</strong></span> ([[SensorsAnalyticsSDK sharedInstance] handleSchemeUrl:url]) {
    ]]></ac:plain-text-body></ac:structured-macro>
    <span style="color: #336699"><strong>return</strong></span> YES;
    }
    <span style="color: #336699"><strong>return</strong></span> NO;
    }



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>

Scheme 配置注意
在配置 <intent-filter> 的时候需要注意确保只有一个 <data> 欄位,不要随意修改或者合並神策 SDK 相關的 <intent-filter> ,關于 <intent-filter> 的解释,可以参考 Google 官方文檔。



步骤2:打開調適模式二維碼

在神策分析中打開「设置設備調適模式」二維碼。

二維碼位置:「神策分析」——「埋點」——「導入实时查看」——「Debug 數據」——「设置設備調適模式」


步骤3:掃描二維碼

使用需要開啟調適模式的設備,通过掃碼工具掃描圖中二維碼。使用瀏覽器打開二維碼網址。

步骤4:唤起 App

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

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

步骤5:選擇調適模式

连接成功後,会在 App 内弹窗提示。
在弹窗中,選擇想要切换的調適模式即可。

調適模式(導入數據):打開調適模式,校验數據,並將數據導入到神策分析中
調適模式(不導入數據):打開調適模式,校验數據,但不進⾏行數據導入

步骤6:自動獲取推送 ID (send_id )並填入

如何退出調適模式?

當 App 從後台退出進程,或通过工具關閉進程後,SDK 將自動關閉調適模式。
掃碼獲取推送 ID 講解視頻