您的应用程序集成Singular SDK/S2S之后,在伴随应用程序新版本一同发布之前,确保集成正常工作是十分重要的。
Singular提供两个主要的工具来测试您的集成:一个是检查报告,检查报告自动标识您集成中的问题;另一个是SDK控制台,SDK控制台可以让您手动测试您集成的不同功能。
下列指南会帮助您开始使用这两种工具:
指南适用于 | 开发者 |
先决条件 | 已经为应用程序集成了SDK或者S2S。要使用SDK控制台,需要一个移动设备来进行测试。 |
自动测试:运行SDK检查
Singular提供SDK检查报告,用于测试您的SDK和S2S集成,以查看它们是否正确部署。检查会输出一个已发现问题的列表,还包含了如何解决问题的提示。要使用SDK检查报告:
1 |
运行SDK检查报告转到设置>SDK控制台并在右上角点击检查您的SDK集成(Audit your SDK integration)。 |
2 |
下载和解读报告报告运行完成后,您能够以CSV格式下载。 该报告是一个问题列表,列出了在您的SDK和S2S集成中发现的问题。并非所有问题都很关键,有些问题可能与您无关(因为问题可能与您选择未集成的SDK功能有关)。更多关于如何构建报告的信息,请参阅如何解读SDK检查报告? |
3 |
修复相关问题查看报告中的问题并根据错误描述(Error Description)字段中的提示进行修复。 注意:对于警告/信息类的问题,请务必检查验证名称(Validation Name)并查看这是否是您未选择集成的SDK可选功能,例如延迟深度链接 (DDL)。 如果是这样,您可以忽略错误消息。 |
另请参阅:SDK/S2S集成的检查工具:常见问题
使用SDK控制台手动测试
提示:
- 将这些测试步骤与SDK检查工具结合使用,以确保您的SDK/S2S集成正常运行。
- 您还可以使用SDK控制台在集成功能时一一进行测试(在您完成整个集成之前)。
SDK控制台的常规问题,请参阅SDK控制台的常见问题。
1 |
添加测试设备在控制台中添加设备:
|
2 |
确保设备出现在已跟踪设备(Tracked Devices)列表中设备必须处于已启用模式(不要禁用左侧的眼睛图标),设备中的事件才会出现在事件日志中。 您可以在设备名称栏目中添加设备的描述性名称,以确保不会将其与您可能正在跟踪的其他设备混淆。 |
3 |
测试初始化和Sessions事件首先要测试的是您的集成是否初始化成功并向Singular发送信息。这允许Singular开始跟踪此应用的归因!如需检查,请在事件日志中查找用户session事件。 测试初始化:
如果此行未显示,请检查seesion事件的用户级别日志。您可能在SDK控制台处理完新设备的注册之前打开了应用程序。 |
4 |
[iOS]测试Apple iAd Referrer在iOS设备中,Singular应该会接收iAd归因数据。如需验证,在将设备添加到控制台并在设备上安装应用程序后,检查SDK控制台并确认“__iAd_Attribution__”事件已显示。 注意:
|
5 |
测试自定义用户如果您的SDK集成将自定义用户ID发送到Singular,以下是对其进行测试的方法。
如果用户 ID 未显示:
|
6 |
测试事件如果您在SDK集成中部署了事件跟踪或收入跟踪,请按照以下说明进行测试。 更多事件信息,请参阅: 对于您在SDK集成中部署的每个事件:
如果事件未显示,则可能是因为设备在SDK控制台中完成注册之前您就打开了应用程序。检查事件的归因日志。 |
7 |
测试收入对于您在SDK集成中部署的每种类型的收入事件:
|
8 |
测试深度链接如果您在SDK集成中部署了深度链接,请按照以下说明测试您的深度链接功能。 注意:本文假设您的组织正在使用Singular链接-Singular于2019年推出的新的跟踪链接技术。Singular的老客户可能正在使用Singular的旧版本跟踪链接(旧链接)。 1. 设置测试目标网址在Singular平台中,转到设置>应用程序,找到该应用程序,然后添加一个深度链接目标网址。 目标网址应该是您SDK集成中的处理程序的代码可以识别和处理的深度链接目标网址。 2. 创建链接进行测试现在您有了要链接的目标网址,您可以创建一个深度链接。
3. 测试链接要测试链接:
测试链接的替代方法(仅限 Android): 在您的计算机上打开命令行终端以触发深度链接: 疑难解答当我的应用程序已经在运行了,深度链接会打开应用程序的新实例,而不是切换到现有实例。 为避免这种情况,请编辑您的清单文件并将以下内容添加到您的活动中:
有关启动模式选项的更多信息,请参阅Google的 <activity>文档。 |
9 |
测试延迟深度链接 |
10 |
测试卸载跟踪如果您在SDK集成中部署了卸载跟踪,请按照以下说明进行测试。 测试卸载跟踪比测试其他SDK功能更复杂,因为Singular依赖于Google/iOS来报告卸载,这个过程需要一些时间。您无法在Singular平台看到实时的卸载事件,也无法为此使用SDK控制台。 在测试之前,请确保您已将FCM/APNS令牌(token)发送到Singular(请参阅Android SDK:卸载跟踪和iOS SDK:卸载跟踪)。 此外,请仔细检查您是否已在应用程序配置页面中输入了FCM服务器密钥(适用于 Android)或 iOS推送证书。 测试卸载跟踪:
注意:当您在等待验证卸载事件时,请勿重置设备 ID,也不要重新安装该应用程序。 |