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

Search Ads 360 Reporting API החדש זמין עכשיו. ה-API החדש מאפשר גמישות רבה יותר בהגדרה של דוחות בהתאמה אישית ובשילוב של הנתונים באפליקציות ובתהליכים שמשמשים לדיווח. מידע נוסף על המעבר ל-Search Ads 360 Reporting 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 כולל את מחרוזת המשנה "ham", אבל כל התווים – כולל רווחים – נבדקים על ידי המסנן)

אפשר להזין רק String עמודות.

משתנה
doesNotContainSubstring

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

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

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

אפשר להזין רק String עמודות.

משתנה
containsElement

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

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

משתנה