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

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

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

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