过滤

filters 查询字符串参数会限制 AdSense Management API 报告中返回的数据。使用 filters 参数时，您需要 提供过滤依据的维度，后接过滤器表达式。

过滤查询可限制要包含在结果中的行。每行 都针对过滤器进行测试：如果过滤器匹配，该行 保留，如果不匹配，则删除该行。

• 网址编码：客户端库会自动对 过滤器运算符。不过，如果你直接向协议提出请求 您必须对过滤器运算符进行明确编码，如下表所示。
• 过滤优先级：过滤先于 确保返回的指标只代表 相关维度的数据

过滤器语法

单个过滤条件使用以下格式：

name operator expression

在这一语法中：

• name - 过滤所依据的维度的名称。 例如：AD_CLIENT_ID 会按广告客户 ID 进行过滤。
• operator - 定义要使用的过滤器匹配的类型。
• expression - 说明要包含在结果中的值。

符合以下条件的所有维度： 所报告的指标可以用作过滤条件， 与日期相关的维度（DATE、WEEK、 和 MONTH）。要按日期过滤，请指定 日期范围。

过滤器操作符

有两种过滤器运算符。运算符必须经过网址编码，这样才能 包含在网址查询字符串中。

运算符	说明	网址编码格式	示例
==	完全匹配	%3D%3D	对国家/地区名称是“Canada”的指标进行汇总： filters=COUNTRY_NAME%3D%3DCanada
=@	包含子字符串	%3D@	国家/地区名称中包含“United”（此 与美国和英国匹配，例如： filters=COUNTRY_NAME%3D@United

过滤器表达式

过滤器表达式有一些重要的规则需要遵守：

• 网址预留字符 - 例如 & 必须按常规方式进行网址编码。客户端库 因此您只需要考虑编码问题 您将直接调用协议
• 预留字符：英文逗号和反斜杠必须 必须全部以反斜杠进行转义。
  • 反斜杠 \\
  • 逗号 \,

注意 ：务必在前面转义反斜杠， 以免重复转义。

合并过滤器

过滤条件可以使用 OR 和 AND 布尔值进行合并 逻辑。

OR 逻辑

OR 逻辑通过在, 过滤条件表达式。

AND 逻辑

AND 逻辑通过提供多个过滤器参数来实现， 这将转换为在客户端库中提供一系列过滤器。

合并 AND 和 OR 逻辑

您可以将 AND 和 OR 逻辑合并在同一个表达式中。

注意 ：系统会单独评估每个过滤器 ，然后再将所有过滤器合并到一个 AND 逻辑表达式中。

后续步骤

• 选择合适的维度
• 生成大型报告
• 指标和维度列表