گزارش های بخش بندی شده

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
}