[已更新]如何测试您的Singular SDK集成

关注
Avatar
Vaibhav Gupta
Updated

您的应用程序集成Singular SDK/S2S之后，在伴随应用程序新版本一同发布之前，确保集成正常工作是十分重要的。

Singular提供两个主要的工具来测试您的集成：一个是检查报告，检查报告自动标识您集成中的问题；另一个是SDK控制台，SDK控制台可以让您手动测试您集成的不同功能。 

下列指南会帮助您开始使用这两种工具：

指南适用于 开发者
先决条件 已经为应用程序集成了SDK或者S2S。要使用SDK控制台，需要一个移动设备来进行测试。

 

自动测试：运行SDK检查

Singular提供SDK检查报告，用于测试您的SDK和S2S集成，以查看它们是否正确部署。检查会输出一个已发现问题的列表，还包含了如何解决问题的提示。要使用SDK检查报告：

1

运行SDK检查报告

转到设置>SDK控制台并在右上角点击检查您的SDK集成（Audit your SDK integration）。

test1.png
2

下载和解读报告

报告运行完成后，您能够以CSV格式下载。

该报告是一个问题列表，列出了在您的SDK和S2S集成中发现的问题。并非所有问题都很关键，有些问题可能与您无关（因为问题可能与您选择未集成的SDK功能有关）。更多关于如何构建报告的信息，请参阅如何解读SDK检查报告？

test2.png
3

修复相关问题

查看报告中的问题并根据错误描述（Error Description）字段中的提示进行修复。

注意：对于警告/信息类的问题，请务必检查验证名称（Validation Name）并查看这是否是您未选择集成的SDK可选功能，例如延迟深度链接 (DDL)。 如果是这样，您可以忽略错误消息。

另请参阅：SDK/S2S集成的检查工具：常见问题

使用SDK控制台手动测试

提示：

  • 将这些测试步骤与SDK检查工具结合使用，以确保您的SDK/S2S集成正常运行。
  • 您还可以使用SDK控制台在集成功能时一一进行测试（在您完成整个集成之前）。

SDK控制台的常规问题，请参阅SDK控制台的常见问题。

1

添加测试设备

在控制台中添加设备：

  • 在Singular平台中，转到设置>SDK控制台。

  • 点击添加设备（Add Device）。

  • 选择您要添加的设备的平台，然后选择密钥空间（keyspace）（即广告ID的类型），例如IDFA 或 Google 广告 ID。

  • 输入您的设备ID并点击保存。

    test3.png

注意：

  • 对于 iOS 设备，如果您有权限访问，我们建议您使用IDFV。您可以使用IDFA，但您将无法让控制台“忘记”您的设备数据（参见步骤 5）。
  • 您的设备GAID或IDFA在您设备的设置菜单中应该可以获取。Singular还提供了一个Device Assist应用程序，您可以将它安装在您的测试设备上，以帮助您获取设备 ID。下载iOS版或者Android版。
  • 另请参阅：设备ID类型。
2

确保设备出现在已跟踪设备（Tracked Devices）列表中

设备必须处于已启用模式（不要禁用左侧的眼睛图标），设备中的事件才会出现在事件日志中。

您可以在设备名称栏目中添加设备的描述性名称，以确保不会将其与您可能正在跟踪的其他设备混淆。

test4.png
3

测试初始化和Sessions事件

首先要测试的是您的集成是否初始化成功并向Singular发送信息。这允许Singular开始跟踪此应用的归因！如需检查，请在事件日志中查找用户session事件。

测试初始化：

  1. 在您的设备中，打开应用程序。
  2. 等待1-2分钟。

  3. 查看SDK控制台中的事件日志并确保其显示设备的session行：

    test5.png

如果此行未显示，请检查seesion事件的用户级别日志。您可能在SDK控制台处理完新设备的注册之前打开了应用程序。
4

[iOS]测试Apple iAd Referrer

在iOS设备中，Singular应该会接收iAd归因数据。如需验证，在将设备添加到控制台并在设备上安装应用程序后，检查SDK控制台并确认“__iAd_Attribution__”事件已显示。

test7.png

注意：

  • 该事件会在应用安装后不久显示。要在已安装应用程序的旧设备上测试它，请按照说明重置设备，然后将设备再次添加到控制台，并在设备中重新安装应用程序。
  • 如果事件未显示，则可能是因为设备在SDK控制台中完成注册之前您就打开了应用程序。如果您集成了Singular静态库，请确保您正在导入iAD.framework（如果您使用的是CocoaPods，其已经被包含在内）。
5

测试自定义用户

如果您的SDK集成将自定义用户ID发送到Singular，以下是对其进行测试的方法。

  1. 在SDK控制台中注册设备。
  2. 打开应用程序。
  3. 如果需要，在您的应用程序中触发发送用户ID的操作（例如登录）。操作的性质取决于您的集成。

  4. 在发送到Singular的下一个事件中，展开SDK控制台中的事件详细信息并检查详细信息是否包含“custom_user_id”的值。test8.png

如果用户 ID 未显示：

  • 检查设置用户ID的方法是否真的在您的应用程序中被调用。
  • 您可能需要添加一个Singular SDK事件并将其命名为“设置自定义用户 ID”，以便该事件显示在SDK控制台中。
6

测试事件

如果您在SDK集成中部署了事件跟踪或收入跟踪，请按照以下说明进行测试。

更多事件信息，请参阅：

对于您在SDK集成中部署的每个事件：

  1. 在应用程序中触发事件，并检查它是否以您命名的名称出现在事件日志中。

    test9.png

  2. 如果您随事件发送了其他数据，请单击SDK控制台中的事件行以展开事件详细信息，并确保数据包含在“event_data”中。

    test10.png

如果事件未显示，则可能是因为设备在SDK控制台中完成注册之前您就打开了应用程序。检查事件的归因日志。
7

测试收入

对于您在SDK集成中部署的每种类型的收入事件：

  1. 在应用程序中触发收入事件并检查事件日志。应该会出现一个带有事件名称的行。

    注意：如果您没有为事件指定自定义名称，其会收到收入事件的默认名称“__iap__”。

  2. 点击该行将其展开，并确保已收到货币（“pcc”）、金额（“r”）和其他的事件详细信息。

    test11.png
8

测试深度链接

如果您在SDK集成中部署了深度链接，请按照以下说明测试您的深度链接功能。

注意：本文假设您的组织正在使用Singular链接-Singular于2019年推出的新的跟踪链接技术。Singular的老客户可能正在使用Singular的旧版本跟踪链接（旧链接）。

1. 设置测试目标网址

在Singular平台中，转到设置>应用程序，找到该应用程序，然后添加一个深度链接目标网址。

目标网址应该是您SDK集成中的处理程序的代码可以识别和处理的深度链接目标网址。

test12.png

2. 创建链接进行测试

现在您有了要链接的目标网址，您可以创建一个深度链接。

  1. 转到归因>管理链接并从侧边栏中选择一个应用程序。
  2. 点击创建链接。
  3. 在链接类型下，选择“自定义媒体渠道”，在媒体渠道名称下，选择“电子邮件”。
  4. 为链接命名。
  5. 点击链接设置和重定向板块并展开。
  6. 在深度链接下拉列表中选择您刚刚创建的目标网址。
  7. 在其他平台的后备目标网址文本框中，输入网站 URL

  8. 点击生成并从点击型跟踪链接字段中复制链接。

    test13.gif

3. 测试链接

要测试链接：

  1. 确保该应用已安装到您的测试设备上。
  2. 将复制的链接通过电子邮件发送到您的测试设备。
  3. 在设备中打开电子邮件并点击链接。应用程序应该会打开并显示预期的页面或内容。

测试链接的替代方法（仅限 Android）：

在您的计算机上打开命令行终端以触发深度链接：

test14.png

疑难解答

当我的应用程序已经在运行了，深度链接会打开应用程序的新实例，而不是切换到现有实例。

为避免这种情况，请编辑您的清单文件并将以下内容添加到您的活动中：

android:launchMode="singleTask"

有关启动模式选项的更多信息，请参阅Google的 <activity>文档。
9

测试延迟深度链接

  1. 要确认延迟深度链接已启用，请检查SDK控制台中的session事件。

    test15.png

  2. 按照上面测试深度链接中的说明设置测试目标和链接。
  3. 从您的测试设备上卸载应用程序。

  4. 通过电子邮件将深度链接发送到设备并在设备中打开它。该链接应该会把您带到应用商店。安装并打开应用程序后，您应该会看到所需的页面或内容。

    test16.gif
10

测试卸载跟踪

如果您在SDK集成中部署了卸载跟踪，请按照以下说明进行测试。

测试卸载跟踪比测试其他SDK功能更复杂，因为Singular依赖于Google/iOS来报告卸载，这个过程需要一些时间。您无法在Singular平台看到实时的卸载事件，也无法为此使用SDK控制台。

在测试之前，请确保您已将FCM/APNS令牌（token）发送到Singular（请参阅Android SDK：卸载跟踪和iOS SDK：卸载跟踪）。

此外，请仔细检查您是否已在应用程序配置页面中输入了FCM服务器密钥（适用于 Android）或 iOS推送证书。

测试卸载跟踪：

  1. 使用真实设备（不能是模拟器），在设备上安装应用程序。
  2. 打开应用程序以便安装进行注册。
  3. 卸载应用程序。

  4. 要检查Singular是否收到了卸载事件，您有几个选项：

    • 导出归因日志（事件日志）并找到卸载事件。卸载事件可能需要几天时间才能显示在日志中。
    • 如果您已设置发送到您内部BI系统的回传，您可以收到卸载的回传。
    • 您可以联系Singular支持或者您的客户成功经理来帮助您验证卸载跟踪。

注意：当您在等待验证卸载事件时，请勿重置设备 ID，也不要重新安装该应用程序。