英語で読む

次の方法で共有


App Center SDK によって収集されるデータ

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

サポートタイムラインと代替手段の詳細については、こちらを参照してください。

App Center SDK は、App Center サービスにデータを送信します。 送信されるデータは、アプリケーションによって処理されるデータで使用される SDK/サービス、SDK の構成方法、クラッシュ サービスによって異なります。 一部のサービスを使用するには、サービスを機能させるために特定のデータを送信する必要があります。 App Center に送信されるすべてのデータは、中央インジェスト サービスを経由します。

共通データ

SDK からインジェストへの要求ヘッダーを介して送信されるデータ

必須データ – App-Secret、Install-ID

  • アプリケーション シークレット (App-Secret) アプリケーションを識別するために使用される一意のキー。

  • インストール識別子 (Install-ID) App Center SDK を使用してアプリをインストールするたびに、新しい一意のインストール識別子が作成されます。 この ID は、データを一意のデバイスと区別するために使用されます。 App Center サービスでは、ID が正しく機能する必要があります。

SDK からインジェストへの要求本文を通じて送信されるデータ

必須データ - sdkName、sdkVersion、osName、osVersion、locale、timeZoneOffset、appVersion、appBuild

  • Timestamp (timestamp) ログ タイムスタンプ(例: '2017-03-13T18:05:42Z'

  • セッション識別子 (sid) 分析ログは、この識別子を指定することで、同じセッションに含めることができます。

  • ユーザー識別子 (userId) ログをユーザーに関連付けするために使用される省略可能な文字列。

  • SDK 名 (sdkName) SDK の名前。 SDK とプラットフォームの名前 ("appcenter.ios"、"hockeysdk.android" など) で構成されます

  • SDK バージョン (sdkVersion) semver 形式の SDK のバージョン ("1.2.0" や "0.12.3-alpha.1" など)

  • SDK ラッパー バージョン (wrapperSdkVersion) semver 形式のラッパー SDK のバージョン。 SDK がベース SDK をラップすると、ラップする SDK バージョンがこのフィールドにキャプチャされ、ベース SDK バージョンは sdkVersion になります。 たとえば、Xamarin.Android はネイティブ Android をラップします。

  • SDK ラッパー名 (wrapperSdkName) ラッパー SDK の名前。 SDK とラッパー プラットフォームの名前 ("appcenter.xamarin"、"hockeysdk.cordova" など) で構成されます。

  • モデル (モデル) デバイス モデル (例: iPad2,3)

  • OEM 名 (oemName) デバイスの製造元の名前 (例:HTC)

  • オペレーティング システム名 (osName) OS 名 (例: iOS)

  • オペレーティング システムのバージョン (osVersion) OS バージョン (例: 9.3.0)

  • オペレーティング システム ビルド コード (osBuild) OS ビルド コード (例: LMY47X)

  • オペレーティング システム API レベル (osApiLevel) Android のように該当する場合の API レベル (例: 15)

  • 言語と国コード (ロケール) ISO 言語と国コード (例: en-US)

  • タイム ゾーン オフセット (timeZoneOffset) 夏時間を含む、デバイスのタイム ゾーンの UTC からのオフセット (分単位)。

  • 画面サイズ (screenSize) デバイス画面のサイズをピクセル単位で指定します (例: 640 x 480)。

  • アプリケーション バージョン (appVersion) 通常、メジャー、マイナー、ビルドのアプリケーションのバージョン (例: 1.1.42)

  • 通信事業者名 (carrierName) セル サービス プロバイダーの名前。

  • 運送業者の国 (carrierCountry) セル サービス プロバイダーの国。

  • アプリケーション ビルド (appBuild) アプリのビルド番号。 (例: 42)

  • アプリケーション名前空間 (appNamespace) 個々のプラットフォームで使用される内容に応じて、バンドル識別子、パッケージ識別子、または名前空間 (例: com.microsoft.example)

  • Live Update Release Label (liveUpdateReleaseLabel) デバイスで実行されている Live Update ビーコンを介してリリースされたアプリケーション コード 'バージョン' を識別するために使用されるラベル。

  • Live Update Deployment Key (liveUpdateDeploymentKey) 現在のアプリケーション リリースが属している環境の識別子。デプロイ キーは、運用環境、ステージング環境などの環境にマップされます。

  • Live Update パッケージ ハッシュ (liveUpdatePackageHash) LiveUpdate ビーコンを介してデバイスにデプロイされたすべてのファイル (ReactNative または Cordova) のハッシュ。 デバイスのリリース バージョンを特定したり、今後更新プログラムをダウンロードする必要がある場合に役立ちます

  • ランタイム ラッパー バージョン (wrapperRuntimeVersion) ラッパー テクノロジ フレームワークのバージョン (Xamarin ランタイム バージョン、ReactNative、Cordova など)。 このバージョンが Xamarin または ReactNative またはその他を参照しているかどうかを確認するには、wrappersdkname を参照してください。

  • 脱獄 (脱獄) デバイスが脱獄されたかどうかを示すフラグ。

分析

  • エンゲージメント メトリック エンゲージメントは、ユーザーごとの毎日のセッションとセッション期間を測定します。

    • ユーザーあたりの毎日のセッション数: 1 ユーザーあたりのセッションの 1 日あたりの平均数。

    • [合計セッション数]: セッションの合計数。

    • 1 日あたりの平均セッション数: 時間範囲で平均された 1 日あたりのセッション数。

    • セッション期間: いくつかの期間の間隔でのセッション数の分布。

    • [平均セッション長]: 選択した時間範囲内のすべてのセッション期間の平均。

  • イベント メトリック 最大 20 個のプロパティを使用して独自の イベント メトリック を追跡して、ユーザーとアプリの間の相互作用を把握できます。

診断

  • クラッシュログとエラーログデータ このデータには、クラッシュに関連するプロセス、スレッド、フレームの ID と名前、および「共通データ」セクションで定義されている例外の種類とメッセージとデバイス のデータが含まれます

  • クラッシュ添付ファイル これらの添付ファイルは、開発者が必要に応じてクラッシュ レポートに添付できるバイナリ ファイルまたはテキスト ファイルです。

  • カスタム プロパティ これらのカスタム キー値のペアを必要に応じて指定して、エラー レポートにコンテキストを追加できます。

  • クラッシュとエラーのユーザー ID この一意識別子は、必要に応じて、クラッシュ レポートに特定のユーザーの ID をアタッチするように開発者によって設定されます。

  • シンボル ファイル これらのシンボル ファイルは、クラッシュをシンボル化するために App Center の開発者によって提供されます。

配布

  • トークンこの GUID は、アプリケーションの新しいバージョンのチェックに配布サービスに送信されます。 GUID は、アプリケーションが App Center を使用してインストールされた場合にのみ送信されます。