过滤

filter查询字符串参数可限制AdSense Management API报告中返回的数据。使用filter参数时,您需要提供要过滤的维度,以及过滤器表达式。

过滤查询会限制要包含在结果中的行。结果中的每一行都要用过滤器进行测试:如果某行符合过滤器的条件,则保留该行;否则将删除该行。

  • 网址编码:客户端库会自动对过滤器运算符进行编码。但是,如果您直接向协议发出请求,那么您必须明确地对过滤器运算符进行编码,具体如下表所示。
  • 过滤优先级:过滤发生在汇总任何维度之前,因此返回的指标仅代表相关维度的总和。

过滤器语法

单个过滤器使用以下格式:

name operator expression

在此语法中:

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

过滤器运算符

过滤器运算符有两种。运算符必须采用网址编码,才能纳入网址查询字符串。

运算符 说明 网址编码格式 示例
== 完全匹配 %3D%3D 国家/地区名称是“Canada”时的汇总指标:
filter=COUNTRY_NAME%3D%3DCanada
=@ 包含子字符串 %3D@ 国家/地区名称包含“United”(例如“United States”和“United Kingdom”都是匹配情况)时的汇总指标:
filter=COUNTRY_NAME%3D@United

过滤器表达式

下面是过滤器表达式要遵守的几大规则:

  • 网址预留字符&等字符必须以常规方式进行网址编码。客户端库会替您完成编码,因此您只需在向协议发出直接调用时考虑此编码问题。
  • 预留字符:如果逗号和反斜杠出现在表达式中,那么必须加上反斜杠进行转义。
    • 反斜杠\\
    • 逗号\,

注意:请务必将转义反斜杠加在逗号前面,以避免重复转义。

合并过滤器

过滤器可以使用ORAND布尔值逻辑进行组合。

OR逻辑

OR逻辑通过在过滤器表达式中使用逗号(,)进行定义。

示例:(均须经过网址编码)

国家/地区代码是(US OR UK):
COUNTRY_CODE==US,COUNTRY_CODE==UK

AND逻辑

AND逻辑通过提供多个过滤器参数(会表达为在客户端库中提供一系列过滤器)实现。

示例:

国家/地区代码是US AND产品代码是AFC:
filter=COUNTRY_CODE%3D%3DUS&filter=PRODUCT_CODE%3D%3DAFC

合并AND和OR逻辑

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

注意:系统会对每个过滤器进行单独评估,然后才会将它们合并到一个AND逻辑表达式中。

示例:

国家/地区代码是(US OR UK) AND产品代码是AFC:
filter=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filter=PRODUCT_CODE%3D%3DAFC

后续步骤

发送以下问题的反馈:

此网页
AdSense Management API
AdSense Management API