Filters

篩選器集合是一組篩選器資源，每個資源都用來說明可套用至資料檢視 (設定檔) 的篩選器。

如需本資源的方法清單，請見本頁結尾。

資源表示法

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 「進階」類型篩選器的詳細資料。
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 這個篩選器的建立時間。
excludeDetails nested object EXCLUDE 類型篩選器的詳細資料。
excludeDetails.caseSensitive boolean 決定篩選器是否區分大小寫。 可寫入
excludeDetails.expressionValue string 篩選運算式值 可寫入
excludeDetails.field string 要篩選的欄位。可能的值：
  • 內容與流量
    • PAGE_REQUEST_URI、
    • PAGE_HOSTNAME、
    • PAGE_TITLE、
    • 轉問：
    • 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_VERSION、
    • LANGUAGE，
    • SCREEN_RESOLUTION，
    • SCREEN_COLORS，
    • JAVA_ENABLED (布林值欄位)，
    • FLASH_VERSION、
    • GEO_SPEED (連線速度)、
    • VISITOR_TYPE、
    • GEO_organization (ISP 機構)，
    • 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、
    • 螢幕
    • IS_APP (布林值欄位)，
    • IS_FATAL_EXCEPTION (布林值欄位)，
    • EXCEPTION_DESCRIPTION，
  • 行動裝置
    • IS_MOBILE (布林值欄位，已淘汰。使用 DEVICE_CATEGORY=手機)，
    • IS_TABLET (布林值欄位，已淘汰。使用 DEVICE_CATEGORY=平板電腦)，
    • 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_WITH、EQUAL、ENDS_WITH、CONTAINS 或 MATCHES。GEO_DOMAIN、GEO_IP_ADDRESS、PAGE_REQUEST_URI 或 PAGE_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、
    • 轉問：
    • 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_VERSION、
    • LANGUAGE，
    • SCREEN_RESOLUTION，
    • SCREEN_COLORS，
    • JAVA_ENABLED (布林值欄位)，
    • FLASH_VERSION、
    • GEO_SPEED (連線速度)、
    • VISITOR_TYPE、
    • GEO_organization (ISP 機構)，
    • 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、
    • 螢幕
    • IS_APP (布林值欄位)，
    • IS_FATAL_EXCEPTION (布林值欄位)，
    • EXCEPTION_DESCRIPTION，
  • 行動裝置
    • IS_MOBILE (布林值欄位，已淘汰。使用 DEVICE_CATEGORY=手機)，
    • IS_TABLET (布林值欄位，已淘汰。使用 DEVICE_CATEGORY=平板電腦)，
    • 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_WITH、EQUAL、ENDS_WITH、CONTAINS 或 MATCHES。GEO_DOMAIN、GEO_IP_ADDRESS、PAGE_REQUEST_URI 或 PAGE_HOSTNAME 篩選器可以使用任何比對類型；其他篩選器都必須使用 MATCHES。 可寫入
kind string 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 的欄位，則為必填欄位。 可寫入

方法

刪除
刪除篩選器。
get
傳回使用者有權存取的篩選器。
插入
建立新篩選器。
list
列出帳戶的所有篩選器
修補程式
更新現有的篩選器。這個方法可支援 patch 語意。
更新
更新現有的篩選器。