数据传输功能中的已下载广告的展示次数

在 2017 年 10 月 2 日改用已下载广告的展示次数后，我们对数据传输功能进行了更新，以便让您更清楚地了解，有多少广告请求对应的广告资源被 Ad Manager 或 Ad Exchange 填充了广告，并由系统下载了广告以供用户观看。

您的数据传输设置并不会随这项更改自动更新。了解如何开始使用。

更改摘要

• 对展示事件记录文件的内容进行了更新
  NetworkImpressions / NetworkBackfillImpressions 文件会记录已下载广告的展示次数和广告空缺的展示次数。
• 提供了更多文件类型，以便记录请求和代码调用
  • NetworkRequests / NetworkBackfillRequests
    用于记录 Ad Manager 收到的每项广告请求，无论相应广告资源是否填充了广告。
  • NetworkCodeServes / NetworkBackfillCodeServes
    用于记录 Ad Manager 的每次响应，无论系统是否下载了广告。
• 代码调用事件记录文件和展示事件记录文件中添加了一个字段
  添加了 ImpressionId 字段，以便您匹配代码调用和展示。

如何使用这些文件和字段

每次代码调用都会收到一个具有唯一性的 ImpressionId 字符串值。您可以使用此值以及 KeyPart 值，来匹配代码调用事件记录文件和展示事件记录文件中的记录。

• 如果 ImpressionId 记录显示在 NetworkCodeServes 文件中，则表示 Ad Manager 做出的响应是提供了广告素材。
• 如果 ImpressionId 记录显示在 NetworkImpressions 文件中，则表示系统已下载返回的广告素材以供用户观看。请注意，此 ImpressionId 记录可能会显示在另一个小时（而非请求事件和代码调用事件对应的小时）的文件中。

所有广告空缺的展示均记录在 NetworkRequests 文件中。

请求、代码调用和展示

单个请求可能会促成多个代码调用事件或展示事件。例如，在针对移动应用的中介中，对于返回的中介链中使用的每次广告联盟调用，系统都会计入一次代码调用，并且对于购买了展示机会的广告联盟，系统会计入一次展示。

KeyPart 和 TimeUsec2 值始终与相应请求对应的代码调用次数值和展示次数值一致，不过相应展示的 EventTimeUsec2 和 EventKeyPart 值可能会不同于这两个次数值，因为它们是特定于相应展示事件本身的值。如果展示出现延迟，请求和代码调用会具有相同的 EventTimeUsec2 值和 EventKeyPart 值，但相应展示的这两个值则与它们的不同。

查看示例

已下载广告的展示

已下载广告的展示会同时出现在所有 3 个文件中。在此示例中，有一次延迟的展示，该展示的 EventTimeUsec2 值不同于请求和代码调用的这个值。

	TimeUsec2	EventTimeUsec2	KeyPart	ImpressionId
NetworkRequests	1506934800	1506934800	abCdEFg123	--
NetworkCodeServes	1506934800	1506934800	abCdEFg123	1-0
NetworkImpressions	1506934800	1506935438	abCdEFg123	1-0

已投放广告的展示

已投放广告的展示仅显示在 NetworkRequests 文件和 NetworkCodeServes 文件中。

	TimeUsec2	EventTimeUsec2	KeyPart	ImpressionId
NetworkRequests	1506934800	1506934800	abCdEFg123	--
NetworkCodeServes	1506934800	1506934800	abCdEFg123	1-0
NetworkImpressions	--		--	--

广告空缺的展示

广告空缺的展示目前会显示在 NetworkRequests 文件和 NetworkImpressions 文件中。

	TimeUsec2	EventTimeUsec2	KeyPart	ImpressionId
NetworkRequests	1506934800	1506934800	abCdEFg123	--
NetworkCodeServes	--	--	--	--
NetworkImpressions	1506934800	1506934800	abCdEFg123	--

了解如何在每类文件中识别广告空缺的展示。

开始使用

您的数据传输设置并不会随这项更改自动更新。若要开始在数据传输中跟踪所有请求、代码调用和已投放广告的展示，必须完成下列步骤。

1. 更新数据传输设置。
   • 配置并启用新的请求事件记录文件和代码调用事件记录文件。
   • 将 ImpressionId 添加到展示事件记录文件和其他类型的文件包含的字段列表内。
2. 更新内部流程或自动化脚本，以便解析新的文件结构。

这会影响数据传输功能的使用费吗？
不会。我们会将新的请求事件记录文件和代码调用事件记录文件连同展示事件记录文件一起提供，但不会因此而收取任何额外的费用。