过滤器

“过滤器”集合是一组“过滤器”资源,其中每个资源都描述了一个可应用于数据视图(配置文件)的过滤器。

有关此类资源的方法列表,请参阅本页面的结尾部分。

资源表示形式

用于 Google Analytics(分析)帐户过滤器的 JSON 模板。

{
  "id": string,
  "kind": "analytics#filter",
  "selfLink": string,
  "accountId": string,
  "name": string,
  "type": string,
  "created": datetime,
  "updated": datetime,
  "parentLink": {
    "type": "analytics#account",
    "href": string
  },
  "includeDetails": {
    "kind": "analytics#filterExpression",
    "field": string,
    "matchType": string,
    "expressionValue": string,
    "caseSensitive": boolean,
    "fieldIndex": integer
  },
  "excludeDetails": {
    "kind": "analytics#filterExpression",
    "field": string,
    "matchType": string,
    "expressionValue": string,
    "caseSensitive": boolean,
    "fieldIndex": integer
  },
  "lowercaseDetails": {
    "field": string,
    "fieldIndex": integer
  },
  "uppercaseDetails": {
    "field": string,
    "fieldIndex": integer
  },
  "searchAndReplaceDetails": {
    "field": string,
    "fieldIndex": integer,
    "searchString": string,
    "replaceString": string,
    "caseSensitive": boolean
  },
  "advancedDetails": {
    "fieldA": string,
    "fieldAIndex": integer,
    "extractA": string,
    "fieldB": string,
    "fieldBIndex": integer,
    "extractB": string,
    "outputToField": string,
    "outputToFieldIndex": integer,
    "outputConstructor": string,
    "fieldARequired": boolean,
    "fieldBRequired": boolean,
    "overrideOutputField": boolean,
    "caseSensitive": boolean
  }
}
属性名称 说明 备注
accountId string 此过滤器所属的帐户 ID。
advancedDetails object 类型为 ADVANCED 的过滤器的详情。
advancedDetails.caseSensitive boolean 指明过滤器表达式是否区分大小写。 可写入
advancedDetails.extractA string 要从字段 A 中提取的表达式。 可写入
advancedDetails.extractB string 要从字段 B 中提取的表达式。 可写入
advancedDetails.fieldA string 字段 A。 可写入
advancedDetails.fieldAIndex integer 自定义维度的索引。在字段为 CUSTOM_DIMENSION 时必须提供。 可写入
advancedDetails.fieldARequired boolean 指明是否必须匹配字段 A。 可写入
advancedDetails.fieldB string 字段 B。 可写入
advancedDetails.fieldBIndex integer 自定义维度的索引。在字段为 CUSTOM_DIMENSION 时必须提供。 可写入
advancedDetails.fieldBRequired boolean 指明是否必须匹配字段 B。 可写入
advancedDetails.outputConstructor string 用于构造输出值的表达式。 可写入
advancedDetails.outputToField string 输出字段。 可写入
advancedDetails.outputToFieldIndex integer 自定义维度的索引。在字段为 CUSTOM_DIMENSION 时必须提供。 可写入
advancedDetails.overrideOutputField boolean 指明是否应该用输出表达式覆盖输出字段的现有值。 可写入
created datetime 过滤器的创建时间。was created.
excludeDetails nested object 类型为 EXCLUDE 的过滤器的详情。
excludeDetails.caseSensitive boolean 确定过滤器是否区分大小写。 可写入
excludeDetails.expressionValue string 过滤器表达式的值 可写入
excludeDetails.field string 要放入过滤器中的字段。可能的值有:
  • 内容和流量
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • REFERRAL,
    • COST_DATA_URI(广告系列目标网址),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • 广告系列或广告组
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME,
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH,
  • 电子商务
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION(商店或订购位置)
    • ITEM_NAME,
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • 受众群体/用户
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PLATFORM,
    • PLATFORM_VERSION,
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED(布尔值字段),
    • FLASH_VERSION,
    • GEO_SPEED(连接速度),
    • VISITOR_TYPE,
    • GEO_ORGANIZATION(互联网服务提供商),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • 地理位置
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • 事件
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • 其他
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • 应用
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • SCREEN,
    • IS_APP(布尔值字段),
    • IS_FATAL_EXCEPTION(布尔值字段),
    • EXCEPTION_DESCRIPTION,
  • 移动设备
    • IS_MOBILE(布尔值字段,已弃用。请使用 DEVICE_CATEGORY=mobile),
    • IS_TABLET(布尔值字段,已弃用。请使用 DEVICE_CATEGORY=tablet),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBOARD(布尔值字段),
    • MOBILE_HAS_NFC_SUPPORT(布尔值字段),
    • MOBILE_HAS_CELLULAR_RADIO(布尔值字段),
    • MOBILE_HAS_WIFI_SUPPORT(布尔值字段),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • 社交
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
可写入
excludeDetails.fieldIndex integer 自定义维度的索引。仅在字段为 CUSTOM_DIMENSION 时设置。 可写入
excludeDetails.kind string 过滤器表达式的类型值
excludeDetails.matchType string 此过滤器的匹配类型。可能的值有 BEGINS_WITHEQUALENDS_WITHCONTAINSMATCHESGEO_DOMAINGEO_IP_ADDRESSPAGE_REQUEST_URIPAGE_HOSTNAME 过滤器可以使用任何匹配类型,所有其他过滤器必须使用 MATCHES 可写入
id string 过滤器 ID。
includeDetails nested object 类型为 INCLUDE 的过滤器的详情。
includeDetails.caseSensitive boolean 确定过滤器是否区分大小写。 可写入
includeDetails.expressionValue string 过滤器表达式的值 可写入
includeDetails.field string 要放入过滤器中的字段。可能的值有:
  • 内容和流量
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • REFERRAL,
    • COST_DATA_URI(广告系列目标网址),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • 广告系列或广告组
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME,
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH,
  • 电子商务
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION(商店或订购位置)
    • ITEM_NAME,
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • 受众群体/用户
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PLATFORM,
    • PLATFORM_VERSION,
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED(布尔值字段),
    • FLASH_VERSION,
    • GEO_SPEED(连接速度),
    • VISITOR_TYPE,
    • GEO_ORGANIZATION(互联网服务提供商),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • 地理位置
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • 事件
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • 其他
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • 应用
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • SCREEN,
    • IS_APP(布尔值字段),
    • IS_FATAL_EXCEPTION(布尔值字段),
    • EXCEPTION_DESCRIPTION,
  • 移动设备
    • IS_MOBILE(布尔值字段,已弃用。请使用 DEVICE_CATEGORY=mobile),
    • IS_TABLET(布尔值字段,已弃用。请使用 DEVICE_CATEGORY=tablet),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBOARD(布尔值字段),
    • MOBILE_HAS_NFC_SUPPORT(布尔值字段),
    • MOBILE_HAS_CELLULAR_RADIO(布尔值字段),
    • MOBILE_HAS_WIFI_SUPPORT(布尔值字段),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • 社交
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
可写入
includeDetails.fieldIndex integer 自定义维度的索引。仅在字段为 CUSTOM_DIMENSION 时设置。 可写入
includeDetails.kind string 过滤器表达式的类型值
includeDetails.matchType string 此过滤器的匹配类型。可能的值有 BEGINS_WITHEQUALENDS_WITHCONTAINSMATCHESGEO_DOMAINGEO_IP_ADDRESSPAGE_REQUEST_URIPAGE_HOSTNAME 过滤器可以使用任何匹配类型,所有其他过滤器必须使用 MATCHES 可写入
kind string 用于 Google Analytics(分析)过滤器的资源类型。
lowercaseDetails object 类型为 LOWER 的过滤器的详情。
lowercaseDetails.field string 要在过滤器中使用的字段。 可写入
lowercaseDetails.fieldIndex integer 自定义维度的索引。在字段为 CUSTOM_DIMENSION 时必须提供。 可写入
name string 过滤器的名称。 可写入
parentLink.href string 链接到过滤器所属的帐户。
parentLink.type string 其值为“analytics#account”。
searchAndReplaceDetails object 类型为 SEARCH_AND_REPLACE 的过滤器的详情。
searchAndReplaceDetails.caseSensitive boolean 确定过滤器是否区分大小写。 可写入
searchAndReplaceDetails.field string 要在过滤器中使用的字段。 可写入
searchAndReplaceDetails.fieldIndex integer 自定义维度的索引。在字段为 CUSTOM_DIMENSION 时必须提供。 可写入
searchAndReplaceDetails.replaceString string 要用来替换搜索字词的字词。 可写入
searchAndReplaceDetails.searchString string 要搜索的字词。 可写入
type string 此过滤器的类型。可能的值包括 INCLUDE、EXCLUDE、LOWERCASE、UPPERCASE、SEARCH_AND_REPLACE 和 ADVANCED。 可写入
updated datetime 此过滤器的最后修改时间。
uppercaseDetails object 类型为 UPPER 的过滤器的详情。
uppercaseDetails.field string 要在过滤器中使用的字段。 可写入
uppercaseDetails.fieldIndex integer 自定义维度的索引。在字段为 CUSTOM_DIMENSION 时必须提供。 可写入

方法

delete
删除一个过滤器。
get
返回用户有访问权限的一个过滤器。
insert
创建一个新过滤器。
list
列出帐户的所有过滤器
patch
更新现有过滤器。此方法支持修补语义。
update
更新现有过滤器。