Báo cáo được phân đoạn

API Search Ads 360 chỉ trả về dữ liệu tổng hợp, trừ phi bạn yêu cầu dữ liệu được phân đoạn và chi tiết hơn . Ví dụ: cột số lần nhấp trong một từ khoá báo cáo liệt kê tổng số lượt nhấp vào một từ khoá trong khoảng thời gian mà bạn chỉ định.

Nhưng nếu yêu cầu một báo cáo từ khoá phân đoạn theo quý, đối với mỗi từ khoá, bạn sẽ thấy một hàng cho mỗi quý và cột số nhấp chuột sẽ liệt kê tổng số hàng quý.

Lưu ý rằng báo cáo được phân đoạn chỉ trả về hàng nếu phân đoạn có dữ liệu. Ví dụ: trong báo cáo từ khoá có cột floodlightActivity, từ khoá và Cặp hoạt động Floodlight sẽ không xuất hiện trong báo cáo nếu không có chỉ số nào được phân bổ cho phạm vi ngày báo cáo.

Một số phân đoạn không tương thích với một số cột cụ thể

Một số phân đoạn có thể khiến các cột cụ thể trả về dữ liệu không hợp lệ. Ví dụ: phân đoạn theo floodlightActivity chỉ có ý nghĩa nếu bạn bao gồm các cột báo cáo Floodlight chẳng hạn như dfaActions, dfaRevenue, dfaTransactions, và dfaWeightedActions. Các loại cột lượt chuyển đổi khác (chẳng hạn như adWordsConversions) hoặc các cột báo cáo chỉ số của công cụ (chẳng hạn như số lượt nhấp và lượt hiển thị), không chứa dữ liệu do Floodlight báo cáo, nên chúng sẽ trả về các giá trị không hợp lệ nếu bạn phân đoạn báo cáo theo floodlightActivity.

Cách yêu cầu báo cáo phân đoạn

Để yêu cầu một báo cáo được phân đoạn, hãy bao gồm một cột liệt kê segment là hành vi của báo cáo đó trong phần tham khảo Loại báo cáo.

Yêu cầu không đồng bộ sau đây là dành cho báo cáo từ khoá được phân đoạn theo quý. Chiến lược phát hành đĩa đơn cột số lần nhấp trong mỗi hàng sẽ chứa tổng số lần nhấp trong quý:

{
  "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
}