Filters

La raccolta Filtri è un insieme di risorse di filtro, ciascuna delle quali descrive un filtro che può essere applicato a una vista (profilo).

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Modello JSON per un filtro di account 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
  }
}
Nome proprietà Valore Descrizione Note
accountId string ID account a cui appartiene questo filtro.
advancedDetails object Dettagli per il filtro del tipo AVANZATO.
advancedDetails.caseSensitive boolean Indica se le espressioni di filtro sono sensibili alle maiuscole. scrivibile
advancedDetails.extractA string Espressione da estrarre dal campo A. scrivibile
advancedDetails.extractB string Espressione da estrarre dal campo B. scrivibile
advancedDetails.fieldA string Campo A. scrivibile
advancedDetails.fieldAIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
advancedDetails.fieldARequired boolean Indica se il campo A deve corrispondere. scrivibile
advancedDetails.fieldB string Campo B. scrivibile
advancedDetails.fieldBIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
advancedDetails.fieldBRequired boolean Indica se il campo B deve corrispondere. scrivibile
advancedDetails.outputConstructor string Espressione utilizzata per creare il valore di output. scrivibile
advancedDetails.outputToField string Campo di output. scrivibile
advancedDetails.outputToFieldIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
advancedDetails.overrideOutputField boolean Indica se il valore esistente del campo di output, se presente, deve essere sostituito dall'espressione di output. scrivibile
created datetime L'ora di creazione di questo filtro.
excludeDetails nested object Dettagli del filtro del tipo ESCLUDI.
excludeDetails.caseSensitive boolean Determina se il filtro è sensibile alle maiuscole. scrivibile
excludeDetails.expressionValue string Valore espressione di filtro scrivibile
excludeDetails.field string Campo da filtrare. Valori possibili:
  • Contenuti e traffico
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • REFERRAL,
    • COST_DATA_URI (URL target della campagna),
    • TIPO_HIT,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Campagna o gruppo di annunci
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH
  • E-commerce
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (negozio o località dell'ordine),
    • ITEM_NAME,
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Pubblico/Utenti
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PIATTAFORMA,
    • PLATFORM_VERSION,
    • LINGUA,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (campo booleano),
    • FLASH_VERSION,
    • GEO_SPEED (velocità di connessione),
    • VISITOR_TYPE,
    • GEO_ORGANIZZAZIONE (organizzazione ISP),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Posizione
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • Evento
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Altro
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Applicazione
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • SCHERMO,
    • IS_APP (campo booleano),
    • IS_FATAL_EXCEPTION (campo booleano),
    • EXCEPTION_DESCRIPTION,
  • Dispositivo mobile
    • IS_MOBILE (Campo booleano, obsoleto. Utilizza DEVICE_CATEGORY=dispositivi mobili),
    • IS_TABLET (Campo booleano, Deprecato. Utilizza 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,
    • TARGET_AZIONE_SOCIALE,
scrivibile
excludeDetails.fieldIndex integer L'indice della dimensione personalizzata. Da impostare solo se il campo è CUSTOM_DIMENSION. scrivibile
excludeDetails.kind string Valore di tipo per l'espressione di filtro
excludeDetails.matchType string Tipo di corrispondenza per questo filtro. I valori possibili sono BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS o MATCHES. I filtri GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI o PAGE_HOSTNAME possono utilizzare qualsiasi tipo di corrispondenza; tutti gli altri filtri devono utilizzare MATCHES. scrivibile
id string ID filtro.
includeDetails nested object Dettagli per il filtro del tipo INCLUDE.
includeDetails.caseSensitive boolean Determina se il filtro è sensibile alle maiuscole. scrivibile
includeDetails.expressionValue string Valore espressione di filtro scrivibile
includeDetails.field string Campo da filtrare. Valori possibili:
  • Contenuti e traffico
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • REFERRAL,
    • COST_DATA_URI (URL target della campagna),
    • TIPO_HIT,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Campagna o gruppo di annunci
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH
  • E-commerce
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (negozio o località dell'ordine),
    • ITEM_NAME,
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Pubblico/Utenti
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PIATTAFORMA,
    • PLATFORM_VERSION,
    • LINGUA,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (campo booleano),
    • FLASH_VERSION,
    • GEO_SPEED (velocità di connessione),
    • VISITOR_TYPE,
    • GEO_ORGANIZZAZIONE (organizzazione ISP),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Posizione
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • Evento
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Altro
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Applicazione
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • SCHERMO,
    • IS_APP (campo booleano),
    • IS_FATAL_EXCEPTION (campo booleano),
    • EXCEPTION_DESCRIPTION,
  • Dispositivo mobile
    • IS_MOBILE (Campo booleano, obsoleto. Utilizza DEVICE_CATEGORY=dispositivi mobili),
    • IS_TABLET (Campo booleano, Deprecato. Utilizza 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,
    • TARGET_AZIONE_SOCIALE,
scrivibile
includeDetails.fieldIndex integer L'indice della dimensione personalizzata. Da impostare solo se il campo è CUSTOM_DIMENSION. scrivibile
includeDetails.kind string Valore di tipo per l'espressione di filtro
includeDetails.matchType string Tipo di corrispondenza per questo filtro. I valori possibili sono BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS o MATCHES. I filtri GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI o PAGE_HOSTNAME possono utilizzare qualsiasi tipo di corrispondenza; tutti gli altri filtri devono utilizzare MATCHES. scrivibile
kind string Tipo di risorsa per il filtro di Analytics.
lowercaseDetails object Dettagli del filtro del tipo LOWER.
lowercaseDetails.field string Campo da utilizzare nel filtro. scrivibile
lowercaseDetails.fieldIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
name string Il nome di questo filtro. scrivibile
parentLink.href string Link all'account a cui appartiene questo filtro.
parentLink.type string Il valore è "analytics#account".
searchAndReplaceDetails object Dettagli per il filtro del tipo SEARCH_AND_REPLACE.
searchAndReplaceDetails.caseSensitive boolean Determina se il filtro è sensibile alle maiuscole. scrivibile
searchAndReplaceDetails.field string Campo da utilizzare nel filtro. scrivibile
searchAndReplaceDetails.fieldIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
searchAndReplaceDetails.replaceString string Termine con cui sostituire il termine di ricerca. scrivibile
searchAndReplaceDetails.searchString string Termine da cercare. scrivibile
type string Tipo di questo filtro. I valori possibili sono INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE e ADVANCED. scrivibile
updated datetime L'ora dell'ultima modifica di questo filtro.
uppercaseDetails object Dettagli del filtro del tipo UPPER.
uppercaseDetails.field string Campo da utilizzare nel filtro. scrivibile
uppercaseDetails.fieldIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile

Metodi

elimina
Elimina un filtro.
recupero
Restituisci i filtri a cui l'utente ha accesso.
inserire
Crea un nuovo filtro.
list
Elenca tutti i filtri per un account
cerotto
Aggiorna un filtro esistente. Questo metodo supporta la semantica della patch.
aggiornamento
Aggiorna un filtro esistente.