# 分布解析モデル API
呼び出し方法Open APIドキュメントの呼び出し方法の説明を参照してください。
使用マニュアルで分布分析使用シーンを知ることができる。
# ディストリビューション分析クエリ
インターフェイス URL
/open/distribution-analyze?token=xxx
リクエスト方法
POST
コンテンツタイプ
application/json
Query パラメーター
パラメータ名 | サンプル値 | パラメーターの種類 | 必須かどうか | パラメーターの説明 |
---|---|---|---|---|
token | xxx | String | 是 | トークン |
# 要求 Body パラメーター
{
"eventView":{
"endTime":"2021-10-05 23:59:59",
"groupBy":[
{
"columnDesc":"学历",
"columnName":"education",
"propertyRange":"",
"specifiedClusterDate":"2022-01-24",
"tableType":"user"
},
{
"columnDesc":"城市",
"columnName":"city",
"propertyRange":"",
"specifiedClusterDate":"2022-01-24",
"tableType":"user"
}],
"recentDay":"114-115",
"startTime":"2021-10-04 00:00:00",
"taIdMeasureVo":{
"columnDesc":"用户唯一ID",
"columnName":"#user_id",
"tableType":"event"
},
"timeParticleSize":"day"
},
"events":[
{
"customEvent":"activity_attend.TIMES",
"customFilters":[
],
"eventName":"自定义指标",
"eventNameDisplay":"",
"filts":[
{
"columnDesc":"城市",
"columnName":"city",
"comparator":"equal",
"filterType":"SIMPLE",
"ftv":[
"北京市",
"上海市",
"广州市",
"深圳市"],
"specifiedClusterDate":"2022-01-27",
"tableType":"user",
"timeUnit":""
}],
"formulation":{
"formulationDeps":[
{
"event":{
"eventDesc":"参加活动",
"eventName":"activity_attend"
}
}]
},
"intervalType":"user_defined",
"quota":"",
"quotaIntervalArr":[
500],
"relation":"and",
"type":"customized"
},
{
"analysis":"TOTAL_TIMES",
"analysisDesc":"总次数",
"eventName":"payment",
"eventNameDisplay":"",
"filts":[
],
"intervalType":"def",
"quota":"",
"relation":"and",
"type":"normal"
}],
"projectId":377,
"limit": 2,
"timeoutSeconds": 10,
"useCache": true
}
# リクエストパラメータ説明
パラメーター名 | サンプル値 | パラメーターの種類 | 必須かどうか | パラメーターの説明 |
---|---|---|---|---|
eventView | - | Object | はい | グループ化プロパティ |
∟ endTime | 2021-10-05 23:59:59 | String | いいえ | 終了時刻(形式: yyyy-MM-ddHH: mm: ss)、相対時刻が空の場合有効 |
∟ groupBy | - | List | いいえ | グループ化属性は、0個以上あり得る |
∟ columnDesc | 学歴 | String | いいえ | フィールド表示名 |
∟ columnName | education | String | はい | フィールド名 |
∟ propertyRange | String | いいえ | カスタムプロパティ間隔 | |
∟ specifiedClusterDate | 2022-01-24 | String | いいえ | クラスター指定日 |
∟ tableType | user | String | はい | テーブルタイプ、event:イベントテーブル、user:ユーザテーブル |
∟ recentDay | 114-115 | String | いいえ | 相対時間(開始時刻と終了時刻の両方で空であってはならない) |
∟ startTime | 2021-10-04 00:00:00 | String | いいえ | 開始時間(形式: yyyy-MM-ddHH: mm: ss)、相対時間が空の場合有効 |
∟ taIdMeasureVo | - | Object | いいえ | 本体構成の分析 |
∟ columnDesc | ユーザ固有ID | String | いいえ | フィールド表示名 |
∟ columnName | #user_id | String | はい | フィールド名 |
∟ tableType | event | String | はい | テーブルタイプ、event:イベントテーブル、user:ユーザテーブル |
∟ timeParticleSize | day | String | はい | 分析の時間単位 minute: 1分押す minute5: 5分押す(v3.5サポート開始) minute10: 10分押す(v3.5サポート開始) hour:時間単位 day:日ごと week:週ごと 月:月ごと total:合計 |
events | - | List | はい | イベントインジケータ一覧 |
∟ analysis | TOTAL_TIMES | String | いいえ | 分析角度は、具体的には下表 |
∟ analysisDesc | 合計回数 | String | いいえ | 分析角度の説明(表示名) |
∟ customEvent | activity_attend.TIMES | String | いいえ | カスタムイベント |
∟ customFilters | [] | List | いいえ | カスタムイベントフィルタリング |
∟ eventName | login | String | はい | イベント名、特別な、任意のイベントを表すためにanyEventを使用できます |
∟ eventNameDisplay | String | いいえ | イベント表示名 | |
∟ filts | - | List | いいえ | 条件リスト |
∟ columnDesc | 都市 | String | いいえ | フィールド表示名 |
∟ columnName | city | String | はい | フィールド名 |
∟ comparator | equal | String | はい | 参照:モデルクエリAPIのフィルター式 |
∟ filterType | SIMPLE | String | いいえ | フィルタモード、SIMPLE:シンプル、COMPOUND:コンポジット |
∟ ftv | ["北京市"] | List | いいえ | プロパティの比較値 |
∟ specifiedClusterDate | 2022-01-27 | String | いいえ | クラスター指定日 |
∟ tableType | user | String | はい | テーブルタイプ、event:イベントテーブル、user:ユーザテーブル |
∟ timeUnit | String | いいえ | フィルタリング時間単位 | |
∟ formulation | - | Object | いいえ | 新しい数式エンティティ |
∟ formulationDeps | - | List | いいえ | 数式依存 |
∟ event | - | Object | いいえ | 依存イベント |
∟ eventDesc | イベントに参加する | String | いいえ | イベント表示名 |
∟ eventName | activity_attend | String | はい | イベント名 |
∟ intervalType | user_defined | String | いいえ | 間隔タイプ discrete:離散数値 def:デフォルト区間 ユーザ定義 |
∟ quota | String | いいえ | インジケータのプロパティ | |
∟ quotaIntervalArr | [500] | List | いいえ | 指標の範囲 |
∟ relation | and | String | いいえ | 論理関係、and:論理と、or:論理や |
∟ type | normal | String | はい | インジケータの種類、 ノーマル:正 customized:カスタム |
projectId | 0 | Integer | はい | プロジェクトID |
limit | 2 | Integer | いいえ | 分析対象あたりのパケット数の上限、オプションパラメータは、デフォルトで1000、最大で10000 |
timeoutSeconds | 10 | Integer | いいえ | タイムアウトパラメーターが要求され、タイムアウトするとクエリタスク |
useCache | true | Boolean | いいえ | キャッシュを使用します。オプションのパラメーターはデフォルトでtrueです |
分布分析集計方法 analysis 値:
値です | 説明 | プロパティが必要かどうか |
---|---|---|
TIMES | 回数 | いいえ |
NUMBER_OF_DAYS | 日数 | いいえ |
NUMBER_OF_HOURS | 時間数 | いいえ |
SUM | 数値の合計 | はい |
AVG | 数値平均 | はい |
MAX | 数値の最大値 | はい |
MIN | 数値の最小値 | はい |
DISTINCT | 数えて | はい |
TRUE | 真の数です | はい |
FALSE | 偽の数です | はい |
IS_NOT_EMPTY | 空でない | はい |
IS_EMPTY | 空の数です | はい |
ARRAY_DISTINCT | リスト全体の重み | はい |
ARRAY_SET_DISTINCT | 要素の集合は重みをとる | はい |
ARRAY_ITEM_DISTINCT | リスト要素の逆数 | はい |
MEDIAN | 中央値 | はい |
# 成功応答の例
{
"data": {
"distribution_interval": [
",500",
"500,"
],
"result_generate_time": "2022-01-27 11:25:44",
"x": [
"2021-10-04",
"2021-10-05"
],
"y": {
"2021-10-04": [
{
"groupCols": [
"总体",
"总体"
],
"isTotal": 1,
"meanwhileValues": [
"28249",
"-"
],
"totalMeanwhileValue": "28249",
"totalUserNum": 1722,
"values": [
1722,
0
]
},
{
"groupCols": [
"其他",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"3842",
"-"
],
"totalMeanwhileValue": "3842",
"totalUserNum": 235,
"values": [
235,
0
]
},
{
"groupCols": [
"大专",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"2421",
"-"
],
"totalMeanwhileValue": "2421",
"totalUserNum": 154,
"values": [
154,
0
]
},
{
"groupCols": [
"其他",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"2518",
"-"
],
"totalMeanwhileValue": "2518",
"totalUserNum": 151,
"values": [
151,
0
]
},
{
"groupCols": [
"其他",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"2355",
"-"
],
"totalMeanwhileValue": "2355",
"totalUserNum": 142,
"values": [
142,
0
]
},
{
"groupCols": [
"其他",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"1906",
"-"
],
"totalMeanwhileValue": "1906",
"totalUserNum": 116,
"values": [
116,
0
]
},
{
"groupCols": [
"大专",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"1738",
"-"
],
"totalMeanwhileValue": "1738",
"totalUserNum": 107,
"values": [
107,
0
]
},
{
"groupCols": [
"本科",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"1720",
"-"
],
"totalMeanwhileValue": "1720",
"totalUserNum": 106,
"values": [
106,
0
]
},
{
"groupCols": [
"大专",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"1658",
"-"
],
"totalMeanwhileValue": "1658",
"totalUserNum": 101,
"values": [
101,
0
]
},
{
"groupCols": [
"本科",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"1595",
"-"
],
"totalMeanwhileValue": "1595",
"totalUserNum": 96,
"values": [
96,
0
]
},
{
"groupCols": [
"研究生",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"1315",
"-"
],
"totalMeanwhileValue": "1315",
"totalUserNum": 78,
"values": [
78,
0
]
},
{
"groupCols": [
"本科",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"1276",
"-"
],
"totalMeanwhileValue": "1276",
"totalUserNum": 75,
"values": [
75,
0
]
},
{
"groupCols": [
"大专",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"1207",
"-"
],
"totalMeanwhileValue": "1207",
"totalUserNum": 75,
"values": [
75,
0
]
},
{
"groupCols": [
"研究生",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"1032",
"-"
],
"totalMeanwhileValue": "1032",
"totalUserNum": 63,
"values": [
63,
0
]
},
{
"groupCols": [
"本科",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"796",
"-"
],
"totalMeanwhileValue": "796",
"totalUserNum": 49,
"values": [
49,
0
]
},
{
"groupCols": [
"研究生",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"678",
"-"
],
"totalMeanwhileValue": "678",
"totalUserNum": 42,
"values": [
42,
0
]
},
{
"groupCols": [
"研究生",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"674",
"-"
],
"totalMeanwhileValue": "674",
"totalUserNum": 38,
"values": [
38,
0
]
},
{
"groupCols": [
"博士",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"514",
"-"
],
"totalMeanwhileValue": "514",
"totalUserNum": 33,
"values": [
33,
0
]
},
{
"groupCols": [
"博士",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"361",
"-"
],
"totalMeanwhileValue": "361",
"totalUserNum": 21,
"values": [
21,
0
]
},
{
"groupCols": [
"博士",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"327",
"-"
],
"totalMeanwhileValue": "327",
"totalUserNum": 20,
"values": [
20,
0
]
},
{
"groupCols": [
"博士",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"316",
"-"
],
"totalMeanwhileValue": "316",
"totalUserNum": 20,
"values": [
20,
0
]
}
],
"2021-10-05": [
{
"groupCols": [
"总体",
"总体"
],
"isTotal": 1,
"meanwhileValues": [
"24907",
"-"
],
"totalMeanwhileValue": "24907",
"totalUserNum": 1503,
"values": [
1503,
0
]
},
{
"groupCols": [
"其他",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"3535",
"-"
],
"totalMeanwhileValue": "3535",
"totalUserNum": 221,
"values": [
221,
0
]
},
{
"groupCols": [
"其他",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"2833",
"-"
],
"totalMeanwhileValue": "2833",
"totalUserNum": 162,
"values": [
162,
0
]
},
{
"groupCols": [
"大专",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"2183",
"-"
],
"totalMeanwhileValue": "2183",
"totalUserNum": 130,
"values": [
130,
0
]
},
{
"groupCols": [
"其他",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"1946",
"-"
],
"totalMeanwhileValue": "1946",
"totalUserNum": 116,
"values": [
116,
0
]
},
{
"groupCols": [
"其他",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"1743",
"-"
],
"totalMeanwhileValue": "1743",
"totalUserNum": 109,
"values": [
109,
0
]
},
{
"groupCols": [
"本科",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"1753",
"-"
],
"totalMeanwhileValue": "1753",
"totalUserNum": 107,
"values": [
107,
0
]
},
{
"groupCols": [
"大专",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"1606",
"-"
],
"totalMeanwhileValue": "1606",
"totalUserNum": 92,
"values": [
92,
0
]
},
{
"groupCols": [
"本科",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"1421",
"-"
],
"totalMeanwhileValue": "1421",
"totalUserNum": 81,
"values": [
81,
0
]
},
{
"groupCols": [
"本科",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"1093",
"-"
],
"totalMeanwhileValue": "1093",
"totalUserNum": 68,
"values": [
68,
0
]
},
{
"groupCols": [
"研究生",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"1037",
"-"
],
"totalMeanwhileValue": "1037",
"totalUserNum": 65,
"values": [
65,
0
]
},
{
"groupCols": [
"大专",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"947",
"-"
],
"totalMeanwhileValue": "947",
"totalUserNum": 59,
"values": [
59,
0
]
},
{
"groupCols": [
"大专",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"963",
"-"
],
"totalMeanwhileValue": "963",
"totalUserNum": 58,
"values": [
58,
0
]
},
{
"groupCols": [
"研究生",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"698",
"-"
],
"totalMeanwhileValue": "698",
"totalUserNum": 42,
"values": [
42,
0
]
},
{
"groupCols": [
"本科",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"608",
"-"
],
"totalMeanwhileValue": "608",
"totalUserNum": 39,
"values": [
39,
0
]
},
{
"groupCols": [
"研究生",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"560",
"-"
],
"totalMeanwhileValue": "560",
"totalUserNum": 37,
"values": [
37,
0
]
},
{
"groupCols": [
"研究生",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"553",
"-"
],
"totalMeanwhileValue": "553",
"totalUserNum": 31,
"values": [
31,
0
]
},
{
"groupCols": [
"博士",
"北京市"
],
"isTotal": 0,
"meanwhileValues": [
"478",
"-"
],
"totalMeanwhileValue": "478",
"totalUserNum": 29,
"values": [
29,
0
]
},
{
"groupCols": [
"博士",
"广州市"
],
"isTotal": 0,
"meanwhileValues": [
"353",
"-"
],
"totalMeanwhileValue": "353",
"totalUserNum": 22,
"values": [
22,
0
]
},
{
"groupCols": [
"博士",
"上海市"
],
"isTotal": 0,
"meanwhileValues": [
"339",
"-"
],
"totalMeanwhileValue": "339",
"totalUserNum": 19,
"values": [
19,
0
]
},
{
"groupCols": [
"博士",
"深圳市"
],
"isTotal": 0,
"meanwhileValues": [
"258",
"-"
],
"totalMeanwhileValue": "258",
"totalUserNum": 16,
"values": [
16,
0
]
}
]
}
},
"return_code": 0,
"return_message": "success"
}
# 応答パラメータ説明
パラメーター名 | サンプル値 | パラメーターの種類 | パラメーターの説明 |
---|---|---|---|
return_code | 0 | Integer | リターンコード |
return_message | success | String | 戻る情報 |
data | - | Object | 結果を返す |
∟ distribution_interval | [",500","500,"] | List | 分布間隔 |
∟ result_generate_time | 2022-01-27 11:25:44 | String | 結果生成時間 |
∟ x | ["2021-10-04"] | List | x軸情報 |
∟ y | - | List | y軸情報 |
エラー応答の例
{
"return_code": -1008,
"return_message": "参数(token)为空"
}
パラメータ名 | サンプル値 | パラメーターの種類 | パラメーターの説明 |
---|---|---|---|
return_code | -1008 | Integer | リターンコード |
return_message | パラメータ(token)は空です | String | 戻る情報 |
# 分布分析ユーザリスト
インターフェイス URL
/open/distribution-user-list?token=xxx
リクエスト方法
POST
コンテンツタイプ
application/json
要求 Query パラメーター
パラメータ名 | サンプル値 | パラメーターの種類 | 必須かどうか | パラメーターの説明 |
---|---|---|---|---|
token | xxx | String | 是 | トークン |
# 要求 Body パラメーター
{
"projectId": 0,
"eventView": {
"startTime": "2019-10-28 00:00:00",
"endTime": "2019-11-26 00:00:00",
"recentDay": "D31",
"timeParticleSize": "week",
"groupBy": [
{
"columnName": "#province",
"tableType": "event"
}
]
},
"events": [{
"analysis": "TIMES",
"eventName": "consume_item",
"intervalType": "def",
"quota": "",
"relation": "and",
"filts": [
{
"columnName": "#os",
"comparator": "equal",
"ftv": [
"android"
],
"tableType": "event"
}
]
}],
"interval": "10,20",
"sliceDate": "2019-11-18",
"sliceGroupVal": ["北京市"],
"timeoutSeconds": 10
}
# リクエストパラメータ説明
パラメーター名 | サンプル値 | パラメーターの種類 | 必須かどうか | パラメーターの説明 |
---|---|---|---|---|
projectId | 0 | String | はい | パラメーターの説明 |
eventView | - | Object | はい | グループ化属性テーブル |
∟ startTime | 2019-10-28 00:00:00 | String | いいえ | 開始時間(形式: yyyy-MM-ddHH: mm: ss)、相対時間が空の場合有効 |
∟ endTime | 2019-11-26 00:00:00 | String | いいえ | 終了時刻(形式: yyyy-MM-ddHH: mm: ss)、相対時刻が空の場合有効 |
∟ recentDay | D31 | String | いいえ | 相対時間(開始時刻と終了時刻の両方で空であってはならない) |
∟ timeParticleSize | week | String | はい | 分析の時間単位 minute: 1分押す minute5: 5分押す(v3.5サポート開始) minute10: 10分押す(v3.5サポート開始) hour:時間単位 day:日ごと week:週ごと 月:月ごと total:合計 |
∟ groupBy | - | List | いいえ | グループ化属性は、0個以上あり得る |
∟ columnName | #city | String | はい | フィールド名 |
∟ tableType | event | String | はい | テーブルタイプ、event:イベントテーブル、user:ユーザテーブル |
events | List | はい | イベントインジケータ一覧 | |
∟ eventName | consume_item | String | はい | イベント名、特別な、任意のイベントを表すためにanyEventを使用できます |
∟ analysis | TIMES | String | いいえ | 分析タイプ、集約操作、具体的には下表を参照 |
∟ quota | String | いいえ | 指標属性(analysisと協力して、どの属性のどの分析角度を意味するか) | |
∟ relation | and | String | いいえ | 論理関係、and:論理と、or:論理や |
∟ intervalType | def | String | はい | discrete:離散数値 def:デフォルト区間 ユーザ定義 |
∟ filts | - | List | いいえ | フィルタ項目一覧 |
∟ columnName | #os | String | はい | フィールド名 |
∟ comparator | equal | String | はい | 参照:モデルクエリAPIのフィルター式 |
∟ ftv | ["android"] | List | いいえ | プロパティの比較値 |
∟ tableType | event | String | はい | テーブルタイプ、event:イベントテーブル、user:ユーザテーブル |
interval | 10,20 | String | いいえ | [10,20]時間 |
sliceDate | "2019-11-18" | String | いいえ | 2019-11-18今週 |
sliceGroupVal | ["北京市"] | String | はい | イベントのグループ化 |
timeoutSeconds | 10 | Integer | いいえ | タイムアウトパラメーターが要求され、タイムアウトするとクエリタスク |
# 成功応答の例
{
"data": {
"datalist": [
{
"#account_id": "h7784497",
"#distinct_id": "h14456917",
"user_level": 13,
"register_time": "2019-11-24 21:52:38",
"diamond_num": 1201,
"latest_login_time": "2019-11-24 23:35:49",
"channel": "百度手机助手",
"#user_id": 3336217
},
{
"#account_id": "h6201359",
"#distinct_id": "h11516759",
"user_level": 68,
"register_time": "2019-06-23 09:25:18",
"diamond_num": 1686,
"first_recharge_time": "2019-06-23 09:25:38",
"latest_login_time": "2019-11-18 23:01:49",
"channel": "华为应用市场",
"#user_id": 2657759
},
{
"#account_id": "g4102426",
"#distinct_id": "g7618786",
"user_level": 47,
"register_time": "2019-07-29 13:58:23",
"diamond_num": 1,
"first_recharge_time": "2019-07-29 15:42:20",
"latest_login_time": "2019-11-24 16:04:03",
"channel": "应用宝",
"#user_id": 1758186
}
],
"columMeta": {
"#account_id": "账户ID",
"#distinct_id": "访客ID",
"user_level": "用户等级",
"register_time": "注册时间",
"diamond_num": "当前拥有钻石数",
"first_recharge_time": "首次充值时间",
"latest_login_time": "最后登录时间",
"channel": "渠道"
}
},
"return_code": 0,
"return_message": "success"
}
# 応答パラメータ説明
パラメーター名 | サンプル値 | パラメーターの種類 | パラメーターの説明 |
---|---|---|---|
return_code | 0 | Integer | リターンコード |
return_message | success | String | 戻る情報 |
data | - | Object | 結果を返す |
∟ datalist | - | List | ユーザー情報 |
∟ columMeta | - | Map | フィールド意味マッピング |
エラー応答の例
{
"return_code": -1008,
"return_message": "参数(token)为空"
}
パラメータ名 | サンプル値 | パラメーターの種類 | パラメーターの説明 |
---|---|---|---|
return_code | -1008 | Integer | リターンコード |
return_message | パラメータ(token)は空です | String | 戻る情報 |