Filtreler

Bir rapor filtreler içeriyorsa ve bir topluluk bağlayıcısı filtrelenmemiş veriler döndürüyorsa İstenen tüm alanlar için Looker Studio, bağlayıcıya filtre uygular. tıklayın. Ancak filtreler topluluk bağlayıcısı düzeyinde uygulanabilir. bazı durumlarda performansı önemli ölçüde artırabilir. Filtre bilgileri: getData() istek nesnesi içinde iletildiği takdirde bağlayıcı, .

Örneğin, bir SQL veritabanına bağlanıyorsanız filtreler doğrudan WHERE ifadesini (aşağıdaki diyagramda B3) içeren ek anahtar kelimelerin Looker Studio'ya döndürülen satır sayısı. Bu da gösterim için işlenip Looker Studio'ya (B5) gönderilmesi gereken veri miktarıdır.

Not: Filtre uygulamak zorunlu değildir ancak filtre uygulamanız önerilir. elde edeceği performans artışını gösterir.

Filtre uygulama kuralları

1. Tüm filtreleri veya bunlardan hiçbirini uygulama. Desteklenmeyen filtreler başlıklı makaleyi inceleyin
2. Yanıta forFilterOnly alanları eklemeyin.

3. AND request.dimensionsFilters dizisindeki her girişi bir arada gösterir.

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

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

4. OR ile request.dimensionsFilters dizisindeki her bir alt diziyi toplayın.

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

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

ziyaret edin.

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

yapısına sahiptir ve [[1], [2]] yapısı

Örnek

Aşağıdaki örnekte, rapor kullanıcısından bir uçtan uca akış gösterilmektedir. filtrelenen veriler döndüren topluluk bağlayıcısı için filtreler tanımlayarak.

1. Rapor kullanıcısı iki filtre yapılandırmıştır:

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

2. Rapor kullanıcısı source boyutuyla bir grafik bileşeni yapılandırdı ve sessions metrik

3. getData(), Looker Studio tarafından aşağıdaki istek nesnesiyle 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 veriyor.

   Örnek istek için country olan source ve sessions değerlerini döndürün "Canada" veya "USA" VE source ya "Social" ya da "Organic". Tüm filtreler başarılı olduğundan filtersApplied değerini true olarak ayarlayın başarıyla uygulandı.

Orijinal veriler

source	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

Filtrelenmiş veriler

source	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 için country ve filtersApplied, true olarak ayarlandı.

Desteklenmeyen filtreler

Bağlayıcı, istekteki tüm filtreleri uygulayamıyorsa hiçbir filtre uygulanmamalıdır. gerçekleştirildi. İstenen tüm alanları (forFilterOnly dahil) döndürün alanları) tıklayın ve yanıtınızdaki filtersApplied anahtarını false olarak ayarlayın.

Önemli Bilgi: Bu, getData() için standart yanıttır. Mevcut olanların tümü bağlayıcıları geriye dönük olarak 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
}