アプリの使用状況 (日単位) の取得

2025-06-10

Microsoft Store 分析 API でこのメソッドを使用すると、特定の期間 (過去 90 日間のみ) および他のオプションフィルターを指定して、集計使用状況データ (Xbox マルチプレーヤーは含めない) を JSON 形式で取得できます。この情報は、パートナーセンターの使用状況レポートでも確認できます。

Anaheim ベースの PWA アプリのテレメトリは、デバイスレベルで収集されます。そのため、ユーザーに関連するメトリックは、このような製品では使用できません。フィールドの有効性の詳細については、以下の「使用状況の値」セクションを参照してください。

前提条件

このメソッドを使うには、最初に次の作業を行う必要があります。

Microsoft Store 分析 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。
このメソッドの要求ヘッダーで使う Azure AD アクセストークンを取得します。アクセストークンを取得した後、アクセストークンを使用できるのは、その有効期限が切れるまでの 60 分間です。トークンの有効期限が切れたら新しいトークンを取得できます。

要求

要求の構文

認証方法	要求 URI
取得する	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily`

要求ヘッダー

ヘッダ	型	説明
承認	ひも	必須。 Bearer<トークン> という形式の Azure AD アクセストークン。

要求パラメーター

パラメーター	型	説明	必須
アプリケーションID	ひも	レビューデータを取得するアプリの Store ID。	はい
開始日	日付	取得するレビューデータの期間の開始日。既定値は現在の日付です。	いいえ
終了日	日付	取得するレビューデータの期間の終了日。既定値は現在の日付です。	いいえ
ページのトップへ	整数 (int)	要求で返すデータの行数です。最大値および指定しない場合の既定値は 10000 です。クエリにこれを上回る行がある場合は、応答本文に次リンクが含まれ、そのリンクを使ってデータの次のページを要求できます。	いいえ
スキップ	整数 (int)	クエリでスキップする行数です。大きなデータセットを操作するには、このパラメーターを使用します。たとえば、top=10000 と skip=0 を指定すると、データの最初の 10,000 行が取得され、top=10000 と skip=10000 を指定すると、データの次の 10,000 行が取得されます。	いいえ
フィルター	ひも	応答内の行をフィルター処理する 1 つまたは複数のステートメントです。各ステートメントでは応答本文のフィールド名と値が eq 演算子または ne 演算子で関連付けられ、ステートメントは and または or を使用して組み合わせることができます。 filter パラメーターでは、文字列値を単一引用符で囲む必要があります。応答本文から次のフィールドを指定できます。市場デバイスタイプパッケージバージョン	いいえ
オーダーバイ (orderby)	ひも	結果データ値の順序を指定するステートメントです。構文は orderby=field [order],field [order],... です。field パラメーターは次のいずれかの文字列になります。日付アプリケーションID アプリケーション名市場パッケージバージョンデバイスタイプの subscriptionName は dailySessionCount ですエンゲージメント時間（分）デイリーアクティブユーザーデイリーアクティブデバイスをする dailyNewUsers をするの月間アクティブユーザー数月間アクティブデバイスをにする月間新規ユーザー毎日の新しいデバイス月次新デバイス order パラメーターは省略可能であり、asc または desc を指定して、各フィールドを昇順または降順にすることができます。既定値は asc です。 orderby 文字列の例: orderby=date,market	いいえ
グループバイ	ひも	指定したフィールドのみにデータ集計を適用するステートメントです。応答本文から次のフィールドを指定できます。アプリケーション名の subscriptionName デバイスタイプパッケージバージョン市場日付返されるデータ行には、groupby パラメーターで指定されたフィールドと、次のものが含まれます。アプリケーションID の subscriptionName は dailySessionCount ですエンゲージメント時間（分）デイリーアクティブユーザーデイリーアクティブデバイスをする dailyNewUsers をするの月間アクティブユーザー数月間アクティブデバイスをにする月間新規ユーザー毎日の新しいデバイス月次新デバイス groupby パラメーターは、aggregationLevel パラメーターと同時に使用できます。例: &groupby=ageGroup,market&aggregationLevel=week	いいえ

要求の例

次の例は、毎日のアプリの使用状況データを取得する要求を示しています。 applicationId 値を、目的のアプリのストア ID に置き換えてください。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily?applicationId=XXXXXXXXXXXX&startDate=2018-08-10&endDate=2018-08-14 HTTP/1.1
Authorization: Bearer <your access token>

[応答]

応答本文

値	型	説明
値	配列	集計使用状況データを含むオブジェクトの配列。各オブジェクトのデータの詳細については、以下の表を参照してください。
@nextLink	ひも	データの追加ページがある場合、この文字列には、データの次のページを要求するために使用できる URI が含まれます。たとえば、要求の top パラメーターが 10000 に設定されていた場合、クエリのレビューデータが 10000 行を超えると、この値が返されます。
トータルカウント	整数 (int)	クエリの結果データ内の行の総数です。

使用状況の値

Value 配列の要素には、次の値が含まれます。

値	型	説明	UWP の可用性	Anaheim ベースの PWA 可用性	Xbox 可用性
日付	ひも	使用状況データの日付範囲の最初の日付。要求に日付を指定した場合、この値はその日付になります。要求に週、月、またはその他の日付範囲を指定した場合、この値はその日付範囲の最初の日付になります。	はい	はい	はい
アプリケーションID	ひも	使用状況データを取得するアプリの Store ID。	はい	はい	はい
アプリケーション名	ひも	アプリの表示名です。	はい	はい	はい
デバイスタイプ	ひも	使用されたデバイスの種類を指定する、以下のいずれかの文字列です。パソコン電話 Console-Xbox 1 Console-Xbox シリーズ X タブレット PC IoTの [サーバー] ホログラフィック不明	はい	はい	はい
パッケージバージョン	ひも	使用されたパッケージのバージョン。	はい	はい	いいえ
市場	ひも	ユーザーがアプリを使用した市場の ISO 3166 国番号。	はい	はい	はい
サブスクリプション名	ひも	Xbox Game Pass 経由の使用かどうかを示します。	はい	いいえ	いいえ
日次セッション数	長い	その日のユーザーセッション数。	はい	はい	はい
エンゲージメント持続時間（分）	倍精度浮動小数点	ユーザーがアプリをアクティブに使用している時間を、アプリの起動時 (プロセスの開始) に始まり、アプリの終了時 (プロセスの終了) または非アクティブな期間の後に終了する個別の期間ごとに測定した値 (分単位)。	はい	はい	はい
デイリーアクティブユーザー	長い	その日にアプリを使用しているユーザー数。	はい	いいえ	はい
デイリーアクティブデバイス	長い	全ユーザーを対象に、アプリの操作に使われた日単位のデバイス数。	はい	はい	はい
毎日の新規ユーザー	長い	その日に初めてアプリを使用したユーザー数。	はい	いいえ	はい
月間アクティブユーザー	長い	その月にアプリを使用しているユーザー数。	はい	いいえ	はい
月間アクティブデバイス	長い	アプリの起動時 (プロセスの開始) に始まり、アプリの終了時 (プロセスの終了) または非アクティブな期間の後に終了する個別の期間にアプリを実行しているデバイス数。	はい	はい	はい
月次新規ユーザー	長い	その月に初めてアプリを使用したユーザー数。	はい	いいえ	はい
毎日新しいデバイス	長い	その日に初めてアプリを使用したデバイスの数。	いいえ	はい	いいえ
月次の新しいデバイス	長い	過去 30 日間に初めてアプリを使用したデバイスの数。	いいえ	はい	いいえ

注

フィールドが特定の製品に対して有効でない場合、それらのフィールドへの値は応答で 0 または null として送信されます。新しいユーザーと新しいデバイスの計算は、3 年のローリングウィンドウで行われます。つまり、ユーザー/デバイスが 3 年以上アプリケーションを使用していない場合は、3 年後に新しいユーザー/デバイスとして扱われます。

要求と応答の例

次のコードスニペットは、これらの要求についての要求と JSON 応答本文の例を示しています。

サンプル要求

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

サンプル応答

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "deviceType": "All",
            "packageVersion": "All",
            "market": "All",
            "dailySessionCount": 6102,
            "engagementDurationMinutes": 75801.0,
            "dailyActiveUsers": 3866,
            "dailyActiveDevices": 3855,
            "dailyNewUsers": 2041,
            "monthlyActiveUsers": 85206,
            "monthlyActiveDevices": 88995,
            "monthlyNewUsers": 63184,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        }
    ],
    "TotalCount": 1
}

サンプル要求

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily?applicationId=9NBLGGGZ5QDR&startDate=06/19/2022&endDate=07/20/2022&top=10&skip=0&groupby=applicationName,subscriptionName,deviceType,packageVersion,market,date

HTTP/1.1
Authorization: Bearer <your access token>

サンプル応答

{
    "Value": [
        {
            "date": "2022-07-11",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "1.4.0.17837",
            "market": "BR",
            "dailySessionCount": 1,
            "engagementDurationMinutes": 35.2,
            "dailyActiveUsers": 1,
            "dailyActiveDevices": 1,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-07-04",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AD",
            "dailySessionCount": 1,
            "engagementDurationMinutes": 2.7,
            "dailyActiveUsers": 1,
            "dailyActiveDevices": 1,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-24",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AE",
            "dailySessionCount": 2,
            "engagementDurationMinutes": 2.9,
            "dailyActiveUsers": 1,
            "dailyActiveDevices": 1,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 2,
            "monthlyActiveDevices": 2,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-07-08",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AE",
            "dailySessionCount": 1,
            "engagementDurationMinutes": 0.5,
            "dailyActiveUsers": 1,
            "dailyActiveDevices": 1,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 2,
            "monthlyActiveDevices": 2,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-26",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AO",
            "dailySessionCount": 1,
            "engagementDurationMinutes": 1.2,
            "dailyActiveUsers": 1,
            "dailyActiveDevices": 1,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-19",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AR",
            "dailySessionCount": 1,
            "engagementDurationMinutes": 1.0,
            "dailyActiveUsers": 1,
            "dailyActiveDevices": 1,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 40,
            "monthlyActiveDevices": 40,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-20",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AR",
            "dailySessionCount": 2,
            "engagementDurationMinutes": 10.9,
            "dailyActiveUsers": 2,
            "dailyActiveDevices": 2,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 42,
            "monthlyActiveDevices": 42,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AR",
            "dailySessionCount": 6,
            "engagementDurationMinutes": 32.8,
            "dailyActiveUsers": 3,
            "dailyActiveDevices": 3,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 44,
            "monthlyActiveDevices": 43,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AR",
            "dailySessionCount": 1,
            "engagementDurationMinutes": 0.1,
            "dailyActiveUsers": 1,
            "dailyActiveDevices": 1,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 43,
            "monthlyActiveDevices": 42,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-23",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AR",
            "dailySessionCount": 2,
            "engagementDurationMinutes": 0.3,
            "dailyActiveUsers": 2,
            "dailyActiveDevices": 2,
            "dailyNewUsers": 0,
            "monthlyActiveUsers": 42,
            "monthlyActiveDevices": 42,
            "monthlyNewUsers": 0,
            "dailyNewDevices": 0,
            "monthlyNewDevices": 0
        }
    ],
    "@nextLink": "usagedaily?applicationId=9NBLGGGZ5QDR&startDate=2022/06/19&endDate=2022/07/21&groupby=applicationName,subscriptionName,deviceType,packageVersion,market,date&top=10&skip=10",
    "TotalCount": 765
}

次の方法で共有

アプリの使用状況 (日単位) の取得

前提条件

要求

要求の構文

要求ヘッダー

要求パラメーター

要求の例

[応答]

応答本文

使用状況の値

要求と応答の例

サンプル要求

サンプル応答

サンプル要求

サンプル応答

関連トピック

フィードバック

その他のリソース