אם דוח מכיל מסננים ומחבר קהילתי מחזיר נתונים לא מסוננים בכל השדות המבוקשים, Looker Studio יחיל מסננים על התגובה של המחבר. עם זאת, ניתן להחיל מסננים ברמת המחבר הקהילתי, ובמקרים מסוימים לשפר את הביצועים באופן משמעותי. פרטי הסינון מועברים באובייקט הבקשה getData(), והמחבר יכול להשתמש במידע הזה כדי לסנן את הנתונים לפני שהם שולחים אותם חזרה ל-Looker Studio.
לדוגמה, אם מתחברים למסד נתונים של SQL, החלת המסננים ישירות בסעיף WHERE
(B3 בתרשים שבהמשך) עשויה לצמצם משמעותית את מספר השורות שמוחזרים ב-Looker Studio. כך גם הגבלה של כמות הנתונים שצריך לעבד ולשלוח אל Looker Studio (B5).
כללים לשימוש במסננים
- החלת כל המסננים, או אף אחד מהם. מידע נוסף מופיע בקטע מסננים לא נתמכים
- אין לכלול את השדות
forFilterOnly
בתשובה. הפונקציה
AND
ביחד עם כל רשומה במערךrequest.dimensionsFilters
.לדוגמה, במסנן הבא, המחבר צריך לכלול רק ערכים שיש להם
country
שלUSA
וגםsource
שלSocial
.{ "dimensionsFilters": [ [{ "fieldName": "country", "values": ["USA"], "type": "INCLUDE", "operator": "EQUALS" }], [{ "fieldName": "source", "values": ["Social"], "type": "INCLUDE", "operator": "EQUALS" }] ] }
הפונקציה
OR
יוצרת ביחד כל מערך משנה במערךrequest.dimensionsFilters
.לדוגמה, במסנן הבא, המחבר צריך לכלול רק ערכים שיש להם
country
שלUSA
אוcountry
שלCanada
.{ "dimensionsFilters": [ [{ "fieldName": "country", "values": ["Canada"], "type": "INCLUDE", "operator": "EQUALS" }, { "fieldName": "country", "values": ["USA"], "type": "INCLUDE", "operator": "EQUALS" }] ] }
דוגמה
הדוגמה הבאה ממחישה תהליך מקצה לקצה מהמשתמש בדוח שמגדיר מסננים למחבר הקהילה שמחזיר נתונים מסוננים.
המשתמש בדוח הגדיר שני מסננים:
country
הואIN_LIST
מתוךCanada, USA
source
הואIN_LIST
מתוךSocial, Organic
המשתמש בדוח הגדיר רכיב בתרשים עם המאפיין
source
והמדדsessions
הפקודה
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" }] ] }
המחבר מגיב עם נתונים מסוננים.
בבקשה לדוגמה, מחזירים את הערכים
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
}
מסננים שלא נתמכים
אם המחבר לא יכול להחיל את כל המסננים בבקשה, לא יתבצע סינון. מחזירים את כל השדות המבוקשים (כולל השדות 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
}