报告 API 常见问题和故障排除

文档

了解有关报告 API 的更多信息,以及如何解决一些常见的报告问题。

提示:请务必先阅读《奇异报告 API 入门》

故障排除

如果报告失败,我该怎么办?
  1. 检查 "获取报告状态 "返回的错误代码,看看能否通过错误代码索引找到失败的原因。
  2. 如果问题仍然存在,请联系 Singular 的支持团队。我们建议保存报告 ID,因为团队可以使用它找到返回错误的特定 API 调用,并检查无法完成的技术原因。
我查询了数据可用性端点,但缺少一个或多个网络的数据。我该怎么办?

一般来说,昨天的数据应在当地时区上午 8 点前准备就绪。如果没有准备好,请检查数据可用性端点返回的 "status "参数。它可能包含有关问题的更多信息(更多信息请参阅数据可用性端点参考资料)。如果是登录问题(Singular 无法登录源以提取数据),请访问 Singular 应用程序中的 "数据连接器"页面,然后重新输入凭据。

不过,登录错误等问题可能无法立即识别。数据提取可能会因各种原因而延迟。请注意,Singular 团队会自动收到数据延迟警报,并立即开始解决问题。在此期间,您可以

  • 查询所有其他网络,将延迟的网络留到以后查询
  • 至少等待一小时,然后再次检查
  • 在紧急情况下,如果您已经等待了很长时间,但数据源仍然没有出现,您可以通知 Singular 支持人员,但请记住,他们很可能已经在处理这个问题了。
为什么我的一些数据丢失了(某些指标或维度中的值"不适用")?

要了解为什么会出现不适用值,请查看报告中 "不适用 "和缺失数据的故障排除

为什么同一营销活动中的指标被分成不同的行

有时,你不会在一行中获得广告系列的所有指标,而是在一行中获得广告网络指标(如成本),在第二行中获得归因跟踪指标(如安装)。

要了解出现这种情况的原因,请参阅 "连接网络和跟踪器数据"(我们的指南 "了解单一报告数据"的一部分)。

为什么会出现"无效过滤值 "错误

当你的查询包含一个不存在的过滤器时,就会出现这个错误。例如,您可能试图通过一个不存在于应用程序页面的应用程序或一个根本不存在的操作系统进行筛选。检查返回的筛选器值并适当修正查询。

要获取可以筛选的所有字段列表以及每个字段的所有有效值,请使用 筛选器端点

为什么会出现 400 错误,提示 "请求包含无效维度"?

如果您在查询中包含自定义维度,请使用自定义维度端点仔细检查维度是否仍然可用。如果您或您的团队在编写查询后对自定义维度配置页面进行了更改,则可能出现此错误。

此外,对于自定义维度,请确保使用维度 ID(而不是 "显示名称")。

更多信息请参阅自定义维度常见问题

为什么会出现 400 错误,提示 "请求包含无效的度量"或 "请求包含无效的队列周期"?

如果您在查询中包含了队列度量或事件,请使用队列度量端点仔细检查您使用的度量和时间段是否可用。确保您使用的是度量名称(而不是 "显示名称")。

为什么当我再次运行报告时,某些指标的数字会变低

您的数据可能会随时间发生变化,原因之一是 Singular 显示的数据是您的网络和跟踪器报告的数据。其中一些合作伙伴可能会在获得最终数据之前报告估计数据。例如,Twitter 表示:"Twitter 的报告会在提供印象的 24-48 小时内完成。在此之前,我们会估算数据以提供实时反馈,但数据可能会发生变化"(信息来源)。

为什么我在 "创意名称 "维度中看到"创意对齐"?为什么创意指标包含负值?

这是因为我们从某些广告网络获取数据时出现了一个技术问题。

有时,广告系列中广告网络的创意指标与广告网络的广告系列指标并不完全一致。

例如,在创意层面提取的数据显示点击次数为 50 次,而在广告系列层面提取的数据显示同一广告系列的点击次数为 45 次:

Screen_Shot_2019-12-03_at_18.19.18.png

在这种情况下,为了对齐数据,Singular 会在数据库中添加一个虚拟创意行,并赋予其所需的值,这样创意的指标就会与整个广告系列的指标相加。这个值有时是负数。该虚拟行中的创意名称为 "缺失创意数据"。

Screen_Shot_2019-12-03_at_18.19.32.png

这些虚拟行通常只显示在 API 结果中(不显示在您在 Singular 网络平台上运行的报告中)。您可以在查询中添加以下内容来隐藏它们:display_alignment=False

在 "创意报告常见问题和故障排除 "中阅读更多内容

为什么我得到的CPE、CPI 等值没有意义

Singular 提供的某些指标是根据行中的其他指标计算得出的。例如,CPI(每次安装成本)是成本除以安装次数。我们建议避免在 API 报告中使用这些指标 ,因为在任何聚合查询中(使用 "+"操作将指标相加),都会得到毫无意义的结果。

例如

Screen_Shot_2020-07-01_at_0.21.18.png

为什么我在国家维度中得到的是"N/A",而广告系列应该有国家数据?

检查您的查询是否包含创意维度,如creative_idcreative_nameasset_idasset_name 等。有些网络(如 Google Ads)为每个营销活动提供国家数据,但不为每个创意提供国家数据,因此如果报告按创意细分,则无法看到国家信息。

有关 Google Ads 功能和限制的更多信息,请参阅AdWords (Google Ads) Data Connector

为什么我的Singular API 报告Singular 用户界面不一致?

Singular API和Singular用户界面(位于app.singular.net)使用相同的代码从Singular数据库中提取数据,因此结果应该总是一致的。如果不一致,可能意味着你没有运行完全相同的查询。

将 Singular 用户界面中的查询设置与 API 查询进行比较,尤其要注意以下不同之处:

您还可以使用开发人员工具检查使用用户界面时运行的get_new_dataAPI 调用。

为什么会出现429 错误

您只能同时运行 100 份异步报告。如果您已经提交了 100 份报告,请等待一份报告完成后再提交另一份报告。

如果出现500 错误("内部服务器错误"),该怎么办?

出现这种情况有多种原因。请稍等片刻,然后重试 API 调用。如果您每天都运行相同的代码来提取报告,则应在代码中添加重试,以防出现 500 错误。

如果问题仍然存在,请联系 Singular 支持。

常见问题

我应该多久运行一次报告?

对于大多数网络来说,Singular 每天都会刷新数据,因此每天运行报告是个不错的做法。没有理由更频繁地查询数据。更多信息,请参阅 "运行每日报告"。