インサイト データを取得する
Microsoft Store 分析 API でこのメソッドを使うと、日付範囲とその他のオプション フィルターを指定して、アプリの取得、正常性、使用量のメトリックに関連するインサイト データを取得できます。 この情報は、パートナー センターのインサイト レポートでも確認できます。
前提条件
このメソッドを使うには、最初に次の作業を行う必要があります。
- Microsoft Store 分析 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。
- このメソッドの要求ヘッダーで使う Azure AD アクセス トークンを取得します。 アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。 トークンの有効期限が切れたら新しいトークンを取得できます。
要求
要求の構文
| 認証方法 | 要求 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights |
要求ヘッダー
| Header | 種類 | 説明 |
|---|---|---|
| 承認 | string | 必須。 Bearer<トークン> という形式の Azure AD アクセス トークン。 |
要求パラメーター
| パラメーター | 種類 | 説明 | 必須 |
|---|---|---|---|
| applicationId | string | インサイト データを取得するアプリのストア ID。 このパラメーターを指定しない場合、応答本文には、アカウントに登録されているすべてのアプリのインサイト データが含まれます。 | No |
| startDate | 日付 | 取得する分析情報データの日付範囲の開始日です。 既定値は、現在の日付の 30 日前です。 | いいえ |
| endDate | 日付 | 取得する分析情報データの日付範囲の終了日です。 既定値は現在の日付です。 | いいえ |
| filter | string | 応答内の行をフィルター処理する 1 つまたは複数のステートメントです。 各ステートメントには、応答本文からのフィールド名、および eq 演算子または ne 演算子と関連付けられる値が含まれており、and や or を使用してステートメントを組み合わせることができます。 filter パラメーターでは、文字列値を単一引用符で囲む必要があります。 たとえば、filter=dataType eq 'acquisition' です。 次のフィルター フィールドを指定できます。
|
はい |
要求の例
次の例は、インサイト データを取得する要求を示しています。 applicationId 値を、目的のアプリのストア ID に置き換えてください。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'acquisition' or dataType eq 'health' HTTP/1.1
Authorization: Bearer <your access token>
[応答]
応答本文
| 値 | 種類 | 説明 |
|---|---|---|
| 値 | array | アプリの分析情報データを含むオブジェクトの配列です。 各オブジェクトのデータの詳細については、後の「分析情報の値」セクションを参照してください。 |
| TotalCount | int | クエリの結果データ内の行の総数です。 |
分析情報の値
Value 配列の要素には、次の値が含まれます。
| 値 | 種類 | 説明 |
|---|---|---|
| applicationId | string | インサイト データを取得するアプリのストア ID。 |
| insightDate | string | 特定のメトリックの変化を特定した日付です。 この日付は、前の週と比較してメトリックの大幅な増減が検出された週の終わりを表します。 |
| dataType | string | 次の文字列のいずれか。このインサイトに記述する全般的な分析領域を指定します。
|
| insightDetail | array | 現在の分析情報の詳細を表す 1 つ以上の InsightDetail 値です。 |
InsightDetail 値
| 値 | 種類 | 説明 |
|---|---|---|
| FactName | string | 次の値のいずれか。dataType 値に基づいて、現在のインサイトまたは現在のディメンションに記述するメトリックを示します。
|
| SubDimensions | array | 分析情報の 1 つのメトリックを記述する 1 つ以上のオブジェクトです。 |
| PercentChange | string | 顧客ベース全体でメトリックが変化した割合です。 |
| DimensionName | string | 現在のディメンションに記述されているメトリックの名前。 たとえば、EventType、Market、DeviceType、PackageVersion、AcquisitionType、AgeGroup、Gender などです。 |
| DimensionValue | string | 現在のディメンションに記述されているメトリックの値です。 たとえば、DimensionName が EventType の場合、DimensionValue は crash や hang などになります。 |
| FactValue | string | 分析情報が検出された日付のメトリックの絶対値です。 |
| 方向 | string | 変化の方向です (Positive または Negative)。 |
| Date | string | 現在の分析情報または現在のディメンションに関連する変化が特定された日付です。 |
注意
取得された分析情報の変更は、過去 30 日間の取得、正常性、使用状況データに対してのみ行われます。
要求と応答の例
次のコード スニペットは、これらの要求の要求と JSON 応答本文の例を示しています。
要求のサンプル
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=7/12/2022&endDate=7/29/2022&filter=dataType eq 'acquisition' or dataType eq 'health'
HTTP/1.1
Authorization: Bearer <your access token>
応答のサンプル
{
"Value": [
{
"id": "8cdb672c7893bd33a3dec48ededdc676602a1361f3209ab4f3e0982672fc198f",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-27T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-27 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-27 00:00:00",
"Direction": "Positive",
"PercentChange": 16.091954022988507,
"FactName": "AcquisitionQuantity",
"FactQuantity": 28.0
}
]
}
]
},
{
"id": "6b8849ecb043c6e5ecdd1c20040c0a371e9ab176eff77f7312b0489e19379225",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-26T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-26 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-26 00:00:00",
"Direction": "Positive",
"PercentChange": 28.048780487804876,
"FactName": "AcquisitionQuantity",
"FactQuantity": 30.0
}
]
}
]
},
{
"id": "93115e855fec507385bab17251f49c33bcbc1b62c603e5c7863e327ba94bf160",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-20T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-20 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "GB",
"Date": "2022-07-20 00:00:00",
"Direction": "Negative",
"PercentChange": 3.3035714285714284,
"FactName": "AcquisitionQuantity",
"FactQuantity": 158.0
}
]
}
]
},
{
"id": "4814abe710042a2798b453d8821909c246c389dde814e6678da7189211410604",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-24T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-24 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "DO",
"Date": "2022-07-24 00:00:00",
"Direction": "Negative",
"PercentChange": 13.533834586466165,
"FactName": "AcquisitionQuantity",
"FactQuantity": 8.0
}
]
}
]
},
{
"id": "7941070bb17904f3ef4e19de9659110cb52e18ecfb637ad724e2da749445a860",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-21T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "AT",
"Date": "2022-07-21 00:00:00",
"Direction": "Positive",
"PercentChange": 0.0,
"FactName": "AcquisitionQuantity",
"FactQuantity": 17.0
}
]
},
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "SE",
"Date": "2022-07-21 00:00:00",
"Direction": "Negative",
"PercentChange": 21.686746987951807,
"FactName": "AcquisitionQuantity",
"FactQuantity": 5.0
}
]
}
]
},
{
"id": "55905f5458617b65669eb115cc28ebd7296841bd2ff3f8e2546ade1d5e93f68d",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-13T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-13 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "LK",
"Date": "2022-07-13 00:00:00",
"Direction": "Negative",
"PercentChange": 11.111111111111111,
"FactName": "AcquisitionQuantity",
"FactQuantity": 9.0
}
]
}
]
},
{
"id": "9ce9317bf4d0f903de51a49d00a07cf4b4a8ac4457fd1e2886493bd38ceac0b7",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-19T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "Acquisition",
"DimensionValue": "Free",
"Date": "2022-07-19 00:00:00",
"Direction": "Negative",
"PercentChange": 12.188725230475788,
"FactName": "AcquisitionQuantity",
"FactQuantity": 2470,
"SubDimensions": []
}
]
}
],
"TotalCount": 7
}
関連トピック
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示