客户端埋点验证

客户端开发工程师埋点后很可能希望快速了解埋点是否正确被触发。

由于易观方舟支持实时分析，我们首推在产品内通过建立专门用于测试的项目来进行验证。这样可以对数据从上报、入库到使用进行全环节验证。又不会对生产环境的上报的数据造成污染。

但很多时候负责埋点的工程师并没有方舟的使用权限，或希望借助方舟而用另一种更熟悉的方法进行埋点验证。

针对这种场景，我们也提供了相应的解决方案。

借助这种方案可以做到：

• 客户端有操作时，验证是否会正确触发上报；

• 查看上报事件的属性（名称、属性名称及类型）是否符合预期；

• 了解到客户端操作的行为序列；

网站埋点（JS）

调试模式开启时

debugMode: 1 或 2

当调试模式开启时，SDK 会向浏览器的控制台中输出日志。日志中会包含一些告警、错误，也会包含上报事件的内容。

以 Chrome 为例，步骤如下：

• 启动 Chrome，并访问已经埋好点的网站

• 按 F12 或 Ctl/Cmd + Alt/Opt + I 打开 “开发者工具”

• 点击 “Console” 页签进入控制台

• 正常浏览页面，接可以看到控制台有大量的日志

接下来，为了方便查看事件报文的内容，我们可以在过滤器中设定关键字“analysys”筛选出报文。

SDK初始化相关日志
Send message to server: **实际上报地址**
上报数据相关日志

如日志发送成功，控制台会输出：

Send message success

调试模式未开启时

debugMode: 0

生产环境通常会关闭调试模式，在调试模式未开启时SDK不会向浏览器的控制台发送任何日志，这对调试造成了一些不利。但通过浏览器自带的开发者工具也查看到上报的事件内容。下面以 Chrome 为例，介绍相应的测试方法。

Chrome

步骤如下：

• 启动 Chrome，并访问已经埋好点的网站

• 按 F12 或 Ctl/Cmd + Alt/Opt + I 打开 “开发者工具”

• 如上图，点击“Network”页签

• 正常浏览页面，就能在浏览器中看到上报的埋点日志

• 如上图，在左上方红框位置的过滤器中输入“up?”

• 然后点击每条记录，就能在右侧红框“Request Payload”中看到上报报文的内容了

APP埋点（iOS/Android）

移动端 SDK 也会输出日志，如果你是开发者，你可以按照下面的说明开启调试模式，通过 SDK 的日志调试。同时我们也提供一种面向非开发者的，通过抓包工具来查看上报日志的方式。

如果你是开发者

步骤如下：

• 先在代码中设置调试状态开启

Andorid

AnalysysAgent.setDebugMode(this, 2);

0：关闭 Debug 模式
1：打开 Debug 模式，但该模式下发送的数据仅用于调试，不计入平台数据统计
2：打开 Debug 模式，该模式下发送的数据可计入平台数据统计

iOS

AnalysysAgent setDebugMode:AnalysysDebugButTrack

AnalysysDebugOff：关闭 Debug 模式
AnalysysDebugOnly：打开 Debug 模式，但该模式下发送的数据仅用于调试，不计入平台数据统计
AnalysysDebugButTrack：打开 Debug 模式，该模式下发送的数据可计入平台数据统计

• 使用 Eclipse、AndroidStudio 或 Xcode 工具等，请在 Console 中搜索 tag 为“Analysys”

若初始化成功后，控制台会输出：

SDK初始化相关日志
Send message to server: **实际上报地址**
上报数据相关日志

如日志发送成功，控制台会输出：

Send message success

如果你不是开发者

非开发者往往 App 已经安装在手机上，若想调试需要将 App 的流量发送到流量分析工具中进行调试。市场上比较知名的工具如下：

mitmproxy
https://mitmproxy.org/#mitmweb

Charles
https://www.charlesproxy.com/download/ 

Fiddler
https://www.telerik.com/fiddler

步骤如下：

• 从上述流量监控工具中选择适合您的，安装并按提示将您 app 的流量转发到工具里

• 在工具中的过滤器中输入“up?”

• 正常使用 app，就能在工具中看到上报的埋点日志

• 点击每条记录，就能查看上报报文的内容了

如果上述方案仍然不能满足您的需要，可联系我们，我们非常愿意了解您的需要，并尽力提供适合您的解决方案。

以上内容没有解答我的问题？点击我进入方舟论坛去反馈 🚀