此文件適用於神策分析版本大於等於 1.12 。

1. 取得埋點來源

GET /data_source/category

使用該 API 取得當前埋點數據(一般只有最近7天的數據)的來源資訊：APP 版本、匯入方式。

後續可以根據來源資訊取得指定 APP 版本和指定匯入方式的埋點報告資訊。

• Request GET /data_source/category
• Response 200 (application/json)
  • 查看範例

    {
        "lib":[             // 匯入方式
            "python",
            "LogAgent"
        ],
        "app_version":[     // APP 版本
            "1.0",
            "1.1",
            "2.0",
            "2.1",
            "1.2"
        ]
    }

2. 取得埋點統計報告

POST /data_source/report

使用該 API 可以取得埋點統計報告。一般情況下，埋點數據僅保存最近 7 天數據。

若不指定查詢區間，預設查詢最近 1 小時的埋點統計。查詢的執行時間與查詢區間正相關，請合理設定查詢區間，不要設定過大。

出現已匯入大於已讀取有可能是正常的，因為這是不同模組的統計結果，有可能這段時間沒有讀取和校驗數據，但另一個模組正在匯入之前校驗成功的數據。

埋點統計的時間是實際進行匯入的時間，如今天匯入了前天的一條數據，這條數據會被統計到今天的報告裡。

• Request (application/json)
  • 查看範例

    {
        "from":"1527056400000",        // 查詢時間區間開始時間
        "to":"1532499600000",        // 查詢時間區間結束時間
        "app_version":"all",        // 埋點數據來源的 APP 版本，"all" 查所有
        "status":"storage",            // 埋點數據的狀態，"storage" = 已入庫; "error" = 包含錯誤
        "lib":"python"                //  埋點數據的匯入方式
    }

• Response 200 (application/json)
  • 查看範例

    {
        "read_update_time":1481711426000,    // 上次更新讀取條數時間
        "read":194,                          // 專案一共讀取條數
        "send_update_time":1481711426000,    // 上次更新發送條數時間
        "send":192,                          // 專案一共發送條數
        "write_update_time":1481711407000,   // 上次更新匯入條數時間
        "write":192,                         // 專案一共匯入條數
        "detail_last":1481711426000,         // 詳情更新時間
        "detail":{
            "read":19775,                     // 符合篩選條件的讀取條數
            "send":19775,                     // 符合篩選條件的發送條數
            "write":19775,                    // 符合篩選條件的入庫條數
            "err":0,                          // 符合篩選條件的錯誤條數
            "payload":[                       // 根據事件分類的詳細資訊
                {
                    "event":"taskOperation",
                    "read":961,
                    "send":961,
                    "write":961,
                    "err":0,
                    "last":0,
                    "payload":[                 // 事件的詳細來源資訊
                        {
                            "lib":"python",
                            "lib_version":"1.7.1",
                            "app_version":"2.0",
                            "lib_method":"code",
                            "lib_detail":"normal_mode##normal_mode##simulator.py##582",
                            "read":961,
                            "send":961,
                            "write":961,
                            "err":0,
                            "last":0
                        }
                    ]
                }
            ]
        }
    }