Windows デスクトップ アプリケーション プログラムに追加したデスクトップ アプリケーションの正常性メトリックに関連する分析情報データを取得するには、Microsoft Store 分析 API の次のメソッドを使用します。 このデータは、パートナー センターのデスクトップ アプリケーションの 正常性レポート でも使用できます。
[前提条件]
このメソッドを使用するには、まず次の操作を行う必要があります。
- まだ行っていない場合は、Microsoft Store 分析 API の
前提条件をすべて満たしてください。 - このメソッドの要求ヘッダーで使用する Azure AD アクセス トークン を取得します。 アクセス トークンを取得すると、有効期限が切れるまで 60 分かかります。 トークンの有効期限が切れた後、新しいトークンを取得できます。
リクエスト
リクエスト構文
メソッド | URI リクエスト |
---|---|
取得する | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights |
リクエストヘッダー
ヘッダ | タイプ | 説明 |
---|---|---|
認証 | ひも | 必須。 Bearer<token> 形式の Azure AD アクセス トークン。 |
要求パラメーター
パラメーター | タイプ | 説明 | 必須 |
---|---|---|---|
アプリケーションID | ひも | 分析情報データを取得するデスクトップ アプリケーションの製品 ID。 デスクトップ アプリケーションの製品 ID を取得するには、パートナー センター でデスクトップ アプリケーションの |
いいえ |
開始日 | 日付 | 取得する分析情報データの日付範囲の開始日。 既定値は、現在の日付の 30 日前です。 | いいえ |
終了日 | 日付 | 取得する分析情報データの日付範囲の終了日。 既定値は現在の日付です。 | いいえ |
フィルター | ひも | 応答内の行をフィルター処理する 1 つ以上のステートメント。 各ステートメントには、応答本文のフィールド名と、eq または ne 演算子に関連付けられている値が含まれており、ステートメントは、、、、またはを使用して結合できます。 文字列値は、 フィルター パラメーター内で一重引用符で囲む必要があります。 たとえば、filter=dataType eq 'acquisition'。
現在、このメソッドは 正常性フィルターのみをサポートしています。 |
いいえ |
要求の例
次の例は、分析情報データを取得するための要求を示しています。 applicationId の値を、デスクトップ アプリケーションの適切な値に置き換えます。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights?applicationId=10238467886765136388&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'health' HTTP/1.1
Authorization: Bearer <your access token>
[応答]
応答内容
価値 | タイプ | 説明 |
---|---|---|
価値 | 配列 | アプリの分析情報データを含むオブジェクトの配列。 各オブジェクトのデータの詳細については、以下の 「分析情報の値」 セクションを参照してください。 |
トータルカウント | 整数 (int) | クエリのデータ結果内の行の合計数。 |
分析情報の値
Value 配列内の要素には、次の値が含まれています。
価値 | タイプ | 説明 |
---|---|---|
アプリケーションID | ひも | 分析情報データを取得したデスクトップ アプリケーションの製品 ID。 |
インサイト日付 | ひも | 特定のメトリックの変更を特定した日付。 この日付は、その前の週と比較してメトリックの大幅な増減が検出された週の終わりを表します。 |
データタイプ | ひも | この分析情報が通知する一般的な分析領域を指定する文字列。 現時点では、このメソッドは 健康のみに対応しています。 |
インサイト詳細 | 配列 | 現在の分析情報の詳細を表す 1 つ以上の InsightDetail 値 。 |
インサイトディテールの値
価値 | タイプ | 説明 |
---|---|---|
事実名 | ひも | 現在の分析情報または現在のディメンションが記述するメトリックを示す文字列。 現在、このメソッドは 値 HitCount のみをサポートしています。 |
サブディメンション | 配列 | 分析情報の 1 つのメトリックを記述する 1 つ以上のオブジェクト。 |
変化率 | ひも | 顧客ベース全体でメトリックが変更された割合。 |
次元名 | ひも | 現在のディメンションで説明されているメトリックの名前。 たとえば、 EventType、 Market、 DeviceType、 PackageVersion などがあります。 |
ディメンション値 | ひも | 現在のディメンションに記述されているメトリックの値。 たとえば、DimensionName が EventTypeである場合、DimensionValue は クラッシュ あるいは ハングである可能性があります。 |
事実の価値 | ひも | 分析情報が検出された日付のメトリックの絶対値。 |
方向 | ひも | 変更の方向 (正 または 負)。 |
日付 | ひも | 現在の分析情報または現在のディメンションに関連する変更を特定した日付。 |
応答の例
次の例は、この要求の JSON 応答本文の例を示しています。
{
"Value": [
{
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2018-06-03T00:00:00",
"dataType": "health",
"insightDetail": [
{
"FactName": "HitCount",
"SubDimensions": [
{
"FactName:": "HitCount",
"PercentChange": "21",
"DimensionValue:": "DE",
"FactValue": "109",
"Direction": "Positive",
"Date": "6/3/2018 12:00:00 AM",
"DimensionName": "Market"
}
],
"DimensionValue": "crash",
"Date": "6/3/2018 12:00:00 AM",
"DimensionName": "EventType"
},
{
"FactName": "HitCount",
"SubDimensions": [
{
"FactName:": "HitCount",
"PercentChange": "71",
"DimensionValue:": "JP",
"FactValue": "112",
"Direction": "Positive",
"Date": "6/3/2018 12:00:00 AM",
"DimensionName": "Market"
}
],
"DimensionValue": "hang",
"Date": "6/3/2018 12:00:00 AM",
"DimensionName": "EventType"
},
],
"insightId": "9CY0F3VBT1AS942AFQaeyO0k2zUKfyOhrOHc0036Iwc="
}
],
"@nextLink": null,
"TotalCount": 2
}
関連トピック
- Windows デスクトップ アプリケーション プログラム
- 健康報告書
- Microsoft Store サービス を使用して分析データにアクセスする