מסננים

אם דוח מכיל מסננים וחיבור קהילתי מחזיר נתונים לא מסוננים לכל השדות המבוקשים, Looker Studio יחיל מסננים על התגובה של החיבור. עם זאת, אפשר להחיל מסננים ברמת מחבר הקהילה, מה שיכול לשפר משמעותית את הביצועים במקרים מסוימים. פרטי הסינון מועברים באובייקט הבקשה getData()‎, והמחבר יכול להשתמש בפרטים האלה כדי לסנן את הנתונים לפני שהוא שולח אותם בחזרה ל-Looker Studio.

לדוגמה, אם אתם מתחברים למסד נתונים של SQL, החלת המסננים ישירות בסעיף WHERE (B3 בתרשים שלמטה) יכולה להקטין באופן משמעותי את מספר השורות שמוחזרות ל-Looker Studio. כתוצאה מכך, כמות הנתונים שצריך לעבד ולשלוח ל-Looker Studio מוגבלת (B5).

כללים להחלת מסננים

1. להחיל את כל המסננים או אף אחד מהם. מידע על מסננים שלא נתמכים
2. לא כוללים את השדות forFilterOnly בתשובה.

3. ‫AND ביחד כל ערך במערך request.dimensionsFilters.

   לדוגמה, במסנן הבא, המחבר צריך לכלול רק ערכים שבהם country הוא USA וגם source הוא Social.

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

4. ‫OR ביחד כל מערך משנה במערך request.dimensionsFilters.

   לדוגמה, במסנן הבא, המחבר צריך לכלול רק ערכים שבהם country הוא USA או country הוא Canada.

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

דוגמה

הדוגמה הבאה ממחישה זרימה מקצה לקצה, החל מהגדרת מסננים על ידי משתמש הדוח ועד להחזרת נתונים מסוננים על ידי מחבר הקהילה.

1. המשתמש שהפיק את הדוח הגדיר שני מסננים:

   1. ‫country הוא IN_LIST מתוך Canada, USA
   2. ‫source הוא IN_LIST מתוך Social, Organic

2. המשתמש בדוח הגדיר רכיב תרשים עם המאפיין source והמדד sessions

3. הפעולה getData() מבוצעת על ידי Looker Studio עם אובייקט הבקשה הבא:

   {
     "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. המחבר משיב עם נתונים מסוננים.

   עבור בקשת הדוגמה, מחזירים את source ואת sessions כאשר country הוא "Canada" או "USA" וגם source הוא "Social" או "Organic". מגדירים את filtersApplied ל-true כי כל המסננים הוחלו בהצלחה.

נתונים מקוריים

נתונים מסוננים

תגובה אחת (getData())

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

מסננים שלא נתמכים

אם המחבר לא יכול להחיל את כל המסננים בבקשה, לא יתבצע סינון. מחזירים את כל השדות המבוקשים (כולל השדות forFilterOnly) ומגדירים את המפתח filtersApplied בתשובה לערך false.

דוגמה:

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