メインコンテンツまでスキップ

インターバル分析モデル API

最終更新 2026/10/05

呼び出し方法は、Open APIドキュメントの呼び出し方法の説明を参照してください。

マニュアルの インターバル分析 で使用シーンを確認できます。

1. インターバル分析のクエリ​

インターフェースURL

/open/interval-analyze?token=xxx

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー

リクエストBodyパラメータ​

{
"eventView": {
"endTime": "2021-10-05 23:59:59",
"filts": [
{
"columnDesc": "ブランド",
"columnName": "brand",
"comparator": "equal",
"filterType": "SIMPLE",
"ftv": [
"Apple",
"Huawei"
],
"specifiedClusterDate": "2022-01-24",
"tableType": "event",
"timeUnit": ""
}
],
"groupBy": [
{
"columnDesc": "ブランド",
"columnName": "brand",
"propertyRange": "",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
}
],
"recentDay": "114-115",
"relation": "and",
"startTime": "2021-10-04 00:00:00",
"taIdMeasureVo": {
"columnDesc": "ユーザー一意ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day",
"windowsGapUnit": "hour",
"windowsGapValue": 1
},
"events": [
{
"eventName": "activity_attend",
"eventNameDisplay": "",
"filts": [
],
"relation": "and",
"relationProp": {
"property": {
"columnDesc": "ブランド",
"columnName": "brand",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
}
},
"type": "first"
},
{
"eventName": "payment",
"eventNameDisplay": "",
"filts": [
],
"relation": "and",
"relationProp": {
"property": {
"columnDesc": "ブランド",
"columnName": "brand",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
},
"relationOperatorValue": 0,
"relationPropNumberOperator": "r_eq"
},
"type": "second"
}
],
"projectId": 377,
"limit": 10,
"timeoutSeconds": 10,
"useCache": true,
"zoneOffset": 10
}

リクエストパラメータの説明​

$$パラメータ名サンプル値パラメータタイプ必須パラメータの説明
eventView-Objectはい指標の共通プロパティ部分
eventView.endTime2021-10-05 23:59:59Stringいいえ終了時間(形式:yyyy-MM-dd HH:mm:ss)。相対時間が空の場合に有効
eventView.filts-Listいいえグローバルフィルター項目
eventView.filts.columnDescブランドStringいいえフィールドの表示名
eventView.filts.columnNamebrandStringはいフィールド名
eventView.filts.comparatorequalStringはい参考:モデルクエリAPIのフィルター式
eventView.filts.filterTypeSIMPLEStringいいえフィルターモード。SIMPLE:シンプル、COMPOUND:複合
eventView.filts.ftv["Apple"]Listいいえプロパティ比較の境界に使用するリテラル定数
eventView.filts.specifiedClusterDate2022-01-24Stringいいえ指定した日付に対応するタグの履歴バージョン
eventView.filts.tableTypeeventStringはいテーブルタイプの列挙値
eventView.filts.timeUnitStringいいえプロパティ比較値の単位。relativeEvent*の場合のみ有効:day、hour、minute
eventView.groupBy-Listいいえグループ化プロパティ。0個以上指定できます
eventView.groupBy.columnDescブランドStringいいえフィールドの表示名
eventView.groupBy.columnNamebrandStringはいフィールド名
eventView.groupBy.propertyRangeStringいいえカスタムプロパティの区間
eventView.groupBy.specifiedClusterDate2022-01-24Stringいいえ指定した日付に対応するタグの履歴バージョン
eventView.groupBy.tableTypeeventStringはいテーブルタイプの列挙値
eventView.recentDay114-115Stringいいえ相対時間(この項目と開始時間・終了時間を同時に空にすることはできません)
eventView.relationandStringいいえ論理関係。and:論理積、or:論理和
eventView.startTime2021-10-04 00:00:00Stringいいえ開始時間(形式:yyyy-MM-dd HH:mm:ss)。相対時間が空の場合に有効
eventView.taIdMeasureVo-Objectいいえ分析主体の設定
eventView.taIdMeasureVo.columnDescユーザー一意IDStringいいえフィールドの表示名
eventView.taIdMeasureVo.columnName#user_idStringはいフィールド名
eventView.taIdMeasureVo.tableTypeeventStringはいテーブルタイプの列挙値
eventView.timeParticleSizeday

String

はい

分析の時間単位

  • minute:分単位
  • hour:時間単位
  • day:日単位
  • week:週単位
  • month:月単位
  • total:合計
eventView.firstDayOfWeekIntegerいいえtimeParticleSizeがweekの場合に、週の初日を指定します。1:月曜日、2:火曜日、..、7:日曜日。最小1、最大7
eventView.windowsGapUnithourStringいいえウィンドウ期間の単位
eventView.windowsGapValue1Integerいいえウィンドウ期間
events-Listはいイベント指標のリスト
events.eventNameactivity_attendStringはいイベント名。特に、anyEventで任意のイベントを表すことができます
events.eventNameDisplayStringいいえイベント表示名
events.filts-Listいいえ条件リスト
events.relationandStringいいえ論理関係。and:論理積、or:論理和
events.relationProp-Objectいいえ関連プロパティ
events.relationProp.property-Objectいいえ関連プロパティ
events.relationProp.property.columnDescブランドStringいいえフィールドの表示名
events.relationProp.property.columnNamebrandStringいいえフィールド名
events.relationProp.property.specifiedClusterDate2022-01-24Stringいいえ指定した日付に対応するタグの履歴バージョン
events.relationProp.property.tableTypeeventStringいいえテーブルタイプの列挙値
events.relationProp.relationOperatorValue0Integerいいえ関係演算の値
events.relationProp.relationPropNumberOperatorr_eqStringいいえ

関係演算子:

  • r_eq:等しい
  • r_high:高い
  • r_low:低い
events.typefirstStringはいイベントタイプ。first:開始イベント、second:終了イベント
projectId377IntegerはいプロジェクトID
limit10Integerいいえ分析対象ごとのグループ数の上限。任意パラメータで、デフォルトは1000、最大は10000
timeoutSeconds10Integerいいえリクエストのタイムアウトパラメータ。タイムアウトした場合はクエリタスクをキャンセルします
useCachetrueBooleanはいtrueの場合はキャッシュを使用
zoneOffset10Integerいいえタイムゾーン

成功レスポンスの例​

{
"data": {
"distributionInterval": [
",300",
"300,600",
"600,900",
"900,1200",
"1200,1500",
"1500,1800",
"1800,2100",
"2100,2400",
"2400,2700",
"2700,3000",
"3000,3300",
"3300,"
],
"groupCols": [
[
"Apple"
],
[
"Huawei"
]
],
"intervalData": {
"dateEntities": [
{
"dateString": "2021-10-04",
"groupEntities": [
{
"groups": [
"Apple"
],
"intervalAggValue": {
"avgValue": 40,
"eventNum": 6646,
"maxValue": 354,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 838
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 5,
"userNum": 5
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 6641,
"userNum": 838
}
}
]
},
{
"groups": [
"Huawei"
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 5439,
"maxValue": 313,
"midValue": 28,
"minValue": 2,
"quarterValue": 15,
"threeQuarterValue": 50,
"userNum": 683
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 2,
"userNum": 2
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 5437,
"userNum": 683
}
}
]
}
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 12085,
"maxValue": 354,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 1520
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 7,
"userNum": 7
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 12078,
"userNum": 1520
}
}
]
},
{
"dateString": "2021-10-05",
"groupEntities": [
{
"groups": [
"Apple"
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 5700,
"maxValue": 303,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 710
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 1,
"userNum": 1
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 5699,
"userNum": 710
}
}
]
},
{
"groups": [
"Huawei"
],
"intervalAggValue": {
"avgValue": 40,
"eventNum": 4779,
"maxValue": 374,
"midValue": 28,
"minValue": 2,
"quarterValue": 15,
"threeQuarterValue": 51,
"userNum": 603
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 3,
"userNum": 3
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 4776,
"userNum": 603
}
}
]
}
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 10479,
"maxValue": 374,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 50,
"userNum": 1313
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 4,
"userNum": 4
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 10475,
"userNum": 1313
}
}
]
}
],
"groupEntities": [
{
"groups": [
"Apple"
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 12346,
"maxValue": 354,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 1542
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 6,
"userNum": 6
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 12340,
"userNum": 1542
}
}
]
},
{
"groups": [
"Huawei"
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 10218,
"maxValue": 374,
"midValue": 28,
"minValue": 2,
"quarterValue": 15,
"threeQuarterValue": 50,
"userNum": 1282
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 5,
"userNum": 5
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 10213,
"userNum": 1282
}
}
]
}
],
"intervalAggValue": {
"avgValue": 39,
"eventNum": 22564,
"maxValue": 374,
"midValue": 28,
"minValue": 2,
"quarterValue": 16,
"threeQuarterValue": 49,
"userNum": 2817
},
"intervalDistributions": [
{
"distribution": "300,600",
"intervalDistributionValue": {
"eventNum": 11,
"userNum": 11
}
},
{
"distribution": ",300",
"intervalDistributionValue": {
"eventNum": 22553,
"userNum": 2817
}
}
]
},
"intervalType": "def",
"timeArray": [
"2021-10-04",
"2021-10-05"
]
},
"return_code": 0,
"return_message": "success"
}

レスポンスパラメータの説明​

$$パラメータ名サンプル値パラメータタイプパラメータの説明
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ
data-Object戻り値
data.distributionInterval[",300","300,"]List分布の区間
data.groupCols[["Apple"],["Huawei"]]List<List>グループ
data.intervalData-Object日付データ
data.intervalData.dateEntities-List日付リスト
data.intervalData.dateEntities.dateString2021-10-04String日付
data.intervalData.groupEntities-Listグループリスト
data.intervalData.groupEntities.groups["Apple"]Listグループ値リスト
data.intervalData.intervalAggValue-Object集計値
data.intervalData.intervalAggValue.avgValue39Long平均値
data.intervalData.intervalAggValue.eventNum22564Longイベント数
data.intervalData.intervalAggValue.maxValue374Long最大値
data.intervalData.intervalAggValue.midValue28Long中央値
data.intervalData.intervalAggValue.minValue2Long最小値
data.intervalData.intervalAggValue.quarterValue16Long第三四分位値
data.intervalData.intervalAggValue.threeQuarterValue49Long第一四分位値
data.intervalData.intervalAggValue.userNum2817Longユーザー数
data.intervalData.intervalDistributions-List分布区間リスト
data.intervalData.intervalDistributions.distribution300,600String分布区間
data.intervalData.intervalDistributions.intervalDistributionValue-Object分布区間値
data.intervalData.intervalDistributions.intervalDistributionValue.eventNum11Longイベント数
data.intervalData.intervalDistributions.intervalDistributionValue.userNum11Longユーザー数

data.intervalType

defString

タイプ

  • discrete:離散値
  • def:デフォルト区間
  • user_defined:ユーザー定義
data.timeArray["2021-10-04"]Listイベントリスト

エラーレスポンスの例

{
"return_code": -1008,
"return_message": "パラメータ(token)が空です"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-1008Integerリターンコード
return_messageパラメータ(token)が空ですStringリターンメッセージ

2. インターバル分析のフルダウンロード​

インターフェースURL

/open/streaming-download/interval-analyze?token=xxx

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー

リクエストBodyパラメータ​

{
"eventView": {
"endTime": "2022-03-07 17:17:04",
"filts": [],
"groupBy": [],
"recentDay": "1-7",
"relation": "and",
"startTime": "2022-03-01 17:17:04",
"taIdMeasureVo": {
"columnDesc": "User ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day",
"windowsGapUnit": "hour",
"windowsGapValue": 1
},
"events": [{
"eventName": "Login",
"eventNameDisplay": "",
"filts": [],
"relation": "and",
"type": "first"
}, {
"eventName": "Recharge",
"eventNameDisplay": "",
"filts": [],
"relation": "and",
"type": "second"
}],
"projectId": 319,
"format": "AGG_TABLE",
"zoneOffset": 10
}

リクエストパラメータの説明​

$$パラメータ名サンプル値パラメータタイプ必須パラメータの説明
eventView-Objectはい指標の共通プロパティ部分。パラメータの内容はインターバル分析のクエリAPIと同じ
events-Listはいイベント指標のリスト
projectId377IntegerはいプロジェクトID
formatAGG_TABLEStringはい

AGG_TABLE 箱ひげ図をテーブルに変換

DISTRIBUTION_TABLE 分布テーブルに変換

interval[1]arrayいいえすべての区間
zoneOffset10Integerいいえタイムゾーン

レスポンス​

AEシステムのインターバル分析のフルダウンロードと同じ

3. インターバル分析のユーザーリスト​

インターフェースURL

/open/interval-user-list?token=xxx

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー

リクエストBodyパラメータ​

{
"eventView": {
"endTime": "2021-10-05 23:59:59",
"filts": [
{
"columnDesc": "ブランド",
"columnName": "brand",
"comparator": "equal",
"filterType": "SIMPLE",
"ftv": [
"Apple",
"Huawei"
],
"specifiedClusterDate": "2022-01-24",
"tableType": "event",
"timeUnit": ""
}
],
"groupBy": [
{
"columnDesc": "ブランド",
"columnName": "brand",
"propertyRange": "",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
}
],
"recentDay": "114-115",
"relation": "and",
"startTime": "2021-10-04 00:00:00",
"taIdMeasureVo": {
"columnDesc": "ユーザー一意ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day",
"windowsGapUnit": "hour",
"windowsGapValue": 1
},
"events": [
{
"eventName": "activity_attend",
"eventNameDisplay": "",
"filts": [
],
"relation": "and",
"relationProp": {
"property": {
"columnDesc": "ブランド",
"columnName": "brand",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
}
},
"type": "first"
},
{
"eventName": "payment",
"eventNameDisplay": "",
"filts": [
],
"relation": "and",
"relationProp": {
"property": {
"columnDesc": "ブランド",
"columnName": "brand",
"specifiedClusterDate": "2022-01-24",
"tableType": "event"
},
"relationOperatorValue": 0,
"relationPropNumberOperator": "r_eq"
},
"type": "second"
}
],
"projectId": 377,
"timeoutSeconds": 10,
"interval": "2,3",
"sliceDate": "",
"sliceGroupVal": ["Apple", "Huawei"],
"zoneOffset": 10
}

リクエストパラメータの説明​

$$パラメータ名サンプル値パラメータタイプ必須パラメータの説明
eventView-Objectはいパラメータの内容はインターバル分析のクエリAPIと同じ
events-Listはいパラメータの内容はインターバル分析のクエリAPIと同じ
projectId377IntegerはいプロジェクトID
timeoutSeconds10Integerいいえリクエストのタイムアウトパラメータ。タイムアウトした場合はクエリタスクをキャンセルします
interval2,3Stringいいえドリルダウンする区間
sliceDate2021-10-21Stringいいえドリルダウンする日付
sliceGroupVal["Apple", "Huawei"]Listいいえドリルダウンするグループ
zoneOffset10Integerいいえタイムゾーン

成功レスポンスの例​

{
"data": {
"columMeta": {
"country": "国",
"education": "学歴",
"birthdate": "生年月日",
"gender": "性別",
"last_login_time": "last_login_time",
"city": "都市",
"nation": "民族",
"channel": "ユーザー操作タイプ",
"weight": "体重(KG)",
"#distinct_id": "ゲストID",
"firstcharge": "初回チャージ済みか",
"register_time": "register_time",
"#account_id": "アカウントID",
"companynature": "勤務先の種類",
"accountbalance": "残高",
"maritalstatus": "婚姻状況",
"interest": "趣味",
"name": "氏名",
"accountpoint": "ポイント",
"rank": "会員ランク",
"first_login_time": "first_login_time",
"email": "メールアドレス",
"height": "身長(CM)"
},
"datalist": [
{
"country": "中国",
"birthdate": "2013-05-21",
"education": "短大",
"last_login_time": "2021-12-04 02:18:46.111",
"gender": "男性",
"city": "上海市",
"nation": "漢族",
"#user_id": 795692987887919100,
"channel": "WeChat",
"weight": "125",
"#distinct_id": "5694fdd8-e1dc-4459-97dd-33b10df01400",
"firstcharge": false,
"register_time": "2021-10-06 00:00:23.000",
"#account_id": "b406f8a7-424d-4909-a08a-7b00191b7493",
"companynature": "国有企業",
"accountbalance": "42606",
"maritalstatus": "未婚",
"interest": [
"旅行",
"スポーツ",
"スポーツ"
],
"accountpoint": "81910",
"name": "UaLEhzdn",
"rank": "ゴールド",
"first_login_time": "2021-10-06 00:01:56.000",
"email": "ElqqXwdL@thinkingdata.cn",
"height": "174"
},
{
"country": "中国",
"birthdate": "1964-12-26",
"education": "短大",
"last_login_time": "2021-10-05 00:02:35.000",
"gender": "男性",
"city": "上海市",
"nation": "漢族",
"#user_id": 795692395992715300,
"channel": "公式サイト",
"weight": "197",
"#distinct_id": "5caf9f1a-3253-4279-9723-49c950a48020",
"firstcharge": true,
"register_time": "2021-10-05 00:00:30.000",
"#account_id": "cb6ab625-f45d-4977-bbae-973ead82acba",
"companynature": "外資系",
"accountbalance": "49013",
"maritalstatus": "未婚",
"interest": [
"スポーツ",
"歌",
"スポーツ"
]
}
],
"totalNum": 2
},
"return_code": 0,
"return_message": "success"
}

レスポンスパラメータの説明​

$$パラメータ名サンプル値パラメータタイプパラメータの説明
return_code0Integerリターンコード
return_messagesuccessStringリターンメッセージ
data-Object戻り値
data.datalist-List<Map>ユーザー情報
data.columMeta-Mapフィールドの意味のマッピング
data.totalNum2Integer総数

エラーレスポンスの例

{
"return_code": -1008,
"return_message": "パラメータ(token)が空です"
}
パラメータ名サンプル値パラメータタイプパラメータの説明
return_code-1008Integerリターンコード
return_messageパラメータ(token)が空ですStringリターンメッセージ

4. インターバル分析のユーザーリストのダウンロード​

インターフェースURL

/open/streaming-download/interval-user-list?token=xxx

リクエストメソッド

POST

Content-Type

application/json

リクエストQueryパラメータ

パラメータ名サンプル値パラメータタイプ必須パラメータの説明
tokenxxxStringはいクエリキー

リクエストBodyパラメータ​

{
"eventView": {
"endTime": "2022-03-07 17:17:04",
"filts": [],
"groupBy": [],
"recentDay": "1-7",
"relation": "and",
"startTime": "2022-03-01 17:17:04",
"taIdMeasureVo": {
"columnDesc": "User ID",
"columnName": "#user_id",
"tableType": "event"
},
"timeParticleSize": "day",
"windowsGapUnit": "hour",
"windowsGapValue": 1
},
"events": [
{
"eventName": "Login",
"eventNameDisplay": "",
"filts": [],
"relation": "and",
"type": "first"
},
{
"eventName": "Recharge",
"eventNameDisplay": "",
"filts": [],
"relation": "and",
"type": "second"
}
],
"projectId": 319,
"sliceGroupVal": null,
"sliceDate": "2022-03-01",
"selectedColumns": [
"#account_id",
"#distinct_id",
"accountid"
],
"zoneOffset": 10
}

リクエストパラメータの説明​

$$パラメータ名サンプル値パラメータタイプ必須パラメータの説明
eventView-Objectはいパラメータの内容はインターバル分析のクエリAPIと同じ
events-Listはいパラメータの内容はインターバル分析のクエリAPIと同じ
projectId377IntegerはいプロジェクトID
selectedColumns["#account_id"]arrayはいダウンロードする項目
interval2,3Stringドリルダウンする区間
sliceDate2021-10-21Stringいいえドリルダウンする日付
sliceGroupVal["Apple", "Huawei"]Listいいえドリルダウンするグループ
zoneOffset10Integerいいえタイムゾーン

レスポンス​

AEシステムのインターバル分析のユーザーリストのダウンロードと同じ

このページは役に立ちましたか?