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

您的应用程序集成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,也不要重新安装该应用程序。