Filters

La colección Filters es un conjunto de recursos de Filter, cada uno de los cuales describe un filtro que se puede aplicar a una vista (perfil).

Si quieres ver una lista de los métodos para este recurso, consulta la sección final de esta página.

Representaciones de recursos

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 la propiedad Valor Descripción Notas
accountId string ID de la cuenta a la que pertenece este filtro
advancedDetails object Detalles del filtro del tipo AVANZADO.
advancedDetails.caseSensitive boolean Indica si las expresiones de filtro distinguen mayúsculas de minúsculas. admite escritura
advancedDetails.extractA string Expresión para extraer del campo A. admite escritura
advancedDetails.extractB string Expresión para extraer del campo B. admite escritura
advancedDetails.fieldA string Campo A. admite escritura
advancedDetails.fieldAIndex integer El índice de la dimensión personalizada. Obligatorio si el campo es CUSTOM_DIMENSION. admite escritura
advancedDetails.fieldARequired boolean Indica si debe coincidir el campo A. admite escritura
advancedDetails.fieldB string Campo B. admite escritura
advancedDetails.fieldBIndex integer El índice de la dimensión personalizada. Obligatorio si el campo es CUSTOM_DIMENSION. admite escritura
advancedDetails.fieldBRequired boolean Indica si se requiere que el campo B coincida. admite escritura
advancedDetails.outputConstructor string Expresión que se usa para construir el valor de salida. admite escritura
advancedDetails.outputToField string Campo de salida. admite escritura
advancedDetails.outputToFieldIndex integer El índice de la dimensión personalizada. Obligatorio si el campo es CUSTOM_DIMENSION. admite escritura
advancedDetails.overrideOutputField boolean Indica si la expresión de salida debe anular el valor existente del campo de salida, si existe. admite escritura
created datetime Hora en la que se creó este filtro.
excludeDetails nested object Detalles del filtro del tipo EXCLUIR.
excludeDetails.caseSensitive boolean Determina si el filtro distingue mayúsculas de minúsculas. admite escritura
excludeDetails.expressionValue string Valor de la expresión de filtro admite escritura
excludeDetails.field string Campo que se filtrará. Valores posibles:
  • Contenido y tráfico
    • PAGE_REQUEST_URI
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • REFERENCIA,
    • 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,
    • CAMPAÑA_MEDIUM,
    • CAMPAIGN_NAME:
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • RUTA_DE_REFERENCIA_DE_CAMPAÑA,
  • Comercio electrónico
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (ubicación de la tienda o del pedido)
    • ITEM_NAME:
    • ITEM_CODE,
    • VARIACIÓN DE ARTÍCULOS
    • TRANSACTION_ID
    • TRANSACTION_CURRENCY_CODE
    • PRODUCT_ACTION_TYPE,
  • Público/usuarios
    • NAVEGADOR,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PLATAFORMA,
    • PLATFORM_VERSION,
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_HOURS (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,
  • Otro
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Aplicación
    • APP_ID
    • APP_INSTALLER_ID,
    • APP_NAME
    • APP_VERSION
    • PANTALLA,
    • IS_APP (campo booleano),
    • IS_FATAL_EXCEPTION (campo booleano),
    • EXCEPTION_DESCRIPTION,
  • Dispositivo móvil
    • IS_MOBILE (campo booleano, dejó de estar disponible; Utiliza DEVICE_CATEGORY=mobile),
    • IS_TABLET (campo booleano, dejó de estar disponible; usar 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,
  • Social
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
admite escritura
excludeDetails.fieldIndex integer El índice de la dimensión personalizada. Se establece solo si el campo es CUSTOM_DIMENSION. admite escritura
excludeDetails.kind string Valor de tipo para 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; todos los demás filtros deben usar MATCHES. admite escritura
id string ID de filtro.
includeDetails nested object Detalles del filtro del tipo INCLUDE.
includeDetails.caseSensitive boolean Determina si el filtro distingue mayúsculas de minúsculas. admite escritura
includeDetails.expressionValue string Valor de la expresión de filtro admite escritura
includeDetails.field string Campo que se filtrará. Valores posibles:
  • Contenido y tráfico
    • PAGE_REQUEST_URI
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • REFERENCIA,
    • 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,
    • CAMPAÑA_MEDIUM,
    • CAMPAIGN_NAME:
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • RUTA_DE_REFERENCIA_DE_CAMPAÑA,
  • Comercio electrónico
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (ubicación de la tienda o del pedido)
    • ITEM_NAME:
    • ITEM_CODE,
    • VARIACIÓN DE ARTÍCULOS
    • TRANSACTION_ID
    • TRANSACTION_CURRENCY_CODE
    • PRODUCT_ACTION_TYPE,
  • Público/usuarios
    • NAVEGADOR,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PLATAFORMA,
    • PLATFORM_VERSION,
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_HOURS (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,
  • Otro
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Aplicación
    • APP_ID
    • APP_INSTALLER_ID,
    • APP_NAME
    • APP_VERSION
    • PANTALLA,
    • IS_APP (campo booleano),
    • IS_FATAL_EXCEPTION (campo booleano),
    • EXCEPTION_DESCRIPTION,
  • Dispositivo móvil
    • IS_MOBILE (campo booleano, dejó de estar disponible; Utiliza DEVICE_CATEGORY=mobile),
    • IS_TABLET (campo booleano, dejó de estar disponible; usar 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,
  • Social
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
admite escritura
includeDetails.fieldIndex integer El índice de la dimensión personalizada. Se establece solo si el campo es CUSTOM_DIMENSION. admite escritura
includeDetails.kind string Valor de tipo para 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; todos los demás filtros deben usar MATCHES. admite escritura
kind string Tipo de recurso del filtro de Analytics.
lowercaseDetails object Detalles del filtro del tipo LOWER.
lowercaseDetails.field string Es el campo que se usará en el filtro. admite escritura
lowercaseDetails.fieldIndex integer El índice de la dimensión personalizada. Obligatorio si el campo es CUSTOM_DIMENSION. admite escritura
name string Es el nombre de este filtro. admite escritura
parentLink.href string Vínculo a la cuenta a la que pertenece este filtro.
parentLink.type string El valor es "analytics#account".
searchAndReplaceDetails object Detalles del filtro del tipo SEARCH_AND_REPLACE.
searchAndReplaceDetails.caseSensitive boolean Determina si el filtro distingue mayúsculas de minúsculas. admite escritura
searchAndReplaceDetails.field string Es el campo que se usará en el filtro. admite escritura
searchAndReplaceDetails.fieldIndex integer El índice de la dimensión personalizada. Obligatorio si el campo es CUSTOM_DIMENSION. admite escritura
searchAndReplaceDetails.replaceString string Término con el que se reemplazará el término de búsqueda. admite escritura
searchAndReplaceDetails.searchString string Término para buscar. admite escritura
type string Es el tipo de este filtro. Los valores posibles son INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE y ADVANCED. admite escritura
updated datetime Hora en la que se modificó este filtro por última vez.
uppercaseDetails object Detalles del filtro del tipo UPPER.
uppercaseDetails.field string Es el campo que se usará en el filtro. admite escritura
uppercaseDetails.fieldIndex integer El índice de la dimensión personalizada. Obligatorio si el campo es CUSTOM_DIMENSION. admite escritura

Métodos

borrar
Borra un filtro.
get
Muestra los filtros a los que el usuario tiene acceso.
insertar
Crea un filtro nuevo.
list
Enumera todos los filtros de una cuenta
patch
Actualiza un filtro existente. Este método es compatible con la semántica de parches.
actualizar
Actualiza un filtro existente.