ב-Search Ads 360 API מוחזר רק נתונים נצברים, אלא אם מבקשים נתונים מפולחים יותר ומפורטים יותר. לדוגמה, עמודת הקליקים בדוח מילות המפתח מציינת את המספר הכולל של קליקים על מילת מפתח מסוימת בטווח הזמן שציינתם.
keywordText | keywordLandingPage | קליקים |
---|---|---|
ווידג'טים, וידג'טים | http://www.example.com | 6000 |
עם זאת, אם תבקשו דוח של מילות מפתח עם פילוח לפי רבעון, לכל מילת מפתח תוצג שורה אחת לכל רבעון, ובעמודת הקליקים יופיעו הסכומים הכוללים הרבעוניים.
keywordText | keywordLandingPage | quarterStart | quarterEnd | קליקים |
---|---|---|---|---|
ווידג'טים, וידג'טים | http://www.example.com | 2012-01-01 | 2012-03-31 | 1,000 |
ווידג'טים, וידג'טים | http://www.example.com | 2012-04-01 | 2012-06-30 | 1,000 |
ווידג'טים, וידג'טים | http://www.example.com | 2012-07-01 | 2012-09-30 | 1,000 |
ווידג'טים, וידג'טים | http://www.example.com | 2012-10-01 | 2012-12-31 | 3,000 |
הערה: דוח מפולח מחזיר שורה רק אם הנתונים זמינים לפלח.
לדוגמה, בדוח של מילות מפתח שמכיל את העמודה floodlightActivity
, מילת מפתח וצמד פעילות ב-Floodlight לא יופיעו בדוח אם לא משויכים אליו מדדים בטווח התאריכים של הדוח.
חלק מהפלחים לא תואמים לעמודות מסוימות
פלחים מסוימים עשויים לגרום לעמודות מסוימות להחזיר נתונים לא חוקיים. לדוגמה, לפילוח לפי floodlightActivity
יש משמעות רק אם כוללים עמודות שמדווחות על נתוני Floodlight, כמו dfaActions
, dfaRevenue
, dfaTransactions
ו-dfaWeightedActions
. סוגים אחרים של עמודות המרה (כמו adWordsConversions
) או עמודות שמדווחות על מדדי מנועים (כמו קליקים
וחשיפות), לא כוללות נתונים שמדווחים על ידי Floodlight, ולכן הן מחזירות ערכים לא חוקיים אם מפלחים דוח לפי floodlightActivity
.
איך לבקש דוח עם פילוח
כדי לבקש דוח עם פילוח, יש לכלול עמודה שמציינת את segment
כהתנהגות שלו בהפניה סוגי דוחות.
הבקשה האסינכרונית הבאה היא עבור דוח מילות מפתח המפולח לפי רבעון. עמודת הקליקים בכל שורה תכיל את המספר הכולל של הקליקים ברבעון:
{ "reportScope": { "agencyId": "20700000000000123", // Replace with your IDs "advertiserId": "2170000012345" // Replace with your IDs }, "reportType": "keyword", "columns": [ { "columnName": "campaignId" }, { "columnName": "keywordText" }, { "columnName": "keywordLandingPage" }, { "columnName": "quarterStart" }, { "columnName": "quarterEnd" }, { "columnName": "clicks" }, ] "timeRange" : { "startDate" : "2012-01-01", "endDate" : "2012-12-31" }, "downloadFormat": "csv", "maxRowsPerFile": 5000000, "statisticsCurrency": "agency", "verifySingleTimeZone": false, "includeRemovedEntities": false }
שליחת בקשה למספר פלחים
בקשה יכולה לכלול יותר מעמודת פלח אחת. שימו לב לנקודות הבאות:
-
אם יוצרים פילוח לפי שבוע, חודש או רבעון, מומלץ לכלול בבקשה גם את עמודת ההתחלה וגם את עמודת הסיום. לדוגמה, בדוח רבעוני, כוללים את העמודות
quarterStart
ו-quarterEnd
. אם מוסיפים את שתי העמודות, המערכת יוצרת פלט של תאריכי ההתחלה והסיום של התקופה. כך אפשר לוודא שכללתם נתונים לכל תקופה שלמה. -
לא ניתן לכלול סוגים שונים של קטעים הקשורים לזמן באותה בקשה. לדוגמה, לא ניתן לפלח לפי רבעון וחודש באותה בקשה.
-
מספר השורות עשוי לגדול משמעותית עם כל פלח נוסף.