Filtreler

Bir rapor filtreler içeriyorsa ve bir topluluk bağlayıcısı, istenen tüm alanlar için filtrelenmemiş veriler döndürüyorsa Looker Studio, bağlayıcı yanıtına filtre uygular. Ancak filtreler, topluluk bağlayıcısı düzeyinde uygulanabilir ve bu da bazı durumlarda performansı önemli ölçüde artırabilir. Filtre bilgileri getData() istek nesnesinde iletilir ve bağlayıcı, Looker Studio'ya geri göndermeden önce verileri filtrelemek için bu bilgileri kullanabilir.

Örneğin, bir SQL veritabanına bağlanıyorsanız filtreleri doğrudan WHERE ifadesinde (aşağıdaki şemada B3) uygulamak Looker Studio'ya döndürülen satır sayısını önemli ölçüde azaltabilir. Bu da işlenmesi ve Looker Studio'ya gönderilmesi gereken veri miktarını sınırlar (B5).

Not: Filtre uygulamak zorunlu değildir ancak filtre uygulayarak performans artışı elde etmeyi bekliyorsanız önerilir.

Filtre uygulama kuralları

1. Tüm filtreleri veya hiçbirini uygulamayın. Desteklenmeyen filtreler başlıklı makaleyi inceleyin.
2. Yanıt, forFilterOnly alanlarını içermemelidir.

3. AND dizisindeki her girişi birlikte.request.dimensionsFilters

   Örneğin, aşağıdaki filtre için bağlayıcı yalnızca country değeri USA VE source değeri Social olan değerleri içermelidir.

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

4. request.dimensionsFilters dizisindeki her alt diziyi OR birlikte.

   Örneğin, aşağıdaki filtre için bağlayıcı yalnızca country değeri USA VEYA country değeri Canada olan değerleri içermelidir.

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

Dikkat: OR ile AND arasındaki fark küçüktür. AND yapısı [[1], [2]], OR yapısı ise [[1, 2]]

Örnek

Aşağıdaki örnekte, rapor kullanıcısının filtreleri tanımlamasından topluluk bağlayıcısının filtrelenmiş verileri döndürmesine kadar olan uçtan uca akış gösterilmektedir.

1. Rapor kullanıcısı iki filtre yapılandırdı:

   1. country, Canada, USA cinsinden IN_LIST
   2. source, Social, Organic cinsinden IN_LIST

2. Rapor kullanıcısı, source boyutu ve sessions metriğiyle bir grafik bileşeni yapılandırdı.

3. getData(), aşağıdaki istek nesnesiyle Looker Studio tarafından yürütülür:

   {
     "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. Bağlayıcı, filtrelenmiş verilerle yanıt verir.

   Örnek istek için source ve sessions değerlerini döndürün. Burada country, "Canada" veya "USA" VE source, "Social" veya "Organic" olmalıdır. Tüm filtreler başarıyla uygulanabildiğinden filtersApplied değerini true olarak ayarlayın.

Orijinal veriler

kaynak	oturum	country
Sosyal	60	ABD
Sosyal	50	Kanada
Sosyal	40	Birleşik Krallık
Organik	90	ABD
Organik	80	Kanada
Organik	70	Birleşik Krallık
Gazete	30	ABD
Gazete	20	Kanada
Gazete	10	Birleşik Krallık

Filtrelenen veriler

kaynak	oturum
Sosyal	60
Sosyal	50
Organik	90
Organik	80

getData() yanıt

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

Önemli Nokta: response.rows[].values, country için bir girişe sahip değil ve filtersApplied, true olarak ayarlanmış.

Desteklenmeyen filtreler

Bağlayıcı, istekteki tüm filtreleri uygulayamıyorsa filtreleme yapılmamalıdır. İstenen tüm alanları (forFilterOnly alanları dahil) döndürün ve yanıtınızdaki filtersApplied anahtarını false olarak ayarlayın.

Önemli nokta: Bu, getData() için standart yanıttır. Mevcut tüm bağlayıcılar bu değişiklikle geriye dönük uyumludur.

Örnek:

{
  "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
}