常见误区

AdSense Management API 提供用于生成新的和已保存的报告的调用。这些报告可以包含简单的分析结果（例如每日收入），也可以包含非常复杂的表格，其中包含每个国家/地区每个自定义渠道的点击率。本指南介绍了一系列应正确处理的极端情况，以实现与 API 的强大集成。

报告结构

报告结果以 ReportResult 对象的形式返回。如需了解完整详细信息，请参阅报告响应参考文档。

使用按时间顺序的维度：DATE、WEEK 和 MONTH

报告可以为空或有缺漏

如果在请求中指定的时间段内没有任何活动，则系统不会生成广告请求，并且报告服务不会显示这些时间段内的行。绘制图表时，这一点很重要。

如需了解详情，请参阅日期填充指南。

在同一报告中请求 MONTH 和 WEEK 维度

该报告可能会造成负面或意想不到的后果。如果某一周属于两个不同的月份，则该周会显示两行，每行对应一个月份。

示例

维度指标开始日期结束日期
WEEK
MONTH		 CLICKS2014-04-28 2014-05-03
返回：
MONTHWEEK*CLICKS
2014-04 2014-04-27 50
2014-05 2014-04-27 43

* 一周的第一天

解决方案

从报告中移除“MONTH”。

WEEKCLICKS
2014-04-27 93

整理维度值

请求与平台（桌面设备、高端移动设备等）相关的维度时，将仅显示发生活动的平台。如果给定的日期、周或月没有来自高端移动设备的访问，则不会显示该类别的信息。

示例

维度指标开始日期结束日期
PLATFORM_TYPE_NAME
MONTH		 AD_REQUESTS 2014-02-012014-03-31
返回：
月PLATFORM_TYPE_NAMEAD_REQUESTS
2014-03 桌面版 100
2014-03 高端移动设备 5
2014-04 桌面版 75
解决方案

处理报告结果时，假定结果中未显示的所有维度值均为零：

月PLATFORM_TYPE_NAMEAD_REQUESTS
2014-03 桌面版 100
2014-03 高端移动设备 5
2014-04 桌面版 75
2014-04 高端移动设备 0

合并多个连续报告

有时，报告过大，无法一次性生成，必须进行批量处理。如果您的应用会执行此操作，请考虑以下情况：

  • 如果您使用的是 WEEK 或 MONTH 维度，并在一周或月中间对报告进行拆分，则每个报告都会包含包含不同数据的重复条目。
  • 确保所有报告都具有相同的指标和维度，因为使用不同的维度可能无法合并数据。

特殊账号

您的部分用户的 AdSense 帐号可能带有您意想不到或不了解的属性。请务必考虑以下因素：

  • 拥有数千个域名或网站的发布商
  • 拥有数千个广告单元或自定义渠道的发布商
  • 想要为多个广告客户（AdSense 搜索广告、AdSense 视频广告等）生成报告的发布商

多个账号

用户可以访问多个 AdSense 帐号。因此，每次调用该 API 时都必须指定帐号 ID。调用 accounts.list 会获取帐号列表，并且系统应向用户显示帐号选择器对话框。如果提取的帐号数为一个，则可以绕过该错误。

时区更改

AdSense 发布商可以随时更改时区，这可能会导致报告中出现高峰或低谷。如需了解详情，请参阅有关本地时区报告的指南。