מסננים

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