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 chi tiết hơn. Ví dụ: cột số lượt nhấp trong báo cáo từ khoá liệt kê tổng số lượt nhấp vào một từ khoá trong phạm vi thời gian mà bạn chỉ định.
| keywordText | keywordLandingPage | lượt nhấp |
|---|---|---|
| tiện ích | http://www.example.com | 6000 |
Nhưng nếu yêu cầu một báo cáo từ khoá phân đoạn theo quý, thì bạn sẽ thấy mỗi quý đối với mỗi từ khoá một hàng và cột lượt nhấp sẽ liệt kê số liệu tổng số theo quý.
| keywordText | keywordLandingPage | quarterStart | quarterEnd | lượt nhấp |
|---|---|---|---|---|
| tiện ích | http://www.example.com | 2012-01-01 | 2012-03-31 | 1000 |
| tiện ích | http://www.example.com | 2012-04-01 | 2012-06-30 | 1000 |
| tiện ích | http://www.example.com | 2012-07-01 | 2012-09-30 | 1000 |
| tiện ích | http://www.example.com | 2012-10-01 | 2012-12-31 | 3000 |
Lưu ý rằng báo cáo được phân đoạn chỉ trả về một hàng nếu có dữ liệu cho một phân đoạn.
Ví dụ: trong báo cáo từ khoá có cột floodlightActivity, cặp từ khoá và
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 cặp từ khoá đó trong phạm vi ngày báo cáo.
Một số phân đoạn không tương thích với các 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ụ: việc 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 dữ liệu 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ột báo cáo các chỉ số của công cụ (chẳng hạn như số lượt nhấp và số lượt hiển thị) không chứa dữ liệu do Floodlight báo cáo nên sẽ trả về các giá trị không hợp lệ nếu bạn phân đoạn một báo cáo theo floodlightActivity.
Cách yêu cầu báo cáo được phân đoạn
Để yêu cầu báo cáo được phân đoạn, hãy bao gồm cột liệt kê segment dưới dạng hành vi của báo cáo đó trong tài liệu 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ý. Cột số lượt nhấp trong mỗi hàng sẽ chứa tổng số lượt 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
}
Yêu cầu nhiều phân khúc
Bạn có thể thêm nhiều cột phân đoạn trong một yêu cầu. Xin lưu ý những điều sau:
-
Nếu phân đoạn theo tuần, tháng hoặc quý, bạn nên đưa cả cột bắt đầu và cột kết thúc vào yêu cầu của mình. Ví dụ: trong một báo cáo hằng quý, hãy thêm cả cột
quarterStartvàquarterEnd. Khi bạn thêm cả hai cột này, kết quả sẽ xuất ra ngày bắt đầu và ngày kết thúc của khoảng thời gian. Nhờ vậy, bạn có thể xác nhận rằng bạn đã thêm dữ liệu cho toàn bộ giai đoạn đó. -
Bạn không thể đưa nhiều loại phân đoạn liên quan đến thời gian vào cùng một yêu cầu. Ví dụ: bạn không thể phân đoạn theo quý và tháng trong cùng một yêu cầu.
-
Số lượng hàng có thể tăng theo cấp số nhân với mỗi phân đoạn bổ sung.