导出日志和用户级数据常见问题

文档

用户级数据是由 Singular 的归因跟踪器、欺诈保护引擎和 SKAdNetwork 集成记录的原始数据。您可以通过导出日志页面(归因 > 导出日志)下载用户级日志。

有关各日志字段的说明,请参阅导出日志:支持的字段

本文介绍了可供 Singular 客户使用的导出日志功能。如果您是 Singular合作伙伴,请参阅使用合作伙伴门户

日志故障排除

为什么转换/事件日志与 Singular 的汇总报告不一致

如果您下载了转换事件日志(在导出日志页面),但计数与您在 Singular 报告(报告页面或 API 报告)中看到的不一致,请检查以下内容:

报告可能使用了队列分析

你的报告可能是按群组显示事件的,也就是说,在日期范围内的每一天,报告都会统计当天安装应用程序的用户创建的事件(请参阅什么是群组指标和群组周期?)相比之下,导出日志中的事件总是与事件发生的实际日期和时间相关联。

检查报告设置,确保队列时间段设置为实际时间,以便显示实际日期发生的事件。

服务器时间与调整后的时间

Singular 数据库有两个不同的时间值与每个事件相关联:

  • 服务器时间戳反映的是 Singular服务器收到事件的时间。如果在发送事件数据时出现技术性延迟,这可能与事件发生的原始时间有很大不同。
  • 调整后的时间戳反映的是事件发生的原始时间。

导出日志"页面中的日期范围基于服务器时间戳

报告 页面和其他 Singular 报告工具(如 Singular API)中的日期范围基于调整后时间戳

例如,如果 6 月 1 日发生的事件延迟到 6 月 2 日才到达 Singular 服务器,这可能会导致事件计数出现差异。

"有关更多故障排除技巧,请参阅 "报告故障排除 "部分。

为什么我在日志中看到的是"有机"、"压制 "或 "未归属",而不是网络和活动名称?

下载的日志中出现这些值可能有几个原因。

1.真实的有机转化

如果一个转化被判定为没有付费来源,它就会被标记为 "有机 "转化,这就是它在用户级日志中的显示方式:

  • 网络:有机
  • 活动:"未归属" 2.

2.Facebook 广告系列

出于对最终用户隐私的考虑,Facebook 不允许我们显示基于Facebook 自归属 API 的用户级归属数据。这些属性显示为

  • 网络:"未归属
  • 活动:"未归属

请注意,除了自归因 API 之外,Facebook 还有一种基于Android安装推荐人的单独归因方法。基于该方法的归因会与用户级报告中的所有常规详细信息一起显示。

"有关更多信息,请参阅Facebook Ads Attribution Integration

3.TikTok 透视广告系列

自 2022 年 3 月 22 日起,出于对用户隐私的考虑,TikTok 要求MMP屏蔽直通式营销活动的用户级数据。因此,如果转化归因于 TikTok 透视(基于印象)营销活动,则在您的回贴和日志中显示如下:

  • 网络:"TikTok 受限
  • 活动:"TikTok 受限

"更多信息,请参阅 TikTok For Business Attribution Integration

4.数据保留期已过

出于对用户隐私的考虑,一些合作伙伴要求Singular在一段时间后屏蔽用户级数据。

如果安装或重新参与归因于以下情况之一,并且在数据保留期过后触发了应用内事件,您将在用户级事件日志中看到以下详细信息:

  • 网络:"有机"
  • 活动:"抑制
合作伙伴 最长数据保留期
Facebook 6 个月
TikTok 6 个月
推特 6 个月
谷歌广告 6 个月
Snapchat 2 个月

提示:如果您的内部 BI 平台收到了包含转化和事件的反馈,您可以在内部查看详细信息,以了解特定设备 ID 的原始获取来源。

为什么日志中的Facebook 事件/安装次数少于Singular 的汇总报告?

自2021年10月起,Facebook不允许Singular等MMP显示任何通过Facebook自归属API归属的安装或事件的 用户级信息 因此,这些安装和事件不会在导出日志或发送到内部 BI 的回传中标记为 Facebook 的安装和事件。该限制不适用于聚合数据,因此 Singular 会在聚合报告(即报告页面、Singular API 等)中显示有关这些安装和事件的信息。

请注意,除了自归因 API 之外,Facebook 还有另一种基于 Android 安装推荐人的归因解决方案。通过安装推荐人归因的安装和事件会出现在导出日志中。

我们鼓励您向 Singular 提供您应用程序的安装推荐人解密密钥,以便我们为您提供基于安装推荐人的 Facebook 营销活动信息。

"如需了解更多信息,请参阅Facebook Ads Attribution Integration

常见问题

什么是用户级数据

用户级数据是由Singular的归因机制和欺诈保护引擎记录的原始数据

它包含用户活动和归因相关记录的详细信息,包括点击、转换、重新吸引、应用内用户事件、回传、欺诈决策等。

Singular使用这些数据计算您在报告(如报告页面)中看到的汇总数据

作为 Singular 归因服务的客户,您可以访问原始的用户级数据,并以各种方式使用这些数据,例如,如果您怀疑存在问题,可以交叉检查汇总报告中的数据。

示例:显示用户级事件数据的日志

Screen_Shot_2020-12-30_at_19.46.06.png

如何访问用户级数据

访问用户级数据有三种方法:

1.导出日志页面(属性 > 导出日志)

通过 Singular 平台的导出日志页面,您可以手动下载用户级数据,包括点击、安装、重新吸引、应用内事件、回传及欺诈相关数据。该页面会生成 CSV 文件。

作为客户,您可以下载上个月初的数据。例如,如果现在是 2 月中旬,您可以下载 1 月 1 日及以后的数据。

有关Singular 合作伙伴可用的选项,请参阅使用合作伙伴门户:导出日志

2.数据目的地

Singular的数据目的地(ETL)将数据从Singular直接推送到您的内部商业智能平台、数据仓库或存储服务。这种方式可以导出的数据类型之一是用户级转换和事件。

"Singular数据目的地常见问题中了解更多信息。

3.配置内部 BI回传

如果您将 Singular 配置为向内部 BI 平台发送回传,您就可以收到有关安装、重新吸引、应用内事件和欺诈决策的实时数据。

"内部 BI 回传常见问题中了解更多信息。

如何从导出日志页面下载用户级数据?

导出日志:

  1. 转到属性 > 导出日志
  2. 选择相关日期范围。您可以导出上月初的日志。我们建议尽量缩小日期范围,以免超过每次下载的记录限制。
  3. 选择要导出的应用程序应用程序站点日志类型(点击、安装、事件或回传)。
  4. 将要包含的字段拖到 "选定字段"框中,选择要包含的字段。

    Screen_Shot_2020-12-30_at_19.52.07.png

    确保在导出任何日志时选择设备 ID 字段,以获得准确的用户级数据。

  5. 可以选择按归属合作伙伴、国家、设备 ID 和设备类型过滤日志。对于事件日志,还可以按特定事件过滤;对于转换日志,可以按转换类型过滤。我们建议尽可能多地过滤日志,以避免超过记录限制。Screen_Shot_2020-12-30_at_19.19.49.png
  6. 选择导出日志

限制

  • Facebook 不允许访问任何基于 Facebook 自归属 API 的用户级数据。通常可识别自归属 Facebook 安装的任何字段都会标记为 "未归属"。请注意,Facebook 也有一个基于 Android 安装推荐人的单独归因解决方案,基于此解决方案归因的安装确实会显示在用户级导出中。有关详细信息,请参阅Facebook Ads Attribution Integration文档。
  • 对于 Singular 客户,日期范围仅限于上个月初。有关 Singular 合作伙伴的可用选项,请参阅使用合作伙伴门户:导出日志
  • 每次请求的导出记录数限制为 500 万条。
  • 日志将提供截至当天最后 60 分钟的数据。选择实时数据复选框可获得过去 60 分钟的数据。
  • Singular 数据库有两个不同的时间值与日志中的每条记录相关联:服务器时间戳(反映 Singular服务器收到事件的时间)和调整时间戳(反映事件发生的原始时间)。这可能会导致用户级数据与汇总报告之间出现差异(了解更多信息)。

其他注意事项

  • 时区字段会告诉你为你的 Singular 账户设置的时区。
  • 有时间戳的字段(例如,touchpoint__timestamp)会按照配置的时区导出。基于 Unix 时间的时间戳(例如,touchpoint__unix_timestamp)使用 UTC 时区。
  • 如果您想更改默认导出的字段列表,或添加导出新字段的请求,请联系您的客户成功经理。
  • 如果网络请求用户级欺诈数据,但未通过合作伙伴配置接收欺诈反馈,您可以下载欺诈日志并与网络共享。未经同意,Singular 不会通过支持票据与任何网络共享这些数据。
我可以下载哪些类型的日志

点击

包括为确定安装或重新吸引的归因而检查的所有点击。

转换

包括有关安装和重新吸引事件的信息、归因于谁以及有关归因的其他详细信息(例如,是确定性的还是概率性的)。

注意: 为转换事件提供的位置是基于触发事件的 IP,而不是基于应用程序内部检测到的任何位置或用户提供的任何信息。如果您有事件的其他位置数据源,可以通过读取应用程序发送到 Singular 的直通参数来检查。

事件

包括有关应用程序内事件的数据,包括会话、注册、购买以及集成 Singular SDK/S2S 时在应用程序中定义的任何其他事件。
将事件日志数据与报告中的事件计数进行比较时,请确保在报告中使用实际数据,而不是 1d、7d、14d 等同期数据。请注意,报告不会显示真实时间段的唯一事件数据。

回贴

包括 Singular 发送的任何回帖数据(不仅仅是关于归因决策的回帖)。日志包括向内部 BI(如果已配置)和第三方分析工具的回传。

提示:下载回传日志时,请确保选择响应 HTTP 代码响应 HTTP 主体字段。响应 HTTP 代码会告诉你回传是否成功。200 代码表示成功;其他值表示出错。发送错误时,Singular 会以 1 分钟、5 分钟、15 分钟、30 分钟和 60 分钟的间隔重试回传 5 次。响应 HTTP 主体 可能包括有关错误的其他详细信息。

SKAN(SKAdNetwork)回传

Singular 从广告网络合作伙伴收到的 SKAdNetwork 回传日志。这些回传仅适用于使用 SKAdNetwork 跟踪的 iOS 应用程序,以及与 Singular 集成了 SKAdNetwork(涉及转发回传)的合作伙伴。进一步了解 Singular 的 SKAdNetwork 解决方案

欺诈

Singular 欺诈预防系统的原始输出。

请注意,此日志包括与安装事件相关的每个接触点(点击、印象等)的一行,包括 "有机安装 "选项的一行,该选项也作为每个安装的归因选项进行检查(更多信息,请参阅欺诈检测流程)。因此,您可能会看到单次安装有多个接触点因欺诈而被拒绝

不同字段的含义是什么?

"有关每个日志中字段的说明,请参阅 导出日志:支持的字段

如何使用日志来交叉检查汇总报告中的安装情况
  1. 报告页面(或报告 API)中运行报告,按来源和营销活动显示安装情况。
  2. 在 "导出日志"页面,选择 "转换"日志类型,并在相同日期范围内提取以下字段:

crosscheck.png

Singular保留用户级数据的时间有多长?

为了遵守我们的集成合作伙伴和全球用户隐私标准,Singular可能会在某些情况下限制用户级数据的保留时间,最多不超过30天。除非另有规定,用户级数据的默认保留期限如下:

  • 印象数据:自收集之日起保留14 天
  • 点击数据:自收集之日起保留30 天
  • 回传数据:自收集之日起保留30 天
  • 事件数据:从上个月开始保留(最多 60 天)。
  • 归因数据:从上个月开始保留(最长 60 天)。
  • 欺诈数据:从上个月开始保留(最长 60 天)。

这些保留期限可确保遵守隐私法规,同时提供用于分析和报告的重要数据。要在这些期限之后保留所有日志级数据,我们强烈建议您设置自动导出,以便在内部系统中捕获并存储这些信息。