了解有关报告 API 的更多信息,以及如何解决一些常见的报告问题。
提示:请务必先阅读《奇异报告 API 入门》!
故障排除
一般来说,昨天的数据应在当地时区上午 8 点前准备就绪。如果没有准备好,请检查数据可用性端点返回的 "status "参数。它可能包含有关问题的更多信息(更多信息请参阅数据可用性端点参考资料)。如果是登录问题(Singular 无法登录源以提取数据),请访问 Singular 应用程序中的 "数据连接器"页面,然后重新输入凭据。
不过,登录错误等问题可能无法立即识别。数据提取可能会因各种原因而延迟。请注意,Singular 团队会自动收到数据延迟警报,并立即开始解决问题。在此期间,您可以
- 查询所有其他网络,将延迟的网络留到以后查询
- 至少等待一小时,然后再次检查
- 在紧急情况下,如果您已经等待了很长时间,但数据源仍然没有出现,您可以通知 Singular 支持人员,但请记住,他们很可能已经在处理这个问题了。
要了解为什么会出现不适用值,请查看报告中 "不适用 "和缺失数据的故障排除。
有时,你不会在一行中获得广告系列的所有指标,而是在一行中获得广告网络指标(如成本),在第二行中获得归因跟踪指标(如安装)。
要了解出现这种情况的原因,请参阅 "连接网络和跟踪器数据"(我们的指南 "了解单一报告数据"的一部分)。
这是因为我们从某些广告网络获取数据时出现了一个技术问题。
有时,广告系列中广告网络的创意指标与广告网络的广告系列指标并不完全一致。
例如,在创意层面提取的数据显示点击次数为 50 次,而在广告系列层面提取的数据显示同一广告系列的点击次数为 45 次:
在这种情况下,为了对齐数据,Singular 会在数据库中添加一个虚拟创意行,并赋予其所需的值,这样创意的指标就会与整个广告系列的指标相加。这个值有时是负数。该虚拟行中的创意名称为 "缺失创意数据"。
这些虚拟行通常只显示在 API 结果中(不显示在您在 Singular 网络平台上运行的报告中)。您可以在查询中添加以下内容来隐藏它们:display_alignment=False
在 "创意报告常见问题和故障排除 "中阅读更多内容
Singular 提供的某些指标是根据行中的其他指标计算得出的。例如,CPI(每次安装成本)是成本除以安装次数。我们建议避免在 API 报告中使用这些指标 ,因为在任何聚合查询中(使用 "+"操作将指标相加),都会得到毫无意义的结果。
例如
检查您的查询是否包含创意维度,如creative_id、creative_name、asset_id、asset_name 等。有些网络(如 Google Ads)为每个营销活动提供国家数据,但不为每个创意提供国家数据,因此如果报告按创意细分,则无法看到国家信息。
有关 Google Ads 功能和限制的更多信息,请参阅AdWords (Google Ads) Data Connector。
Singular API和Singular用户界面(位于app.singular.net)使用相同的代码从Singular数据库中提取数据,因此结果应该总是一致的。如果不一致,可能意味着你没有运行完全相同的查询。
将 Singular 用户界面中的查询设置与 API 查询进行比较,尤其要注意以下不同之处:
- 查询不同的日期集
- 使用差异度量而不是常规度量
- 在创意报告中显示虚假行(请参阅为什么我在 "创意名称 "维度中得到 "缺少创意数据"?)
您还可以使用开发人员工具检查使用用户界面时运行的get_new_dataAPI 调用。
您只能同时运行 100 份异步报告。如果您已经提交了 100 份报告,请等待一份报告完成后再提交另一份报告。
出现这种情况有多种原因。请稍等片刻,然后重试 API 调用。如果您每天都运行相同的代码来提取报告,则应在代码中添加重试,以防出现 500 错误。
如果问题仍然存在,请联系 Singular 支持。