260
如何獲取站點的報告數據
功能
根據站點ID獲取站點報告數據。
接口名稱
https://api.baidu.com/json/tongji/v1/ReportService/getData
用戶相關性
用戶相關
應用級輸入參數
基本參數
| 參數名 | 參數類型 | 是否必需 | 描述 |
|---|---|---|---|
| site_id | uint | 是 | 站點id |
| method | 是 | 通常對應要查詢的報告 | |
| start_date | 是 | 查詢起始時間,例：20160501 | |
| end_date | 是 | 查詢結束時間,例：20160531 | |
| start_date2 | 否 | 對比查詢起始時間 | |
| end_date2 | 否 | 對比查詢結束時間 | |
| metrics | 是 | 自定義指標選擇，多個指標用逗號分隔 | |
| gran | 否 | 時間粒度(隻支持有該參數的報告): day/hour/week/month | |
| order | 否 | 指標排序，示例：visitor_count,desc | |
| start_index | uint | 否 | 獲取數據偏移，用於分頁；默認是0 |
| max_results | uint | 否 | 單次獲取數據條數，用於分頁；默認是20; |
| 0表示獲取所有數據. |
注：
1．method參數，通常對應要查詢的報告，與網站頁麵所發送請求的method參數一致，如要獲取趨勢分析報告的數據，所用到的方法為“trend/time/a”。
2.metrics參數，是所要獲取的指標，根據不同的報告填寫相關指標，與網站頁麵所發送請求的indicators參數一致，如要獲取瀏覽量(PV)、訪客數(UV)、新訪客數，則所填指標為“pv_count,visitor_count,new_visitor_count”。
詳見下麵“關鍵參數與報告的對應”的描述。
篩選參數
| 參數名 | 參數類型 | 是否必需 | 描述 |
|---|---|---|---|
| target | int | 否 | 轉化目標：1：全部頁麵目標 2：全部事件目標 3：時長目標 4：訪問頁數目標 |
| source | string | 否 | 來源過濾： through：直接訪問 search,0：搜索引擎全部 link：外部鏈接 |
| clientDevice | string | 否 | 設備過濾 pc：計算機 mobile：移動設備 |
| area | string | 否 | 地域過濾 china：全國 province,1：省市自治區北京 province,2：省市自治區上海 province,3：省市自治區天津 … other：其他 |
| visitor | string | 否 | 訪客過濾 new：新訪客 old：老訪客 |
關鍵參數與報告的對應
()
()
請求示例
這裏通過列舉若幹調用實例來進一步闡述該接口的使用方式，其中會根據獲取數據的不同而傳入不同的請求參數。
1.獲取趨勢分析報告中PV和UV數據，按天粒度
2.獲取地域分布報告中的跳出率、平均訪問時長、平均訪問頁數指標，按平均
訪問頁數指標排序（倒序），並做新訪客的篩選。
返回參數
| 參數名 | 參數類型 | 是否必需 | 描述 |
|---|---|---|---|
| result | ReportData | 是 | 報告數據 |
ReportData結構
返回示例
{
"header": {
"desc": "success",
"failures": [],
"oprs": 1,
"succ": 1,
"oprtime": 1,
"quota": 1,
"rquota": 1538,
"status": 0
},
"body": {
"data": [
{
"result": {
"offset": 0,
"timeSpan": [
"2016/05/31"
],
"fields": [
"visit_district_title",
"pv_count",
"visitor_count",
"ip_count"
],
"total": 35,
"sum": [
[
88498794,
35978529,
25665169
],
[]
],
"pageSum": [
[
35405459,
14085496,
9982100
],
[],
[]
],
"items": [
[
[
{
"name": "廣東",
"area": "province,4"
}
],
[
{
"name": "浙江",
"area": "province,32"
}
],
[
{
"name": "其他",
"area": "province,0"
}
],
[
{
"name": "江蘇",
"area": "province,19"
}
],
[
{
"name": "河南",
"area": "province,14"
}
]
],
[
[
12341436,
4761366,
3272131
],
[
6246400,
2439809,
1818061
],
[
5843763,
2371240,
1583733
],
[
5786661,
2349302,
1784306
],
[
5187199,
2163779,
1523869
]
],
[],
[]
]
}
}
]
}
} 最後更新：2016-12-26 23:58:24