[已更新]SDK控制台常见问题和疑难解答

SDK控制台是一个测试您是否已正确实现与Singular的SDK/S2S集成的工具。

将测试设备添加到控制台后(通过提供设备ID),控制台会向您展示您的应用程序是否正在发送Singular所需的信息,这些信息可以用来归因安装、跟踪事件等。

使用SDK控制台测试您的集成的详细指南,请参阅如何测试您的Singular SDK集成

 

疑难解答

为什么事件日志中没有显示任何事件?

如果您已注册测试设备并按照指南测试您的SDK集成,但事件日志中未显示任何行,请仔细检查以下内容:

  • 确保您在测试设备上打开了应用程序(以查看用户session事件)。
  • 确保您已创建一些应用内事件(如果您想测试您的事件)。
  • SDK控制台仅显示实时事件(它不会在设备中查找历史事件)。
  • 确保设备已在已跟踪设备(Tracked Devices)列表中启用(未禁用眼睛图标):

screenshot-app.singular.net-2020.02.14-19-23-49.png

  • 在事件日志上方查找COLLECTING REAL TIME DATA消息。如果显示该消息,则表示Singular当前正在检查来自至少一个设备的事件。如果日志中没有出现任何事件,这可能表明您应用程序中的SDK未正确发送事件。
为什么在使用Singular SDK 12.0.0及更高版本测试应用程序时缺少_InstallReferrer事件?

从Singular SDK 12.0.0开始,您无需测试_InstallReferrer事件。将您的应用推送到商店后,我们的SDK 会把_InstallReferrer数据放置在第一个session事件中。您只需要查看session事件是否出现在SDK控制台中。

如果您使用的是旧版本的Android SDK,您仍然需要检查SDK控制台中的_InstallReferrer事件。

常见问题

如何使用 SDK控制台测试我的集成

使用SDK控制台试您的集成的详细指南,请参阅如何测试您的Singular SDK集成

如何注册移动设备以开始测试?

要将设备添加到控制台:

  • 在Singular平台中,转到设置>SDK控制台
  • 点击添加设备。

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

  • 输入您的设备ID,然后点击添加

    image11.png

    注意:

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

重要:确保新设备出现在已跟踪设备(Tracked Devices)列表中

设备必须处于已启用模式(未禁用左侧的眼睛图标),设备中的事件才会出现在事件日志中。

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

image12.png

如何解读事件日志

提示:使用SDK控制台测试您集成的详细指南,请参阅如何测试您的Singular SDK集成

在您注册设备、发送一些事件并等待大约1分钟后,这些事件开始出现在SDK控制台页面的事件日志中。

image8.png

单击一行以显示从应用程序发送的事件的详细信息。

image9.png

当事件日志过长时,点击清除日志(Clear Log)以清空事件日志。

提示:如果您不点击清除日志,日志将保留来自每个已跟踪设备的最后500个事件。

如何从控制台中删除/移除设备

删除设备

要从跟踪列表中删除设备,请将鼠标悬停在设备ID上并点击删除。这将从屏幕中清除所有事件日志,但 Singular仍会记住此设备上的应用程序已归因于某个媒体渠道。

遗忘(Forgetting)设备

要遗忘设备,请将鼠标悬停在设备ID上并单击遗忘(Forget)。这会使Singular删除设备归因的内部数据。 这是重置测试设备,以将其用于进一步的归因测试的一部分(请参阅下一板块)。

另请参阅:如何重置设备并清除归因信息,以便用来再次测试安装归因?

如何重置设备并清除归因信息,以便用来再次测试安装归因?

如果您想使用同一设备再次测试您的SDK集成,除了清除设备在Singular平台中的归因外,您还必须在设备中删除所有本地缓存的数据。

Android设备步骤

  1. 关闭应用程序并确保其未运行(如果有该选项,请使用设置菜单中的强制停止)。
  2. 点击通知窗口或应用程序菜单中的滚轮图标进入设置菜单。
  3. 转到应用程序,选择您正在测试的应用程序,长按应用程序并选择应用程序信息
  4. 选择存储,然后选择清除缓存清除数据
  5. 在Singular SDK控制台中,将鼠标悬停在设备行上并点击忘记,让我们的系统忘记此设备的归因信息。

    image5.png

提示:Google Play提供了为您执行此功能的应用程序(请参阅示例)。

iOS设备步骤

  1. 关闭应用程序,然后卸载。
  2. 打开SDK控制台并点击忘记(Forget)让我们的系统忘记此设备的归因信息。

    image5.png

提示:使用老用户召回不活跃窗口进行测试

不活跃窗口是一项设置,用于确定用户处于不活跃状态的时间长度,以判断用户是否符合老用户召回归因的条件。如果您在启动广告系列之前测试老用户召回归因,那么不活跃窗口会让事情更加困难。这就是为什么测试设备(已添加到SDK控制台并已启用眼睛图标的设备)不受不活动窗口影响的原因。