Ad Manager 数据传输报表

访问与您的 Ad Manager 广告联盟相关的事件级数据

数据传输报表文件会提供来自广告系列的非汇总事件级数据。从本质上说,此类数据是 Google Marketing Platform 广告服务器日志中的原始内容,其中包含针对每类事件生成的单独文件。数据传输文件包含的事件数据精确到秒,而且您可选择在此类文件中添加其他信息,以查看与事件相关的设备、地理位置和其他信息。

 仅在 Google Ad Manager 360 中提供。

使用入门

使用数据传输报表文件需要支付额外费用。请与您的客户经理联系,以获取订购单并设置您的报表文件配置。

使用“数据传输”功能需要具备一定的专业技术知识。
如果您的组织无法管理 ETL 处理、支持大文件、操控文本文件、设计和管理中型数据库以及设计和实现脚本,请考虑与已获批准的 Google Marketing Platform 合作伙伴合作。

可用的数据传输报表文件

每个数据传输文件都包含有关不同事件的信息。您可以向每种文件类型添加字段,以查看与这些事件相关的上下文信息。

如果有相应的 Backfill 文件,Network 文件中就不会包含 Ad Exchange 或 AdSense 通过动态分配投放的展示次数。也就是说,使用 Backfill 文件可获得与动态分配的展示次数相关的信息。

Ad Manager 已完成向“已下载广告的展示次数”统计方式的转变
自 2017 年 10 月 2 日起,数据传输展示次数文件仅包含已下载广告的展示次数。包含请求次数和代码调用次数的新文件现已可用。详细了解向“已下载广告的展示次数”统计方式转变
文件类型 文件内容 示例文件
NetworkRequests
NetworkBackfillRequests
记录 Ad Manager 收到的每项广告请求,无论是否已满足。 Download
NetworkCodeServes
NetworkBackfillCodeServes
记录来自 Ad Manager 的每项回复,无论是否已下载。 Download

NetworkImpressions
NetworkBackfillImpressions

“已下载广告的展示次数”的相关信息 Download
NetworkClicks
NetworkBackfillClicks
点击次数的相关信息。  
NetworkActiveViews
NetworkBackfillActiveViews
符合 Active View 条件的 Ad Manager 展示的相关信息。  
NetworkBackfillBids 与利用公开出价功能的竞价出价相关的信息。了解详情  
NetworkVideoConversions
NetworkBackfillVideoConversions
视频事件的相关信息,包括操作次数(播放次数、暂停次数等)、内容 ID、广告连播位置等。查看所有视频事件  
NetworkRichMediaConversions
NetworkBackfillRichMediaConversions
Studio 事件的相关信息,包括标准和自定义操作次数(播放次数、暂停次数等)、操作时长等。  
NetworkActivities 每当用户对发布商网站中广告系列的查看或点击激活了广告客户网页上的活动像素(之前称为 Spotlight 像素)时,系统即会随之生成一个日志条目。  

如何传输文件

数据传输文件会按每小时一次的频率推送到 Ad Manager 云端存储分区。我们建议您定期轮询,以查看是否有更新。系统将会传输大部分数据并会在所记录的那一小时后的 5-15 个小时之间准备好相应数据,但某些延迟事件的数据可能需要长达 14 天(自事件发生之日起算)才能就绪。Google Marketing Platform 不会将数据传输信息递送给第三方服务器。

夏令时
文件名包含事件的起始小时,该时刻使用美国太平洋时区(采用夏令时),但该文件中的时间戳始终采用 Ad Manager 广告联盟时区(未必使用夏令时)。这可能会导致生成空文件或文件被跳过,也可能会导致文件包含超过一个小时的数据,具体取决于这些时区设置之间的相互影响。
 
在夏令时转换期间,系统会传送所有展示数据。

文件名

数据传输文件的文件名遵循可以预测的命名规范:[类型]_[广告联盟 ID]_[YYYYMMDD]_[HH].gz

  • YYYYMMDD 表示年、月、日。
  • HH 表示 24 小时制的起始小时。

    每个文件名中指定的小时数值(01、02、03)均采用太平洋时区,但发布商可根据数据传输文件中包含的时间戳获取对应的广告联盟时区专有数据。请在考虑文件传送时注意这种差异。

在极为罕见的情况下,数据传输文件可被重新发布以更正错误数据。在这种情况下,重新发布的文件的文件名中将会附加字符串“_corrected”,但旧版文件仍会保留在存储分区中。

关于数据传输文件中包含的数据

  • 数据延迟
    出现几个小时的延迟是正常现象,但数据传输文件的处理时间有时会比平常稍长一些。如果数据延迟,则相应的数据会显示在下一个按小时进行批量处理的文件中,并会带有准确的时间戳。举例而言,如果发生了处理延迟,则可能意味着:文件中的大部分时间戳都会是上午 8 点到上午 9 点,但也会包含一小部分更早的时间戳。不会出现数据“提前”的情况(即当前事件不会显示在上一个小时的文件中)。
  • 无活动的小时
    如果某个小时内未发生任何活动,系统会发布只包含标题数据的空白数据传输文件。如果某个小时缺少对应的文件,请查看 Ad Manager 中的报表,确定在这一小时内是否发生过任何事件。在检查特定小时内是否发生过任何事件时,请注意下文所述的日期和时间界限。如果您能通过 Ad Manager 报表确定在您所检查的这个小时内没有发生任何相关事件,则无需向支持团队咨询有关缺少数据传输文件的问题。
  • 日期和时间的界限
    与给定日期第一个小时对应的文件通常会包含太平洋时间零点到凌晨 1 点之间发生的事件,但事件时间戳采用的是发布商广告联盟所在的时区。例如,如果发布商的时区设为美国东部时间,则发布商在与当天第一个小时对应的文件中会看到凌晨 3 点到凌晨 4 点之间发生的事件。在此前的 3 个小时内发生的事件实际上会包含在前一天的文件中。因此,时间戳上的日期可能与文件名所显示的日期不同。请务必参阅文件中事件的时间戳,而不是文件的发布时间或文件名。
  • 数据传输文件中的主广告素材/随播广告素材报表
    数据传输文件会同时显示主广告素材和随播广告素材的展示信息。对于随播广告素材展示事件,IsCompanion 为“TRUE”。CreativeId 字段包含各个主广告素材和随播广告素材的广告素材 ID,而不是广告素材集 ID。数据传输文件中没有与广告素材集 ID 相关的额外字段,所以无法将随播广告素材展示数据与主广告素材展示数据关联。
  • 与 Ad Manager 查询工具报表的差异
    系统会定期从查询工具/API 生成的报表中移除劣质流量数据(网络垃圾数据)。由于要兼顾数据传输文件的发布时间表,系统可能不会反映某些这样的清理操作。这就可能会导致数据传输文件中显示的展示次数、点击次数或其他事件要略多一些。差异程度通常约为 1%。

    您的 CodeServes 数据传输文件显示的值可能会高于查询工具中的“代码调用次数”指标,这是因为数据传输会针对已投放广告的每次展示统计一次代码调用,而查询工具只会针对每次请求统计一次代码调用。某些广告素材格式(例如 Google Ads 文字广告)可能会在单项请求中包含多次展示。您可通过按 TimeUsec2KeyPart 字段值对您的数据传输文件分组,找出唯一身份展示次数以便进行比较。

使用数据传输报表文件

如果您已设置“数据传输”功能,文件就会保存在 Ad Manager 云端存储分区中。您可以借助命令行工具或通过 API 在线访问这些文件。详细了解如何访问 Ad Manager 云端存储分区

使用文件中各行上的时间戳而不是文件名中列出的小时
如果您依据文件名中的起始小时选择一组特定数据传输文件以用于数据提取和分析,则可能会因夏令时、数据收集延迟或其他类似情景而忽略后续文件中提供的数据。最好将所有数据传输文件都读取到一个独立的系统(例如,数据仓库或查询引擎)中,然后根据事件时间戳来选定数据分析范围。

数据传输文件采用原始文本格式,您可以使用电子表格编辑器对其进行转换。以下是您可以选择用来应用数据传输信息的一些常用方法示例:

  • 获取事件和活动的维度级用户汇总(例如,按广告素材汇总)
  • 计算若干天内的唯一转化次数
  • 将用户与客户数据库进行匹配
  • 针对用户地理位置和受众特征信息生成报表

您可以使用匹配表基于名称和 ID 的对应关系查找数据传输文件中包含的值,从而将广告投放信息(如广告单元或订单项)与存储在数据库中的预分配值匹配起来。

在本地存储文件

推荐做法是:确保压缩文件中的每个事件占用 25-35 个字节。这样,如果压缩文件中包含 1000 万个展示事件,就需要占用约 300 MB 的磁盘空间。请注意,这些只是估算值,实际文件可能略大。此外,由于这是数据压缩后的大小,因此您必须有额外的存储空间来解压和使用这些文件。

存储时间超过 60 天的数据传输文件将被从 Ad Manager 中清除。如果您希望文件的存储时间超过规定的 60 天,我们建议您在本地存储文件,或改用永久性云端存储解决方案(这可能需要一个完全由您控制的独立 Google Cloud Storage 帐号)。

让大型数据传输文件更易处理

Google 代码已发布一个名为 CRUSH (Custom Reporting Utilities for Shell) 的开放源代码工具包,用于处理分隔的文本数据(这些数据均是来自相应的命令行或位于 Shell 脚本中)。CRUSH 工具已经过广泛开发和测试,且在 Linux 或 Unix 操作系统中运行时效果最佳。您可通过开放源代码社区获取 CRUSH 支持。

您也可以选择使用非开放源代码工具包 DMX,这是一款由 Syncsort 开发的数据集成软件。

该内容对您有帮助吗?
您有什么改进建议?