Фильтры

В коллекции Filters описываются все ресурсы фильтра, которые могут применяться к представлению (профилю).

Список методов для этого ресурса приведен в конце страницы.

Представления ресурса

Шаблон для фильтра аккаунта 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 Идентификатор аккаунта, которому принадлежит фильтр.
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 Время создания этого фильтра.
excludeDetails nested object Сведения об исключающем фильтре (тип EXCLUDE).
excludeDetails.caseSensitive boolean Определяет, учитывает ли фильтр регистр символов. Можно редактировать
excludeDetails.expressionValue string Значение выражения фильтра. Можно редактировать
excludeDetails.field string Фильтруемое поле. Допустимые значения:
  • Контент и трафик:
    • PAGE_REQUEST_URI;
    • PAGE_HOSTNAME;
    • PAGE_TITLE;
    • REFERRAL;
    • COST_DATA_URI (целевой URL кампании);
    • 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_WITH, EQUAL, ENDS_WITH, CONTAINS, MATCHES. Фильтры GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI и PAGE_HOSTNAME могут использовать любой тип сопоставления, все остальные фильтры должны использовать MATCHES. Можно редактировать
id string Идентификатор фильтра.
includeDetails nested object Сведения о включающем фильтре (тип INCLUDE).
includeDetails.caseSensitive boolean Определяет, учитывает ли фильтр регистр символов. Можно редактировать
includeDetails.expressionValue string Значение выражения фильтра. Можно редактировать
includeDetails.field string Фильтруемое поле. Допустимые значения:
  • Контент и трафик:
    • PAGE_REQUEST_URI;
    • PAGE_HOSTNAME;
    • PAGE_TITLE;
    • REFERRAL;
    • COST_DATA_URI (целевой URL кампании);
    • 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_WITH, EQUAL, ENDS_WITH, CONTAINS, MATCHES. Фильтры GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI и PAGE_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
Обновляет существующий фильтр. Этот метод поддерживает семантику PATCH.
update
Обновляет существующий фильтр.