Microsoft Store 分析 API の次のメソッドを使用して、特定の日付範囲およびその他のオプションフィルター中のアプリの取得、正常性、使用状況のメトリックに関連する分析情報データを取得します。 この情報は、パートナー センターの Insights レポート でも確認できます。
[前提条件]
このメソッドを使用するには、まず次の操作を行う必要があります。
- まだ行っていない場合は、Microsoft Store 分析 API の
前提条件をすべて満たしてください。 - このメソッドの要求ヘッダーで使用する Azure AD アクセス トークン を取得します。 アクセス トークンを取得すると、有効期限が切れるまで 60 分かかります。 トークンの有効期限が切れた後、新しいトークンを取得できます。
リクエスト
リクエスト構文
| メソッド | URI リクエスト |
|---|---|
| 取得する | https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights |
リクエストヘッダー
| ヘッダ | タイプ | 説明 |
|---|---|---|
| 認証 | ひも | 必須。 Bearer<token> 形式の Azure AD アクセス トークン。 |
要求パラメーター
| パラメーター | タイプ | 説明 | 必須 |
|---|---|---|---|
| アプリケーションID | ひも | 分析情報データを取得するアプリの ストア ID。 このパラメーターを指定しない場合、応答本文には、アカウントに登録されているすべてのアプリの分析情報データが含まれます。 | いいえ |
| 開始日 | 日付 | 取得する分析情報データの日付範囲の開始日。 既定値は、現在の日付の 30 日前です。 | いいえ |
| 終了日 | 日付 | 取得する分析情報データの日付範囲の終了日。 既定値は現在の日付です。 | いいえ |
| フィルター | ひも | 応答内の行をフィルター処理する 1 つ以上のステートメント。 各ステートメントには、応答本文のフィールド名と、eq または ne 演算子に関連付けられている値が含まれており、ステートメントは、、、、またはを使用して結合できます。 文字列値は、 フィルター パラメーター内で一重引用符で囲む必要があります。 たとえば、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>
[応答]
応答内容
| 価値 | タイプ | 説明 |
|---|---|---|
| 価値 | 配列 | アプリの分析情報データを含むオブジェクトの配列。 各オブジェクトのデータの詳細については、以下の 「分析情報の値」 セクションを参照してください。 |
| トータルカウント | 整数 (int) | クエリのデータ結果内の行の合計数。 |
分析情報の値
Value 配列内の要素には、次の値が含まれています。
| 価値 | タイプ | 説明 |
|---|---|---|
| アプリケーションID | ひも | 分析情報データを取得するアプリのストア ID。 |
| インサイト日付 | ひも | 特定のメトリックの変更を特定した日付。 この日付は、その前の週と比較してメトリックの大幅な増減が検出された週の終わりを表します。 |
| データタイプ | ひも | この分析情報が説明する一般的な分析領域を指定する次のいずれかの文字列。
|
| インサイト詳細 | 配列 | 現在の分析情報の詳細を表す 1 つ以上の InsightDetail 値 。 |
インサイトディテールの値
| 価値 | タイプ | 説明 |
|---|---|---|
| 事実名 | ひも |
dataType 値に基づいて、現在の分析情報または現在のディメンションが記述するメトリックを示す次のいずれかの値。
|
| サブディメンション | 配列 | 分析情報の 1 つのメトリックを記述する 1 つ以上のオブジェクト。 |
| 変化率 | ひも | 顧客ベース全体でメトリックが変更された割合。 |
| 次元名 | ひも | 現在のディメンションで説明されているメトリックの名前。 たとえば、 EventType、 Market、 DeviceType、 PackageVersion、 AcquisitionType、 AgeGroup 、 Gender などがあります。 |
| ディメンション値 | ひも | 現在のディメンションに記述されているメトリックの値。 たとえば、DimensionName が EventTypeである場合、DimensionValue は クラッシュ あるいは ハングである可能性があります。 |
| 事実の価値 | ひも | 分析情報が検出された日付のメトリックの絶対値。 |
| 方向 | ひも | 変更の方向 (正 または 負)。 |
| 日付 | ひも | 現在の分析情報または現在のディメンションに関連する変更を特定した日付。 |
注
取得された Insights の変更は、過去 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
}
関連トピック
- Insights レポート
- Microsoft Store サービス を使用して分析データにアクセスする