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

Search Ads 360 Reporting API החדש זמין עכשיו. ה-API החדש מספק גמישות משופרת ליצירה של דוחות בהתאמה אישית ולשילוב הנתונים באפליקציות הדיווח ותהליכים. מידע נוסף על המעבר לממשק החדש של Search Ads 360 ועל השימוש בו 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	1000
ווידג'טים, וידג'טים	http://www.example.com	2012-04-01	2012-06-30	1000
ווידג'טים, וידג'טים	http://www.example.com	2012-07-01	2012-09-30	1000
ווידג'טים, וידג'טים	http://www.example.com	2012-10-01	2012-12-31	3000

לתשומת ליבכם: דוח מפולח מחזיר שורה רק אם יש נתונים זמינים עבור פלח מסוים. לדוגמה, בדוח מילות מפתח עם העמודה 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. כולל את שני הסוגים האלה העמודות יפיקו את תאריכי ההתחלה והסיום של התקופה, ובעזרתם תוכלו לוודא נתונים עבור כל תקופה שלמה.

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

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