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 を使用してインストールされた場合にのみ送信されます。