イベント分析モデルAPI
呼び出し方法は、Open APIドキュメントの呼び出し方法の説明を参照してください。
利用シーンについては、マニュアルのイベント分析を参照してください。
1. イベント分析クエリ
インターフェースURL
/open/event-analyze?token=xxx
リクエストメソッド
POST
Content-Type
application/json
リクエストQueryパラメータ
| パラメータ名 | サンプル値 | パラメータタイプ | 必須 | パラメータの説明 |
|---|---|---|---|---|
| token | xxx | String | はい | クエリキー |
リクエストBodyパラメータ
{
"eventView": {
"comparedByTime": true,
"comparedStartTime": "2021-12-14 00:00:00",
"comparedEndTime": "2021-12-20 23:59:59",
"comparedRecentDay": "8-14",
"startTime": "2021-12-21 00:00:00",
"endTime": "2021-12-27 23:59:59",
"recentDay": "1-7",
"timeParticleSize": "day",
"eventSplit": {
"event": {
"eventDesc": "ログイン",
"eventName": "login"
},
"groupByProp": {
"columnDesc": "ブラウザ",
"columnName": "browser",
"propertyRange": "",
"tableType": "event"
}
},
"groupBy": [{
"columnDesc": "ブランド",
"columnName": "brand",
"propertyRange": "",
"specifiedClusterDate": "2021-12-28",
"tableType": "event"
}],
"relation": "and",
"filts": [{
"columnDesc": "ブランド",
"columnName": "brand",
"comparator": "equal",
"filterType": "SIMPLE",
"ftv": ["Apple", "Xiaomi"],
"specifiedClusterDate": "2021-12-28",
"tableType": "event",
"timeUnit": ""
}],
"queryFeature": {
"approximateOn": true,
"globalQueryOn": false
}
},
"events": [{
"analysis": "TOTAL_TIMES",
"analysisParams": "",
"eventName": "login",
"eventNameDisplay": "ログインの合計回数",
"eventSplitIndexes": [0],
"eventUuid": "7FonAy-G",
"filts": [],
"quota": "",
"relation": "and",
"type": "normal"
}, {
"analysis": "TRIG_USER_NUM",
"analysisParams": "",
"eventName": "activity_attend",
"eventNameDisplay": "アクティビティ参加のユニークユーザー数",
"eventUuid": "K9A5NDAz",
"filts": [{
"columnDesc": "appバージョン",
"columnName": "app_version",
"comparator": "notNull",
"filterType": "SIMPLE",
"ftv": [],
"specifiedClusterDate": "2021-12-28",
"tableType": "event",
"timeUnit": ""
}],
"quota": "",
"quotaEntities": [{
"index": 0,
"taIdMeasure": {
"columnDesc": "ユーザー一意ID",
"columnName": "#user_id",
"tableType": "event"
}
}],
"relation": "and",
"type": "normal"
}, {
"customEvent": "logout.PER_CAPITA_TIMES",
"customFilters": [],
"eventName": "自定义指标",
"eventNameDisplay": "",
"eventSplitIndexes": [],
"eventUuid": "gxqT19xz",
"filts": [],
"format": "float",
"quota": "",
"quotaEntities": [{
"index": 0,
"taIdMeasure": {
"columnDesc": "メールアドレス",
"columnName": "email",
"tableType": "user"
}
}],
"quotaTimeRanges": [{
"index": 0,
"params": ["1"],
"type": "THIS_WEEK"
}],
"relation": "and",
"type": "customized"
}],
"projectId": 377,
"useSameResultKey": false,
"useCache": true,
"limit": 1000,
"timeoutSeconds": 10,
"zoneOffset": 10
}
入力パラメータは複数の部分で構成されます。基本パラメータは必須です。時間比較パラメータ、イベント分割パラメータ、グループパラメータ、グローバルフィルターパラメータ、クエリ設定パラメータは任意です。通常の分析指標とカスタム分析指標はどちらか一方を指定します。
リクエストパラメータの説明
| $$パラメータ名 | サンプル値 | パラメータタイプ | 必須 | パラメータの説明 |
|---|---|---|---|---|
| eventView | - | Object | はい | 指標の共通プロパティ部分 |
| eventView.comparedByTime | true | Boolean | いいえ | 時間比較を行うかどうか。TRUE:はい、FALSE:いいえ |
eventView.comparedStartTime | 2021-12-14 00:00:00 | String | いいえ | 比較期間の開始時間(形式:yyyy-MM-dd HH:mm:ss)。比較期間の相対時間が空の場合に有効 |
| eventView.comparedEndTime | 2021-12-20 23:59:59 | String | いいえ | 比較期間の終了時間(形式:yyyy-MM-dd HH:mm:ss)。比較期間の相対時間が空の場合に有効 |
| eventView.comparedRecentDay | 8-14 | String | いいえ | 比較期間の相対時間(comparedByTimeがTRUEの場合、この項目と比較期間の開始時間・終了時間を同時に空にすることはできません) |
| eventView.startTime | 2021-12-21 00:00:00 | String | いいえ | 開始時間(形式:yyyy-MM-dd HH:mm:ss)。相対時間が空の場合に有効 |
| eventView.endTime | 2021-12-27 23:59:59 | String | いいえ | 終了時間(形式:yyyy-MM-dd HH:mm:ss)。相対時間が空の場合に有効 |
| eventView.recentDay | 1-7 | String | いいえ | 相対時間(この項目と開始時間・終了時間を同時に空にすることはできません) |
| eventView.relation | and | String | いいえ | 論理関係。and:論理積、or:論理和 |
| eventView.timeParticleSize | day | String | はい | 分析の時間単位
|
| eventView.eventSplit | - | Object | いいえ | イベント分割の情報 |
| eventView.eventSplit.event | - | Object | はい | イベント分割のイベント情報 |
| eventView.eventSplit.event.eventDesc | ログイン | String | いいえ | イベント分割指標の表示名 |
| eventView.eventSplit.event.eventName | login | String | はい | イベント分割指標のイベント名 |
| eventView.eventSplit.groupByProp | - | Object | はい | イベント分割指標のグループ情報 |
| eventView.eventSplit.groupByProp.columnDesc | ブラウザ | String | いいえ | イベント分割のグループフィールドの表示名 |
| eventView.eventSplit.groupByProp.columnName | browser | String | はい | イベント分割のグループフィールドのフィールド名 |
| eventView.eventSplit.groupByProp.propertyRange | String | いいえ | イベント分割のグループプロパティの区間 | |
| eventView.eventSplit.groupByProp.tableType | event | String | はい | テーブルタイプの列挙値 |
| eventView.groupBy | - | List | いいえ | グループ化プロパティ。0個以上指定できます |
| eventView.groupBy.columnName | brand | String | はい | フィールド名 |
| eventView.groupBy.columnDesc | ブランド | String | いいえ | フィールドの表示名 |
| eventView.groupBy.propertyRange | String | いいえ | カスタムプロパティの区間 | |
| eventView.groupBy.propertyRangeType | String | いいえ | プロパティの区間タイプ。数値型プロパティをグループ化する場合、カスタムのバケット条件を指定できます
| |
| eventView.groupBy.specifiedClusterDate | 2021-12-28 | String | いいえ | 指定した日付に対応するタグの履歴バージョン |
| eventView.groupBy.tableType | event | String | はい | テーブルタイプの列挙値 |
| eventView.filts | - | List | いいえ | グローバルフィルター項目 |
| eventView.filts.columnDesc | ブランド | String | いいえ | フィールドの表示名 |
| eventView.filts.columnName | brand | String | はい | フィールド名 |
| eventView.filts.comparator | equal | String | はい | 参考:モデルクエリAPIのフィルター式 |
| eventView.filts.filterType | SIMPLE | String | いいえ | フィルターモード。SIMPLE:シンプル、COMPOUND:複合。デフォルトはSIMPLE |
| eventView.filts.ftv | ["Apple", "Xiaomi"] | List | いいえ | プロパティ比較の境界に使用するリテラル定数 |
| eventView.filts.specifiedClusterDate | 2021-12-28 | String | いいえ | 指定した日付に対応するタグの履歴バージョン |
| eventView.filts.tableType | event | String | はい | テーブルタイプの列挙値 |
| eventView.filts.timeUnit | String | いいえ | プロパティ比較値の単位。relativeEvent*の場合のみ有効:day、hour、minute | |
| eventView.queryFeature | - | Object | いいえ | クエリ設定 |
| eventView.queryFeature.approximateOn | true | Boolean | いいえ | 近似計算を有効にするかどうか |
| events | - | List | はい | イベント指標のリスト |
| events.analysis | TRIG_USER_NUM | String | いいえ | 分析の観点(集計操作)。詳しくはイベント集計タイプの列挙値を参照 |
| events.analysisParams | String | いいえ | 分析の観点のパラメータ(analysisがPERCENTILEの場合は空にできません。値の範囲:1-100、何パーセンタイルかを表します) | |
| events.eventName | activity_attend | String | はい | イベント名。特に、anyEventで任意のイベントを表すことができます |
| events.eventNameDisplay | アクティビティ参加のユニークユーザー数 | String | いいえ | イベント表示名 |
| events.metricName | retention_rate_1 | String | いいえ | クエリする指標。固定化された分析基準を表します。 指標でクエリする場合、events.eventNameを「自定义指标」に設定できます |
| events.eventUuid | K9A5NDAz | String | いいえ | イベントUUID。イベントを一意に識別するために使用 |
| events.filts | - | List | いいえ | 条件リスト |
| events.filts.columnDesc | アプリバージョン | String | いいえ | フィールドの表示名 |
| events.filts.columnName | app_version | String | はい | フィールド名 |
| events.filts.comparator | notNull | String | はい | 参考:モデルクエリAPIのフィルター式 |
| events.filts.filterType | SIMPLE | String | いいえ | フィルターモード。SIMPLE:シンプル、COMPOUND:複合。デフォルトはSIMPLE |
| events.filts.ftv | [] | List | いいえ | プロパティ比較に使用する境界のリテラル定数 |
| events.filts.specifiedClusterDate | 2021-12-28 | String | いいえ | 指定した日付に対応するタグの履歴バージョン |
| events.filts.tableType | event | String | はい | テーブルタイプの列挙値 |
| events.filts.timeUnit | String | いいえ | フィルターの時間単位 | |
| events.quota | String | いいえ | 指標プロパティ(analysisと組み合わせて、どのプロパティのどの分析の観点かを表します) | |
| events.quotaDesc | String | いいえ | 指標プロパティの表示名 | |
| events.quotaEntities | - | List | 分析イベント指標に対応する主体のリスト | |
| events.quotaEntities.index | 0 | Integer | はい | 分析イベント指標に対応する主体のインデックス |
| events.quotaEntities.taIdMeasure | - | Object | クエリのID体系の設定 | |
| events.quotaEntities.taIdMeasure.columnDesc | ユーザー一意ID | String | いいえ | フィールドの表示名 |
| events.quotaEntities.taIdMeasure.columnName | #user_id | String | はい | フィールド名 |
| events.quotaEntities.taIdMeasure.tableType | event | String | はい | テーブルタイプの列挙値 |
| events.relation | and | String | いいえ | 論理関係。and:論理積、or:論理和 |
| events.type | normal | String | はい | normal:通常の分析 customized:カスタム数式 |
| events.customEvent | logout.PER_CAPITA_TIMES | String | いいえ | 計算式。分析項目または数値定数の加減乗除で構成します。分析項目にはeventName.columnName.analysisとeventName.analysisの2つの形式があります。 計算式に分析指標を含める場合は、固定のプレフィックス+指標名の形式を使用します。例: $metric.metricName/eventName.columnName.analysisまたは $metric.metricName1/$metric.metricName2 |
| events.customFilters | [] | List | いいえ | 計算式のフィルター項目のリスト |
| events.eventName | 自定义指标 | String | はい | 指標のイベント名。anyEventで任意イベントを指定できます |
| events.eventNameDisplay | String | いいえ | カスタム指標の表示名 | |
| events.eventSplitIndexes | [] | List | いいえ | イベント分割の対象となる項目 |
events.format | float | String | いいえ | データの表示オプション float:小数点以下2桁、float3:小数点以下3桁、float4:小数点以下4桁、percent:パーセント |
| events.quota | String | いいえ | 指標プロパティ(analysisと組み合わせて、どのプロパティのどの分析の観点かを表します) | |
| events.quotaDesc | String | いいえ | 指標プロパティの表示名 | |
| events.quotaEntities | - | List | いいえ | 分析イベント指標に対応する主体のリスト |
| events.quotaEntities.index | 0 | Integer | はい | 分析イベント指標に対応する主体のインデックス |
| events.quotaEntities.taIdMeasure | - | Object | はい | クエリのID体系の設定 |
| events.quotaEntities.taIdMeasure.columnDesc | メール | String | いいえ | フィールドの表示名 |
| events.quotaEntities.taIdMeasure.columnName | String | はい | フィールド名 | |
| events.quotaEntities.taIdMeasure.tableType | user | String | はい | テーブルタイプの列挙値 |
| events.quotaTimeRanges | [] | List | いいえ | 指標の期間情報リスト |
| events.quotaTimeRanges.index | 0 | Integer | はい | 期間のインデックス |
| events.quotaTimeRanges.params | ["1"] | List | いいえ | 期間のパラメータ。events.quotaTimeRanges.typeがTIME_RANGEの場合、paramsが["-3", "4"]であれば、過去3日から未来4日までを表します |
| events.quotaTimeRanges.type | THIS_WEEK | String | はい | 期間のタイプ LAST_DAYS:過去N日間、RECENT_DAYS:直近N日間、THIS_WEEK:今週、THIS_MONTH:今月、TIME_RANGE:時間範囲 |
| events.relation | and | String | いいえ | 論理関係。and:論理積、or:論理和 |
events.type | customized | String | はい | normal:通常の分析 customized:カスタム数式 |
| projectId | 377 | Integer | はい | プロジェクトID |
| useSameResultKey | false | Boolean | いいえ | イベント名が同じ場合に、同じイベント名を使用するかどうか true:同じイベント名を使用 false:イベント名が同じ場合、接頭辞として番号を付加 |
| useCache | true | Boolean | はい | trueの場合はキャッシュを使用 |
| limit | 1000 | Integer | いいえ | 分析対象ごとのグループ数の上限。任意パラメータで、デフォルトは1000、最大は10000 |
| timeoutSeconds | 10 | Integer | いいえ | リクエストのタイムアウトパラメータ。タイムアウトした場合はクエリタスクをキャンセルします |
| zoneOffset | 10 | Integer | いいえ | タイムゾーン |
成功レスポンスの例
{
"data": {
"result_generate_time": "2021-12-30 11:15:41",
"union_groups": [
[
"Safari",
"Apple"
],
[
"Firefox",
"Xiaomi"
],
[
"WeChat内蔵ブラウザ",
"Apple"
],
[
"全体",
"Apple"
],
[
"全体",
"Xiaomi"
]
],
"x": [
"2021-12-23",
"2021-12-24",
"2021-12-25",
"2021-12-26",
"2021-12-27",
"2021-12-28",
"2021-12-29"
],
"x_compared": [
"2021-12-16",
"2021-12-17",
"2021-12-18",
"2021-12-19",
"2021-12-20",
"2021-12-21",
"2021-12-22"
],
"y": [
{
"login.TOTAL_TIMES": [
{
"group_cols": [
"Safari",
"Apple"
],
"group_num": 3,
"values": [
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"values_compared": [
"447",
"980",
"1584",
"321",
"285",
"74",
"0"
]
},
{
"group_cols": [
"Firefox",
"Xiaomi"
],
"group_num": 3,
"values": [
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"values_compared": [
"291",
"818",
"1128",
"272",
"219",
"58",
"0"
]
},
{
"group_cols": [
"WeChat内蔵ブラウザ",
"Apple"
],
"group_num": 3,
"values": [
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"values_compared": [
"231",
"500",
"764",
"214",
"155",
"35",
"0"
]
}
]
},
{
"activity_attend.TRIG_USER_NUM": [
{
"group_cols": [
"全体",
"Apple"
],
"group_num": 2,
"values": [
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"values_compared": [
"640",
"811",
"1251",
"1253",
"720",
"113",
"0"
]
},
{
"group_cols": [
"全体",
"Xiaomi"
],
"group_num": 2,
"values": [
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"values_compared": [
"277",
"439",
"600",
"666",
"364",
"59",
"0"
]
}
]
},
{
"自定义指标": [
{
"group_cols": [
"全体",
"Apple"
],
"group_num": 2,
"values": [
"1",
"1",
"1",
"1",
"0",
"0",
"0"
],
"values_compared": [
"1.01",
"1.01",
"1.01",
"1.01",
"1",
"1",
"1"
]
},
{
"group_cols": [
"全体",
"Xiaomi"
],
"group_num": 2,
"values": [
"1",
"1",
"1",
"1",
"0",
"0",
"0"
],
"values_compared": [
"1.01",
"1.01",
"1.01",
"1.01",
"1",
"1",
"1"
]
}
]
}
]
},
"return_code": 0,
"return_message": "success"
}
レスポンスパラメータの説明
| $$パラメータ名 | サンプル値 | パラメータタイプ | パラメータの説明 |
|---|---|---|---|
| data | - | Object | 戻り値 |
| data.result_generate_time | 2021-12-29 12:00:00 | String | クエリ結果の生成時間 |
| data.union_groups | ["Apple"] | List | すべてのグループの集合 |
| data.x | ["2021-12-23"] | List | X軸の時間 |
| data.x_compared | ["2021-12-16"] | List | X軸の比較時間 |
| data.y | - | List | Y軸のデータリスト |
| data.y.{指標名} | - | List | Y軸の指標情報リスト |
| data.y.{指標名}.group_cols | ["Apple"] | List | Y軸の指標グループ |
| data.y.{指標名}.group_num | 3 | Integer | Y軸の指標グループ数 |
| data.y.{指標名}.values | ["0"] | List | Y軸の指標値 |
| data.y.{指標名}.values_compared | ["447"] | List | Y軸の時間比較の指標値 |
| return_code | 0 | Integer | リターンコード |
| return_message | success | String | リターンメッセージ |
エラーレスポンスの例
{
"return_code": -1008,
"return_message": "パラメータ(token)が空です"
}
| パラメータ名 | サンプル値 | パラメータタイプ | パラメータの説明 |
|---|---|---|---|
| return_code | -1008 | Integer | リターンコード |
| return_message | パラメータ(token)が空です | String | リターンメッセージ |
curlの例
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{"projectId": 377,"useSameResultKey": false,"useCache": true,"limit": 1000,"eventView": {"comparedByTime": true,"comparedStartTime": "2021-12-14 00:00:00","comparedEndTime": "2021-12-20 23:59:59","comparedRecentDay": "8-14","startTime": "2021-12-21 00:00:00","endTime": "2021-12-27 23:59:59","recentDay": "1-7","relation": "and","timeParticleSize": "day","eventSplit": {"event": {"eventDesc": "ログイン","eventName": "login"},"groupByProp": {"columnDesc": "ブラウザ","columnName": "browser","propertyRange": "","tableType": "event"}},"groupBy": [{"columnDesc": "ブランド","columnName": "brand","propertyRange": "","specifiedClusterDate": "2021-12-28","tableType": "event"}],"filts": [{"columnDesc": "ブランド","columnName": "brand","comparator": "equal","filterType": "SIMPLE","ftv": ["Apple", "Xiaomi"],"specifiedClusterDate": "2021-12-28","tableType": "event","timeUnit": ""}],"queryFeature": {"approximateOn": true,"globalQueryOn": false}},"events": [{"analysis": "TOTAL_TIMES","analysisParams": "","eventName": "login","eventNameDisplay": "ログインの合計回数","eventSplitIndexes": [0],"eventUuid": "7FonAy-G","filts": [],"quota": "","relation": "and","type": "normal"}, {"analysis": "TRIG_USER_NUM","analysisParams": "","eventName": "activity_attend","eventNameDisplay": "アクティビティ参加のユニークユーザー数","eventUuid": "K9A5NDAz","filts": [{"columnDesc": "appバージョン","columnName": "app_version","comparator": "notNull","filterType": "SIMPLE","ftv": [],"specifiedClusterDate": "2021-12-28","tableType": "event","timeUnit": ""}],"quota": "","quotaEntities": [{"index": 0,"taIdMeasure": {"columnDesc": "ユーザー一意ID","columnName": "#user_id","tableType": "event"}}],"relation": "and","type": "normal"}, {"customEvent": "logout.PER_CAPITA_TIMES","customFilters": [],"eventName": "自定义指标","eventNameDisplay": "","eventSplitIndexes": [],"eventUuid": "gxqT19xz","filts": [],"format": "float","quota": "","quotaEntities": [{"index": 0,"taIdMeasure": {"columnDesc": "メールアドレス","columnName": "email","tableType": "user"}}],"quotaTimeRanges": [{"index": 0,"params": ["1"],"type": "THIS_WEEK"}],"relation": "and","type": "customized"}]}' 'http://ta2:8992/open/event-analyze?token=YOUR_TOKEN'
2. イベント分析のフルダウンロード
インターフェースURL
/open/streaming-download/event-analyze?token=xxx
リクエストメソッド
POST
Content-Type
application/json
リクエストQueryパラメータ
| パラメータ名 | サンプル値 | パラメータタイプ | 必須 | パラメータの説明 |
|---|---|---|---|---|
| token | xxx | String | はい | クエリキー |
リクエストBodyパラメータ
{
"eventView": {
"endTime": "2022-03-07 16:32:12",
"filts": [{
"columnDesc": "レベル",
"columnName": "level",
"comparator": "greater",
"filterType": "SIMPLE",
"ftv": ["1"],
"specifiedClusterDate": "2022-03-08",
"tableType": "event",
"timeUnit": ""
}],
"groupBy": [{
"columnDesc": "channel",
"columnName": "channel",
"propertyRange": "",
"specifiedClusterDate": "2022-03-08",
"tableType": "event"
}],
"recentDay": "1-7",
"relation": "and",
"startTime": "2022-03-01 16:32:12",
"timeParticleSize": "day"
},
"events": [{
"analysis": "TOTAL_TIMES",
"analysisParams": "",
"eventName": "LogOut",
"eventNameDisplay": "LogOutの合計回数",
"eventUuid": "QgfCSkCw",
"filts": [],
"quota": "",
"relation": "and",
"type": "normal"
}],
"projectId": 319,
"zoneOffset": 10
}
リクエストパラメータの説明
| $$パラメータ名 | サンプル値 | パラメータタイプ | 必須 | パラメータの説明 |
|---|---|---|---|---|
| projectId | 0 | String | はい | パラメータの説明 |
| eventView | - | Object | はい | パラメータの内容はイベント分析クエリAPIと同じです |
| events | List | はい | パラメータの内容はイベント分析クエリAPIと同じです | |
| zoneOffset | 10 | Integer | いいえ | タイムゾーン |
リクエストパラメータはAEシステムのイベント分析ページから直接エクスポートできます
レスポンス
AEシステムのイベント分析のフルダウンロードと同じ
3. イベント分析のユーザーリスト
インターフェースURL
/open/event-user-list?token=xxx
リクエストメソッド
POST
Content-Type
application/json
リクエストQueryパラメータ
| パラメータ名 | サンプル値 | パラメータタイプ | 必須 | パラメータの説明 |
|---|---|---|---|---|
| token | xxx | String | はい | クエリキー |
リクエストBodyパラメータ
{
"projectId": 0,
"eventView": {
"startTime": "2019-11-24 00:00:00",
"endTime": "2019-11-26 00:00:00",
"recentDay": "1-3",
"timeParticleSize": "day",
"groupBy": [
{
"columnName": "#city",
"tableType": "event"
}
]
},
"events": [
{
"analysis": "TRIG_USER_NUM",
"eventName": "consume_item",
"quota": "#vp@dailyTask",
"relation": "and",
"type": "normal",
"filts": [
{
"columnName": "user_level",
"comparator": "equal",
"ftv": [
"5"
],
"tableType": "user"
}
],
}
],
"sliceDate": "2019-11-26",
"eventIndex": 0,
"sliceGroupVal": [
"北京市"
],
"timeoutSeconds": 10,
"zoneOffset": 10
}
リクエストパラメータの説明
| $$パラメータ名 | サンプル値 | パラメータタイプ | 必須 | パラメータの説明 |
|---|---|---|---|---|
| projectId | 0 | String | はい | パラメータの説明 |
| eventView | - | Object | はい | パラメータの内容はイベント分析クエリAPIと同じです |
| events | List | はい | パラメータの内容はイベント分析クエリAPIと同じです | |
| sliceDate | "2019-11-26" | String | いいえ | ドリルダウンする日付 |
| sliceGroupVal | ["北京市"] | List | はい | ドリルダウンするグループ |
| eventIndex | 0 | int | はい | ドリルダウンする指標の番号(0から開始) |
| timeoutSeconds | 10 | Integer | いいえ | リクエストのタイムアウトパラメータ。タイムアウトした場合はクエリタスクをキャンセルします |
| zoneOffset | 10 | Integer | いいえ | タイムゾーン |
成功レスポンスの例
{
"data": {
"datalist": [
{
"#account_id": "e78107482",
"#distinct_id": "e145056682",
"user_level": 5,
"register_time": "2019-11-26 14:36:13",
"diamond_num": 1006,
"latest_login_time": "2019-11-26 15:45:16",
"channel": "app store",
"#user_id": 33474682
},
{
"#account_id": "d7819213",
"#distinct_id": "d14521393",
"user_level": 5,
"register_time": "2019-11-26 23:25:14",
"diamond_num": 858,
"first_recharge_time": "2019-11-26 23:29:56",
"latest_login_time": "2019-11-26 23:32:48",
"channel": "app store",
"#user_id": 3351093
}
],
"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 | 戻り値 |
| data.datalist | - | List<Map> | ユーザー情報 |
| data.columMeta | - | Map | フィールドの意味のマッピング |
エラーレスポンスの例
{
"return_code": -1008,
"return_message": "パラメータ(token)が空です"
}
| パラメータ名 | サンプル値 | パラメータタイプ | パラメータの説明 |
|---|---|---|---|
| return_code | -1008 | Integer | リターンコード |
| return_message | パラメータ(token)が空です | String | リターンメッセージ |
4. イベント分析のユーザーリストのダウンロード
インターフェースURL
/open/streaming-download/event-user-list?token=xxx
リクエストメソッド
POST
Content-Type
application/json
リクエストQueryパラメータ
| パラメータ名 | サンプル値 | パラメータタイプ | 必須 | パラメータの説明 |
|---|---|---|---|---|
| token | xxx | String | はい | クエリキー |
リクエストBodyパラメータ
{
"eventView": {
"comparedByTime": false,
"comparedRecentDay": "",
"endTime": "2022-03-07 16:32:12",
"filts": [
{
"columnDesc": "レベル",
"columnName": "level",
"comparator": "greater",
"filterType": "SIMPLE",
"ftv": [
"1"
],
"specifiedClusterDate": "2022-03-08",
"tableType": "event",
"timeUnit": ""
}
],
"groupBy": [
{
"columnDesc": "channel",
"columnName": "channel",
"propertyRange": "",
"specifiedClusterDate": "2022-03-08",
"tableType": "event"
}
],
"recentDay": "1-7",
"relation": "and",
"startTime": "2022-03-01 16:32:12",
"timeParticleSize": "day"
},
"events": [
{
"analysis": "TRIG_USER_NUM",
"analysisParams": "",
"eventName": "LogOut",
"eventNameDisplay": "LogOutのユニークユーザー数",
"eventUuid": "QgfCSkCw",
"filts": [],
"quota": "",
"quotaEntities": [
{
"index": 0,
"taIdMeasure": {
"columnDesc": "ユーザー一意ID",
"columnName": "#user_id",
"tableType": "event"
}
}
],
"relation": "and",
"type": "normal"
}
],
"projectId": 319,
"sliceDate": "2022-03-01",
"eventIndex": 0,
"sliceGroupVal": [
"AppStore"
],
"selectedColumns": [
"#account_id",
"#distinct_id",
"accountid"
],
"zoneOffset": 10
}
リクエストパラメータの説明
| $$パラメータ名 | サンプル値 | パラメータタイプ | 必須 | パラメータの説明 |
|---|---|---|---|---|
| projectId | 0 | String | はい | パラメータの説明 |
| eventView | - | Object | はい | パラメータの内容はイベント分析クエリAPIと同じです |
| events | List | はい | パラメータの内容はイベント分析クエリAPIと同じです | |
| sliceDate | "2019-11-26" | String | いいえ | ドリルダウンする日付 |
| sliceGroupVal | ["北京市"] | List | はい | ドリルダウンするグループ |
| eventIndex | 0 | int | はい | ドリルダウンする指標の番号(0から開始) |
| selectedColumns | ["#account_id"] | List | はい | ダウンロードする列 |
| zoneOffset | 10 | Integer | いいえ | タイムゾーン |
リクエストパラメータは、AEシステムのイベント分析ページからパラメータの本体構造を直接エクスポートし、sliceDate、eventIndex、eventDate、sliceGroupVal、selectedColumnsの各パラメータを追加します。具体的なパラメータ値はページのAPIリクエストから取得できます
レスポンス
AEシステムのイベント分析のユーザーリストのダウンロードと同じ
イベント分析の共通列挙値
イベント集計タイプの列挙値
| 値 | 説明 | プロパティが必要か |
|---|---|---|
| TOTAL_TIMES | 合計回数 | いいえ |
| TRIG_USER_NUM | ユニークユーザー数 | いいえ |
| PER_CAPITA_TIMES | 一人当たり回数 | いいえ |
| SUM | 数値の合計 | はい |
| AVG | 数値の平均値 | はい |
| PER_CAPITA_NUM | 一人当たり値 | はい |
| MAX | 数値の最大値 | はい |
| MIN | 数値の最小値 | はい |
| DISTINCT | 重複除外数 | はい |
| TRUE | True totals | はい |
| FALSE | False totals | はい |
| IS_NOT_EMPTY | Not null totals | はい |
| IS_EMPTY | Null totals | はい |
| ARRAY_DISTINCT | リストのユニーク数 | はい |
| ARRAY_SET_DISTINCT | セットのユニーク数 | はい |
| ARRAY_ITEM_DISTINCT | 要素のユニーク数 | はい |
| MEDIAN | 中央値 | はい |
| PERCENTILE | パーセンタイル | はい |

