דוחות מסוננים

Search Ads 360 Reporting API החדש זמין עכשיו. ה-API החדש מספק גמישות משופרת ליצירה של דוחות בהתאמה אישית ולשילוב הנתונים באפליקציות הדיווח ותהליכים. מידע נוסף על המעבר לממשק החדש של Search Ads 360 ועל השימוש בו API.

כברירת מחדל, הדוח יכלול את כל הנתונים שכלולים ב-reportScope. שציינת בבקשה שלך. אם רוצים שהדוח יכלול רק את הנתונים שתואמים לקבוצה של קריטריונים, אפשר להוסיף לדוח מסנן אחד או יותר. רק שורות שעומדות בכל המסננים מוחזרים.

לדוגמה, אפשר לבקש דוח עם כל מילות המפתח בסוכנות. לאחר מכן אפשר להגדיר מסנן כך שרק מילות מפתח עם כתובות של דפי נחיתה מתחילות ב- הכתובות www.example.com ו-www.another-example.com מופיעים בדוח.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

כל מסנן מציין עמודה לסינון, אופרטור ורשימת ערכים אמורות להופיע בעמודה שצוינה:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]
הערה: יש עמודות שאי אפשר לסנן. בהפניה 'סוגי דוחות', כל עמודה מציינת אם הוא Filterable.

אופרטורים של סינון

כל המסננים הם תלויי אותיות רישיות. כלומר, מסנן עם "www.Sprockets.com" לא יתאים עמודה שמכילה "www.sprockets.com".

מפעיל תיאור מספר הערכים הנתמכים
equals העמודה חייבת להתאים בדיוק לערך שצוין. 1
notEquals העמודה לא יכולה להתאים לערך שצוין. 1
in

העמודה חייבת להתאים בדיוק לאחד מהערכים ברשימת המסנן.

לא תקף לסוגים שונים של נתונים ברשימות (כמו String list).

משתנה
lessThan

העמודה חייבת להכיל ערך הקטן מהערך שצוין.

אם מציינים את המסנן הזה בעמודה Boolean, מערכת Search Ads 360 API תמיר את false לערך מספרי של 0 ו-true עד 1. אם המיקום אם מציינים את המסנן הזה בעמודה String, ה-API משווה סדר לקסיקוגרפי.

לא תקף לסוגים שונים של נתונים ברשימות (כמו String list).

 1
greaterThan

העמודה חייבת להכיל ערך שגדול מאחד מהערכים של המסנן.

אם מציינים את המסנן הזה בעמודה Boolean, ה-API ימיר את הערך false לערך מספרי של 0 ו-true עד 1. אם המיקום אם מציינים את המסנן הזה בעמודה String, ה-API משווה סדר לקסיקוגרפי.

לא תקף לסוגים שונים של נתונים ברשימות (כמו String list).

1
lessThanOrEqual

העמודה חייבת להכיל ערך שקטן מאחד או שווה לו ברשימת המסנן.

אם מציינים את המסנן הזה בעמודה Boolean, ה-API ימיר את הערך false לערך מספרי של 0 ו-true עד 1. אם המיקום אם מציינים את המסנן הזה בעמודה String, ה-API משווה סדר לקסיקוגרפי.

לא תקף לסוגים שונים של נתונים ברשימות (כמו String list).

1
greaterThanOrEqual

העמודה חייבת להכיל ערך שגדול מהערך או שווה לו ברשימת המסנן.

אם מציינים את המסנן הזה בעמודה Boolean, ה-API ימיר את הערך false לערך מספרי של 0 ו-true עד 1. אם המיקום אם מציינים את המסנן הזה בעמודה String, ה-API משווה סדר לקסיקוגרפי.

לא תקף לסוגים שונים של נתונים ברשימות (כמו String list).

1
isNull העמודה חייבת להיות ריקה. לדוגמה, אם מציינים isNull עבור העמודה keywordMaxCpc בדוח מילות מפתח, הדוח תכלול רק מילות מפתח שלא צוינה עבורן עלות מקסימלית לקליק. 0
isNotNull העמודה חייבת להכיל ערך. 0
startsWith

העמודה חייבת להתחיל באחת מהמחרוזות שכלולות ברשימת המסנן.

תקף רק ל-String עמודות.

משתנה
containsSubstring

העמודה חייבת להכיל את כל אחת מהמחרוזות או חלק מהן רשימת המסננים.

לדוגמה, מסנן containsSubstring עם הערכים:
["ham", "cheese"]
הפונקציה תחזיר שורות עם הערך הבא:

hamburger cheeseburger

אבל לא תחזיר שורות עם הערכים הבאים:
lobster roll
lettuce
high amplitude (high amplitude כולל מחרוזת המשנה 'h am', אבל כל התווים, כולל רווחים, מוערכים על ידי המסנן)

תקף רק ל-String עמודות.

משתנה
doesNotContainSubstring

העמודה לא יכולה להכיל אף אחת מהמחרוזות ברשימת המסנן.

לדוגמה, מסנן doesNotContainSubstring עם הערכים:
["ham", "cheese"]
הפונקציה תחזיר שורות עם הערך הבא:

lobster roll lettuce

אבל לא תחזיר שורות עם הערכים הבאים:
האםהמבורגר
המבורגר גבינה

תקף רק ל-String עמודות.

משתנה
containsElement

העמודה חייבת להכיל לפחות אחד מהערכים ברשימת המסנן. תקף רק לעמודות עם סוגי נתונים ברשימות (כגון String list).

לדוגמה, בדוח campaign, מסנן containsElement עם הערכים
: ["foo", "bar"]
סינון בעמודה effectiveLabels תציג רק קמפיינים עם התווית foo, bar או שניהם.

משתנה