דוחות מפולחים

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

ב-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
}
  

הערה: חשוב לשים לב לתאריכים. אם רוצים לבקש דוח רבעוני, צריך לוודא שה-timeRange של הדוח כולל את כל הרבעון. אחרת, יתקבלו תוצאות חלקיות בלבד, מה שעשוי לגרום לאנשים לחשוב שהייתה ירידה משמעותית בקליקים, בהכנסות וכו'.

שליחת בקשה למספר פלחים

בקשה יכולה לכלול יותר מעמודת פלח אחת. שימו לב לנקודות הבאות:

• אם יוצרים פילוח לפי שבוע, חודש או רבעון, מומלץ לכלול בבקשה גם את עמודת ההתחלה וגם את עמודת הסיום. לדוגמה, בדוח רבעוני, כוללים את העמודות quarterStart ו-quarterEnd. אם מוסיפים את שתי העמודות, המערכת יוצרת פלט של תאריכי ההתחלה והסיום של התקופה. כך אפשר לוודא שכללתם נתונים לכל תקופה שלמה.

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

• מספר השורות עשוי לגדול משמעותית עם כל פלח נוסף.