Filtros | API de administración de Analytics

La colección Filtros es un conjunto de recursos Filtro y cada uno describe un filtro que se puede aplicar a una vista (perfil).

Al final de esta página encontrarás la lista de los métodos que se utilizan para este recurso.

Representaciones de recurso

Plantilla JSON para un filtro de cuenta de 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
  }
}

Nombre de propiedad	Valor	Descripción	Notas
`accountId`	`string`	ID de cuenta al que pertenece este filtro.
`advancedDetails`	`object`	Detalles del filtro del tipo ADVANCED.
`advancedDetails.caseSensitive`	`boolean`	Indica si en las expresiones de filtro se distingue entre mayúsculas y minúsculas.	editable
`advancedDetails.extractA`	`string`	Expresión que se extraerá del campo A.	editable
`advancedDetails.extractB`	`string`	Expresión que se extraerá del campo B.	editable
`advancedDetails.fieldA`	`string`	Campo A.	editable
`advancedDetails.fieldAIndex`	`integer`	Índice de la dimensión personalizada. Es obligatoria si el campo es CUSTOM_DIMENSION.	editable
`advancedDetails.fieldARequired`	`boolean`	Indica si es obligatorio que coincida el campo A.	editable
`advancedDetails.fieldB`	`string`	Campo B.	editable
`advancedDetails.fieldBIndex`	`integer`	Índice de la dimensión personalizada. Es obligatoria si el campo es CUSTOM_DIMENSION.	editable
`advancedDetails.fieldBRequired`	`boolean`	Indica si es obligatorio que coincida el campo B.	editable
`advancedDetails.outputConstructor`	`string`	Expresión usada para construir el valor de salida.	editable
`advancedDetails.outputToField`	`string`	Campo de salida.	editable
`advancedDetails.outputToFieldIndex`	`integer`	Índice de la dimensión personalizada. Es obligatoria si el campo es CUSTOM_DIMENSION.	editable
`advancedDetails.overrideOutputField`	`boolean`	Indica si la expresión de salida debe anular el valor del campo de salida, si hay alguno.	editable
`created`	`datetime`	Hora a la que se creó este filtro.
`excludeDetails`	`nested object`	Detalles del filtro del tipo EXCLUDE.
`excludeDetails.caseSensitive`	`boolean`	Determina si en el filtro se distingue entre mayúsculas y minúsculas.	editable
`excludeDetails.expressionValue`	`string`	Valor de expresión de filtro.	editable
`excludeDetails.field`	`string`	Campo que se filtrará. Valores posibles: Contenido y tráfico PAGE_REQUEST_URI, PAGE_HOSTNAME, PAGE_TITLE, REFERRAL, COST_DATA_URI (URL de destino de la campaña), HIT_TYPE, INTERNAL_SEARCH_TERM, INTERNAL_SEARCH_TYPE, SOURCE_PROPERTY_TRACKING_ID, Campaña o grupo de anuncios CAMPAIGN_SOURCE, CAMPAIGN_MEDIUM, CAMPAIGN_NAME, CAMPAIGN_AD_GROUP, CAMPAIGN_TERM, CAMPAIGN_CONTENT, CAMPAIGN_CODE, CAMPAIGN_REFERRAL_PATH, Comercio electrónico TRANSACTION_COUNTRY, TRANSACTION_REGION, TRANSACTION_CITY, TRANSACTION_AFFILIATION (ubicación de la tienda o del pedido), ITEM_NAME, ITEM_CODE, ITEM_VARIATION, TRANSACTION_ID, TRANSACTION_CURRENCY_CODE, PRODUCT_ACTION_TYPE, Audiencia/usuarios BROWSER, BROWSER_VERSION, BROWSER_SIZE, PLATFORM, PLATFORM_VERSION, LANGUAGE, SCREEN_RESOLUTION, SCREEN_COLORS, JAVA_ENABLED (campo booleano), FLASH_VERSION, GEO_SPEED (velocidad de conexión), VISITOR_TYPE, GEO_ORGANIZATION (organización del ISP), GEO_DOMAIN, GEO_IP_ADDRESS, GEO_IP_VERSION, Ubicación GEO_COUNTRY, GEO_REGION, GEO_CITY, Evento EVENT_CATEGORY, EVENT_ACTION, EVENT_LABEL, Otros CUSTOM_FIELD_1, CUSTOM_FIELD_2, USER_DEFINED_VALUE, Aplicación APP_ID, APP_INSTALLER_ID, APP_NAME, APP_VERSION, SCREEN, IS_APP (campo booleano), IS_FATAL_EXCEPTION (campo booleano), EXCEPTION_DESCRIPTION, Dispositivo móvil IS_MOBILE (campo booleano, obsoleto; utiliza DEVICE_CATEGORY=mobile), IS_TABLET (campo booleano, obsoleto; utiliza DEVICE_CATEGORY=tablet), DEVICE_CATEGORY, MOBILE_HAS_QWERTY_KEYBOARD (campo booleano), MOBILE_HAS_NFC_SUPPORT (campo booleano), MOBILE_HAS_CELLULAR_RADIO (campo booleano), MOBILE_HAS_WIFI_SUPPORT (campo booleano), MOBILE_BRAND_NAME, MOBILE_MODEL_NAME, MOBILE_MARKETING_NAME, MOBILE_POINTING_METHOD, Redes sociales SOCIAL_NETWORK, SOCIAL_ACTION, SOCIAL_ACTION_TARGET,	editable
`excludeDetails.fieldIndex`	`integer`	Índice de la dimensión personalizada. Configúrala solo si el campo es CUSTOM_DIMENSION.	editable
`excludeDetails.kind`	`string`	Valor de tipo de la expresión de filtro.
`excludeDetails.matchType`	`string`	Tipo de concordancia de este filtro. Los valores posibles son: `BEGINS_WITH`, `EQUAL`, `ENDS_WITH`, `CONTAINS` o `MATCHES`. Los filtros `GEO_DOMAIN`, `GEO_IP_ADDRESS`, `PAGE_REQUEST_URI` o `PAGE_HOSTNAME` pueden usar cualquier tipo de concordancia; los demás filtros deben usar `MATCHES`.	editable
`id`	`string`	ID de filtro.
`includeDetails`	`nested object`	Detalles del filtro del tipo INCLUDE.
`includeDetails.caseSensitive`	`boolean`	Determina si en el filtro se distingue entre mayúsculas y minúsculas.	editable
`includeDetails.expressionValue`	`string`	Valor de expresión de filtro.	editable
`includeDetails.field`	`string`	Campo que se filtrará. Valores posibles: Contenido y tráfico PAGE_REQUEST_URI, PAGE_HOSTNAME, PAGE_TITLE, REFERRAL, COST_DATA_URI (URL de destino de la campaña), HIT_TYPE, INTERNAL_SEARCH_TERM, INTERNAL_SEARCH_TYPE, SOURCE_PROPERTY_TRACKING_ID, Campaña o grupo de anuncios CAMPAIGN_SOURCE, CAMPAIGN_MEDIUM, CAMPAIGN_NAME, CAMPAIGN_AD_GROUP, CAMPAIGN_TERM, CAMPAIGN_CONTENT, CAMPAIGN_CODE, CAMPAIGN_REFERRAL_PATH, Comercio electrónico TRANSACTION_COUNTRY, TRANSACTION_REGION, TRANSACTION_CITY, TRANSACTION_AFFILIATION (ubicación de la tienda o del pedido), ITEM_NAME, ITEM_CODE, ITEM_VARIATION, TRANSACTION_ID, TRANSACTION_CURRENCY_CODE, PRODUCT_ACTION_TYPE, Audiencia/usuarios BROWSER, BROWSER_VERSION, BROWSER_SIZE, PLATFORM, PLATFORM_VERSION, LANGUAGE, SCREEN_RESOLUTION, SCREEN_COLORS, JAVA_ENABLED (campo booleano), FLASH_VERSION, GEO_SPEED (velocidad de conexión), VISITOR_TYPE, GEO_ORGANIZATION (organización del ISP), GEO_DOMAIN, GEO_IP_ADDRESS, GEO_IP_VERSION, Ubicación GEO_COUNTRY, GEO_REGION, GEO_CITY, Evento EVENT_CATEGORY, EVENT_ACTION, EVENT_LABEL, Otros CUSTOM_FIELD_1, CUSTOM_FIELD_2, USER_DEFINED_VALUE, Aplicación APP_ID, APP_INSTALLER_ID, APP_NAME, APP_VERSION, SCREEN, IS_APP (campo booleano), IS_FATAL_EXCEPTION (campo booleano), EXCEPTION_DESCRIPTION, Dispositivo móvil IS_MOBILE (campo booleano, obsoleto; utiliza DEVICE_CATEGORY=mobile), IS_TABLET (campo booleano, obsoleto; utiliza DEVICE_CATEGORY=tablet), DEVICE_CATEGORY, MOBILE_HAS_QWERTY_KEYBOARD (campo booleano), MOBILE_HAS_NFC_SUPPORT (campo booleano), MOBILE_HAS_CELLULAR_RADIO (campo booleano), MOBILE_HAS_WIFI_SUPPORT (campo booleano), MOBILE_BRAND_NAME, MOBILE_MODEL_NAME, MOBILE_MARKETING_NAME, MOBILE_POINTING_METHOD, Redes sociales SOCIAL_NETWORK, SOCIAL_ACTION, SOCIAL_ACTION_TARGET,	editable
`includeDetails.fieldIndex`	`integer`	Índice de la dimensión personalizada. Configúrala solo si el campo es CUSTOM_DIMENSION.	editable
`includeDetails.kind`	`string`	Valor de tipo de la expresión de filtro.
`includeDetails.matchType`	`string`	Tipo de concordancia de este filtro. Los valores posibles son: `BEGINS_WITH`, `EQUAL`, `ENDS_WITH`, `CONTAINS` o `MATCHES`. Los filtros `GEO_DOMAIN`, `GEO_IP_ADDRESS`, `PAGE_REQUEST_URI` o `PAGE_HOSTNAME` pueden usar cualquier tipo de concordancia; los demás filtros deben usar `MATCHES`.	editable
`kind`	`string`	Tipo de recurso del filtro de Analytics.
`lowercaseDetails`	`object`	Detalles del filtro del tipo LOWER.
`lowercaseDetails.field`	`string`	Campo que se utilizará en el filtro.	editable
`lowercaseDetails.fieldIndex`	`integer`	Índice de la dimensión personalizada. Es obligatoria si el campo es CUSTOM_DIMENSION.	editable
`name`	`string`	Nombre de este filtro.	editable
`parentLink`	`object`	Enlace principal de este filtro. Apunta a la cuenta a la que pertenece este
`parentLink.href`	`string`	Enlace a la cuenta a la que pertenece este filtro.
`parentLink.type`	`string`	El valor e"analytics#account".
`searchAndReplaceDetails`	`object`	Detalles del filtro del tipo SEARCH_AND_REPLACE.
`searchAndReplaceDetails.caseSensitive`	`boolean`	Determina si en el filtro se distingue entre mayúsculas y minúsculas.	editable
`searchAndReplaceDetails.field`	`string`	Campo que se utilizará en el filtro.	editable
`searchAndReplaceDetails.fieldIndex`	`integer`	Índice de la dimensión personalizada. Es obligatoria si el campo es CUSTOM_DIMENSION.	editable
`searchAndReplaceDetails.replaceString`	`string`	Término con el que se reemplazará el término de búsqueda.	editable
`searchAndReplaceDetails.searchString`	`string`	Término que se buscará.	editable
`selfLink`	`string`	Enlace de este filtro.
`type`	`string`	Tipo de este filtro. Los valores posibles son INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE y ADVANCED.	editable
`updated`	`datetime`	Hora a la que se modificó este filtro por última vez.
`uppercaseDetails`	`object`	Detalles del filtro del tipo UPPER.
`uppercaseDetails.field`	`string`	Campo que se utilizará en el filtro.	editable
`uppercaseDetails.fieldIndex`	`integer`	Índice de la dimensión personalizada. Es obligatoria si el campo es CUSTOM_DIMENSION.	editable

Métodos

delete: Suprimir un filtro.
get: Devuelve un filtro al que el usuario tiene acceso.
insert: Crea un filtro nuevo.
list: Enumera todos los filtros de una cuenta.
patch: Actualiza un filtro. Este método es compatible con la semántica de parches.
update: Actualiza un filtro.