# モデルクエリAPI

このドキュメントに記載されている内容は、TEの高度な使用機能に属しており、関連する機能の経験を持つユーザーの参照に適しています。ドキュメントの内容に疑問がある場合は、データコンサルタントに1対1のサポートを依頼してください。

モデルクエリAPIは、主にさまざまなデータ分析レポートを取得するために使用されます。

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

# 一、共通パラメータ

# プロパティ表現

ほとんどすべてのAPIは、フィルタリング、グループ化、集約などの属性を使用します。属性には、イベント属性、ユーザー属性、ユーザーサブグループ属性が含まれ、属性は通常、名前とテーブルタイプの2つのフィールドで表現されます。たとえば、州のイベント属性を表す式は次のとおりです。

{
    "tableType":"event",
    "columnName":"#province"
}

ユーザー属性も同様です。たとえば、ユーザーレベルを表します。

{
    "tableType":"user",
    "columnName":"user_level"
}

# フィルター式

フィルター式は、ほとんどのAPIにも適用され、次の形式のJSONを使用して、特定のイベントまたはユーザーのフィルター操作を表します

{
  // 表示 filts 里的各个条件的关系是 或 还是 且
  "relation": "and",
  // 具体的条件列表，可以有多个
  "filts": [{
    // 条件的左值，是一个属性
    "tableType":"event",
    "columnName": "#os",
    // 条件的比较符，这里表示等于
    "comparator": "equal",
    // 条件的比较值，根据不同的比较符可以有一个或者多个
    "ftv": [
      "ios"
    ]
  },
  {
    "tableType":"user",
    "columnName":"user_level",
    "comparator": "equal",
    "ftv": [
      "5"
    ]
  }]
}

現在サポートされている演算子は次のとおりです。

equal / notEqual

は等しい/等しくないことを表し、文字列、数値型に有効です。ftvが複数ある場合はInまたはNot Inに相当する。例えば、レベル3と4のユーザーを選別したい:

{
    "tableType":"user",
    "columnName":"user_level",
    "comparator": "equal",
    "ftv": ["3","5"]
}

isTrue/isFalse

ブール型にのみ有効です。

isNull/not Null

プロパティに値があるかどうかは、文字列、数値タイプに有効です。

include / notInclude

子文字列を含むか含まないかを表します:

{
    "tableType":"user",
    "columnName":"channel",
    "comparator": "include",
    "ftv": ["应用宝"]
}

less/greater/range:より小さい/より大きい/より小さい、より大きいを表し、rangeは前閉後閉の区間で、対数値タイプと時間タイプが有効である。たとえば、アイテムの残りの数が3から9の間のすべてのイベントをフィルター処理します。

{
    "tableType":"event",
    "columnName":"count_left",
    "comparator": "range",
    "ftv": [3, 9]
}

または、最後のログイン時間が2019-11-13 00:00~2019-11-23 00:00の間のすべてのユーザーを選別します

{
    "tableType":"user",
    "columnName":"latest_login_time",
    "comparator": "range",
    "ftv":["2019-11-13 00:00","2019-11-23 00:00"]
}

regex Match/not Regex Match

正則一致または正則不一致は、文字列タイプにのみ有効です。

relativeCurrentBetween / relativeCurrentBefore

日付タイプの演算子は、相対現在時刻が過去N日から過去M日の間/相対現在時刻が過去N日前であることをそれぞれ示す。たとえば、過去3日前に現在の時間に対してすべての登録時間をフィルタリングしたいユーザー:

{
    "tableType":"user",
    "columnName":"register_time",
    "comparator": "relativeCurrentBefore",
    "ftv": [3]
}

または、すべての登録時間が現在の時間に対して過去9日から過去3日間のユーザーを選別します

{
    "tableType":"user",
    "columnName":"register_time",
    "comparator": "relativeCurrentBetween",
    "ftv": [9, 3]
}

relativeEventBefore / relativeEventAfter / relativeEventAbsolute

日付タイプの演算子は、相対イベント発生時刻が前N時間以内/相対イベント発生時刻が後N時間以内/相対イベント発生時刻が前後N時間以内であることをそれぞれ示す。たとえば、ユーザーの前回のログイン時間がイベント発生時刻より3時間以内のイベントを選別したい

{
    "tableType":"user",
    "columnName":"latest_login_time",
    "comparator": "relativeEventBefore",
    "ftv": [3],
    "timeUnit": "hour"
}

array InCludeItem/array Not InCludeIection

リストに要素が含まれているかどうかを示すリスト型の演算子

arrayItemPos

リスト型の演算子で、リストのn番目の要素がある値

array IsNull/array NotNull

リストが存在するかどうかを示すリスト型の演算子