Filters

Коллекция Filters представляет собой набор ресурсов Filter, каждый из которых описывает фильтр, который можно применить к представлению (профилю).

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

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

Шаблон JSON для фильтра аккаунта Google Analytics.

{
  "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 Поле А. записываемый
advancedDetails. fieldAIndex integer Индекс специального параметра. Обязательно, если поле имеет значение CUSTOM_DIMENSION. записываемый
advancedDetails. fieldARequired boolean Указывает, требуется ли соответствие поля A. записываемый
advancedDetails. fieldB string Поле Б. записываемый
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 Детали для фильтра типа ИСКЛЮЧИТЬ.
excludeDetails. caseSensitive boolean Определяет, чувствителен ли фильтр к регистру. записываемый
excludeDetails. expressionValue string Значение выражения фильтра записываемый
excludeDetails. field string Поле для фильтрации. Возможные значения:
  • Контент и трафик
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • ЗАГОЛОВОК СТРАНИЦЫ,
    • НАПРАВЛЕНИЯ,
    • COST_DATA_URI (целевой URL-адрес кампании),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • ВНУТРЕННИЙ_ПОИСК_ТИП,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Кампания или группа объявлений
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • НАЗВАНИЕ КАМПАНИИ,
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH,
  • Электронная коммерция
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (Местоположение магазина или заказа),
    • ИМЯ ЭЛЕМЕНТА,
    • КОД ИЗДЕЛИЯ,
    • ITEM_VARIATION,
    • ID ТРАНЗАКЦИИ,
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Аудитория/Пользователи
    • БРАУЗЕР,
    • БРАУЗЕР_ВЕРСИЯ,
    • БРАУЗЕР_SIZE,
    • ПЛАТФОРМА,
    • ПЛАТФОРМА_ВЕРСИЯ,
    • ЯЗЫК,
    • РАЗРЕШЕНИЕ ЭКРАНА,
    • ЭКРАН_ЦВЕТА,
    • JAVA_ENABLED (логическое поле),
    • FLASH_VERSION,
    • GEO_SPEED (Скорость соединения),
    • ПОСЕТИТЕЛЬ_ТИП,
    • GEO_ORGANIZATION (организация интернет-провайдера),
    • ГЕО_ДОМЕН,
    • ГЕО_IP_АДРЕС,
    • ГЕО_IP_ВЕРСИЯ,
  • Расположение
    • ГЕО_СТРАНА,
    • ГЕО_РЕГИОН,
    • ГЕО_СИТИ,
  • Событие
    • EVENT_CATEGORY,
    • СОБЫТИЕ_АКЦИЯ,
    • EVENT_LABEL,
  • Другой
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • ПОЛЬЗОВАТЕЛЬ_ОПРЕДЕЛЕН_ЗНАЧЕНИЕ,
  • Приложение
    • ПРИЛОЖЕНИЕ_ИД,
    • APP_INSTALLER_ID,
    • ИМЯ ПРИЛОЖЕНИЯ,
    • ПРИЛОЖЕНИЕ_ВЕРСИЯ,
    • ЭКРАН,
    • IS_APP (логическое поле),
    • IS_FATAL_EXCEPTION (логическое поле),
    • ИСКЛЮЧЕНИЕ_ОПИСАНИЕ,
  • Мобильное устройство
    • IS_MOBILE (логическое поле, устарело. Используйте DEVICE_CATEGORY=mobile),
    • IS_TABLET (логическое поле, устарело. Используйте DEVICE_CATEGORY=таблетка),
    • УСТРОЙСТВО_КАТЕГОРИЯ,
    • MOBILE_HAS_QWERTY_KEYBOARD (логическое поле),
    • MOBILE_HAS_NFC_SUPPORT (логическое поле),
    • MOBILE_HAS_CELLULAR_RADIO (логическое поле),
    • MOBILE_HAS_WIFI_SUPPORT (логическое поле),
    • MOBILE_BRAND_NAME,
    • МОБИЛЬНАЯ_МОДЕЛЬ_ИМЯ,
    • МОБИЛЬНЫЙ_МАРКЕТИНГ_ИМЯ,
    • MOBILE_POINTING_METHOD,
  • Социальное
    • СОЦИАЛЬНАЯ СЕТЬ,
    • СОЦИАЛЬНОЕ_ДЕЙСТВИЕ,
    • 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,
    • ЗАГОЛОВОК СТРАНИЦЫ,
    • НАПРАВЛЕНИЯ,
    • COST_DATA_URI (целевой URL-адрес кампании),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • ВНУТРЕННИЙ_ПОИСК_ТИП,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Кампания или группа объявлений
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • НАЗВАНИЕ КАМПАНИИ,
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH,
  • Электронная коммерция
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (Местоположение магазина или заказа),
    • ИМЯ ЭЛЕМЕНТА,
    • КОД ИЗДЕЛИЯ,
    • ITEM_VARIATION,
    • ID ТРАНЗАКЦИИ,
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Аудитория/Пользователи
    • БРАУЗЕР,
    • БРАУЗЕР_ВЕРСИЯ,
    • БРАУЗЕР_SIZE,
    • ПЛАТФОРМА,
    • ПЛАТФОРМА_ВЕРСИЯ,
    • ЯЗЫК,
    • РАЗРЕШЕНИЕ ЭКРАНА,
    • ЭКРАН_ЦВЕТА,
    • JAVA_ENABLED (логическое поле),
    • FLASH_VERSION,
    • GEO_SPEED (Скорость соединения),
    • ПОСЕТИТЕЛЬ_ТИП,
    • GEO_ORGANIZATION (организация интернет-провайдера),
    • ГЕО_ДОМЕН,
    • ГЕО_IP_АДРЕС,
    • ГЕО_IP_ВЕРСИЯ,
  • Расположение
    • ГЕО_СТРАНА,
    • ГЕО_РЕГИОН,
    • ГЕО_СИТИ,
  • Событие
    • EVENT_CATEGORY,
    • СОБЫТИЕ_АКЦИЯ,
    • EVENT_LABEL,
  • Другой
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • ПОЛЬЗОВАТЕЛЬ_ОПРЕДЕЛЕН_ЗНАЧЕНИЕ,
  • Приложение
    • ПРИЛОЖЕНИЕ_ИД,
    • APP_INSTALLER_ID,
    • ИМЯ ПРИЛОЖЕНИЯ,
    • ПРИЛОЖЕНИЕ_ВЕРСИЯ,
    • ЭКРАН,
    • IS_APP (логическое поле),
    • IS_FATAL_EXCEPTION (логическое поле),
    • ИСКЛЮЧЕНИЕ_ОПИСАНИЕ,
  • Мобильное устройство
    • IS_MOBILE (логическое поле, устарело. Используйте DEVICE_CATEGORY=mobile),
    • IS_TABLET (логическое поле, устарело. Используйте DEVICE_CATEGORY=таблетка),
    • УСТРОЙСТВО_КАТЕГОРИЯ,
    • MOBILE_HAS_QWERTY_KEYBOARD (логическое поле),
    • MOBILE_HAS_NFC_SUPPORT (логическое поле),
    • MOBILE_HAS_CELLULAR_RADIO (логическое поле),
    • MOBILE_HAS_WIFI_SUPPORT (логическое поле),
    • MOBILE_BRAND_NAME,
    • МОБИЛЬНАЯ_МОДЕЛЬ_ИМЯ,
    • МОБИЛЬНЫЙ_МАРКЕТИНГ_ИМЯ,
    • MOBILE_POINTING_METHOD,
  • Социальное
    • СОЦИАЛЬНАЯ СЕТЬ,
    • СОЦИАЛЬНОЕ_ДЕЙСТВИЕ,
    • 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 Детали для фильтра типа НИЖНИЙ.
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 Детали для фильтра типа ВЕРХНИЙ.
uppercaseDetails. field string Поле для использования в фильтре. записываемый
uppercaseDetails. fieldIndex integer Индекс специального параметра. Обязательно, если поле имеет значение CUSTOM_DIMENSION. записываемый

Методы

удалить
Удалить фильтр.
получать
Возвращает фильтры, к которым у пользователя есть доступ.
вставлять
Создайте новый фильтр.
список
Перечисляет все фильтры для учетной записи.
пластырь
Обновляет существующий фильтр. Этот метод поддерживает семантику исправлений.
обновлять
Обновляет существующий фильтр.