Filtros

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.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
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.