מסננים

אם דוח מכיל מסננים ומחבר קהילתי מחזיר נתונים לא מסוננים בכל השדות המבוקשים, 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"
       }]
     ]
   }
   

זהירות: ההבדל בין OR לבין AND הוא דק. ל-AND יש את המבנה [[1], [2]], ואילו ל-OR יש את המבנה [[1, 2]]

דוגמה

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

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" AND הערך source הוא "Social" או "Organic". צריך להגדיר את filtersApplied לערך true כי ניתן היה להחיל את כל המסננים בהצלחה.

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

source	ביקורים	country
רשתות חברתיות	60	ארה"ב
רשתות חברתיות	50	קנדה
רשתות חברתיות	40	בריטניה
אורגני	90	ארה"ב
אורגני	80	קנדה
אורגני	70	בריטניה
עיתון	30	ארה"ב
עיתון	20	קנדה
עיתון	10	בריטניה

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

source	ביקורים
רשתות חברתיות	60
רשתות חברתיות	50
אורגני	90
אורגני	80

תשובה אחת (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
}

נקודה חשובה: ב-response.rows[].values אין רשומה של country ו-filtersApplied מוגדר ל-true.

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

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

נקודה חשובה: זו התגובה הרגילה של getData(). כל המחברים הקיימים תואמים לאחור לשינוי הזה.

דוגמה:

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