Filtri

Se un report contiene filtri e un connettore della community restituisce dati non filtrati per tutti i campi richiesti, Looker Studio applicherà i filtri al connettore la risposta corretta. Tuttavia, i filtri possono essere applicati a livello di connettore della community, può migliorare significativamente le prestazioni in alcuni casi. Le informazioni del filtro sono passato nell'oggetto di richiesta getData() e il connettore può utilizzare questo le informazioni per filtrare i dati prima di inviarli nuovamente a Looker Studio.

Ad esempio, se ti connetti a un database SQL, applicando i filtri direttamente nella clausola WHERE (B3 nella figura seguente) può diminuire drasticamente il numero di righe restituite a Looker Studio. Questo, a sua volta, limita la quantità di dati che devono essere elaborati e inviati a Looker Studio (B5).

Nota: non è obbligatorio applicare i filtri, ma è consigliato se prevedi in termini di prestazioni grazie all'applicazione.

Regole di applicazione dei filtri

1. Applica tutti i filtri o nessuno di questi. Vedi Filtri non supportati
2. Non includere campi forFilterOnly nella risposta.

3. AND insieme a ogni voce nell'array request.dimensionsFilters.

   Ad esempio, per il seguente filtro, il connettore deve includere solo valori con country di USA E un source di Social.

   {
     "dimensionsFilters": [
       [{
         "fieldName": "country",
         "values": ["USA"],
         "type": "INCLUDE",
         "operator": "EQUALS"
       }],
       [{
         "fieldName": "source",
         "values": ["Social"],
         "type": "INCLUDE",
         "operator": "EQUALS"
       }]
     ]
   }
   

4. OR insieme a ogni array secondario nell'array request.dimensionsFilters.

   Ad esempio, per il seguente filtro, il connettore deve includere solo valori con country di USA OR un country di Canada.

   {
     "dimensionsFilters": [
       [{
         "fieldName": "country",
         "values": ["Canada"],
         "type": "INCLUDE",
         "operator": "EQUALS"
       }, {
         "fieldName": "country",
         "values": ["USA"],
         "type": "INCLUDE",
         "operator": "EQUALS"
       }]
     ]
   }
   

di Gemini Advanced.

Attenzione: la differenza tra OR e AND è sottile. AND ha struttura [[1], [2]], mentre OR ha la struttura [[1, 2]]

Esempio

L'esempio seguente illustra un flusso end-to-end dall'utente del report la definizione di filtri per il connettore della community che restituisce dati filtrati.

1. L'utente del report ha configurato due filtri:

   1. country è IN_LIST di Canada, USA
   2. source è IN_LIST di Social, Organic

2. L'utente del report ha configurato un componente grafico con la dimensione source e sessions metrica

3. getData() viene eseguito da Looker Studio con il seguente oggetto di richiesta:

   {
     "fields": [
       {"name": "source"},
       {"name": "sessions"},
       {"name": "country", "forFilterOnly": true}
     ],
     "dimensionsFilters": [
       [{
         "fieldName": "country",
         "values": ["Canada", "USA"],
         "type": "INCLUDE",
         "operator": "IN_LIST"
       }],
       [{
         "fieldName": "source",
         "values": ["Social", "Organic"],
         "type": "INCLUDE",
         "operator": "IN_LIST"
       }]
     ]
   }
   

4. Il connettore risponde con i dati filtrati.

   Per la richiesta di esempio, restituisce source e sessions dove country è "Canada" o "USA" E source è "Social" o "Organic". Imposta filtersApplied su true poiché è stato possibile applicare tutti i filtri applicata correttamente.

Dati originali

origine	sessioni	country
Social	60	USA
Social	50	Canada
Social	40	Regno Unito
Biologico	90	USA
Biologico	80	Canada
Biologico	70	Regno Unito
Giornale	30	USA
Giornale	20	Canada
Giornale	10	Regno Unito

Dati filtrati

origine	sessioni
Social	60
Social	50
Biologico	90
Biologico	80

getData() risposta

{
  "schema": [
    {"name": "source",   "dataType": "STRING"},
    {"name": "sessions", "dataType": "NUMBER"},
  ],
  "rows": [
    {"values": ["Social", 60]},
    {"values": ["Social", 50]},
    {"values": ["Organic", 90]},
    {"values": ["Organic", 80]}
  ],
  "filtersApplied": true
}

Punto chiave: response.rows[].values non ha una voce per country e filtersApplied è impostato su true.

Filtri non supportati

Se il connettore non può applicare tutti i filtri nella richiesta, non deve essere applicato alcun filtro in esecuzione. Restituisce tutti i campi richiesti (tra cui forFilterOnly ) e imposta la chiave filtersApplied nella tua risposta su false.

Punto chiave: questa è la risposta standard per getData(). Tutti quelli esistenti sono compatibili con le versioni precedenti.

Esempio:

{
  "schema": [
    {"name": "source",   "dataType": "STRING"},
    {"name": "sessions", "dataType": "NUMBER"},
    {"name": "country",  "dataType": "STRING"}
  ],
  "rows": [
    {"values": ["Social", 60, "USA"]},
    {"values": ["Social", 50, "Canada"]},
    {"values": ["Social", 40, "UK"]},
    {"values": ["Organic", 90, "USA"]},
    {"values": ["Organic", 80, "Canada"]},
    {"values": ["Organic", 70, "UK"]},
    {"values": ["Newspaper", 30, "USA"]},
    {"values": ["Newspaper", 20, "Canada"]},
    {"values": ["Newspaper", 10, "UK"]},
  ],
  "filtersApplied": false
}