Analytics の FAQ
重要
Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。
データはサンプリングされていますか?
データはサンプリングされません。 分析では、送信されたすべてのデータが使用されます。誤った形式で送信された場合や、既知の制限に達した場合を除きます。
送信されたログと Analytics ダッシュボードでのその表現の間の待機時間は何ですか?
通常、待機時間は数分です。
アプリがオフラインの場合、SDK はログを格納し、オンラインに戻ったら送信しますか?
はい。 ネットワーク接続がない場合、SDK は最大 10 MB (既定) のログをローカル ストレージに保存します。 ストレージ サイズは API を使用して setMaxStorageSize 変更できます。 ストレージがいっぱいになると、SDK は古いログの破棄を開始して、新しいログ用のスペースを作ります。 ネットワーク接続が復元されると、SDK によってこれらのログが App Center バックエンドに送信されます。
セッション期間が不明です。理由は何ですか?
セッションは、アプリがフォアグラウンドから最後のイベントまでバックグラウンドに移動するまでの時間として定義されます。 セッションで 5 分以内にカスタム イベントが識別されない場合、セッションはカウントされません。
インストール数よりも多くのデバイスが表示されている "OS ディストリビューション" グラフが表示されるのはなぜですか?
OS ディストリビューションの数はスナップショットではありません。 選択した期間に一致するデバイスの数です。 たとえば、ユーザーが選択した期間内に 1 つの OS バージョンから新しいバージョンにアップグレードした場合、両方の OS バージョンでカウントされます。 期間内にアップグレードするユーザーの数が多い場合、重複すると、インストール数よりも "OS ディストリビューション" グラフに表示されるデバイスの数が著しく多くなることがあります。
国/地域の情報が表示されないのはなぜですか? / 国/地域の情報が正しくないようです。
国/地域は通信事業者の国/地域によって決定され、デバイスに SIM が必要です。 SIM カードのないタブレットまたはデバイスを使用している場合、国/地域は報告されません。 シミュレーターを使用している場合、国/地域の情報はおそらく正確ではありません。
アプリごとに送信できる個別のイベントの最大数は何ですか?
Analytics の場合、1 日に追跡する個別のカスタム イベントの最大数は 200 です。 カウントは毎日午前 12 時 (UTC) にリセットされます。 ただし、デバイスごとに送信されるイベント インスタンスの最大数に制限はありません。
1 日に 200 個の個別のイベントの制限は 、エクスポートには適用されません。 Analytics で追跡しない場合でも、受け入れるすべてのログをエクスポートします。
イベントごとに定義できるイベント プロパティの最大数は何ですか? 制限を超える数を送信するとどうなりますか?
現在、イベント プロパティの最大数は 20 に設定されています。 20 を超えるプロパティが送信されると、自動的に拒否されます。
イベントごとに送信できるプロパティ値の最大数は何ですか?
カウントが最も多い 10 個のプロパティ値の数が表示されます。
ログ フローにデータが表示されないのはなぜですか?
ログ フロー ページには、受信したログが表示されます。 ログフローの表示を開始するには、ログ フロー ページを開き、アプリからのログの送信を開始する必要があります。
生データをエクスポートできますか?
はい。 アプリ設定では、すべての Analytics 生データを Azure Blob Storage と Application Insights にエクスポートできます。
App Center にログを送信する期間の制限は何ですか?
App Center バックエンドは、過去 25 日以内または将来 3 日間以下のログのみを受け入れます。
Analytics API start と end パラメーターに対する応答の粒度はどのくらいですか?
Analytics API は 、日別にカウンターを返します。 言い換えると、入力の時間部分は無視され、結果が処理されるときに日コンポーネントのみが考慮されます。
分析イベント、セッション、その他の分析データで UserId の値が "なし" である理由
ユーザー ID は、現時点では診断 (クラッシュ、エラー) にのみ適用できます。
回避策は、次に示すように、userId を [プロパティ] に追加することです。
Map<String, String> properties = new HashMap<>();
properties.put("UserId", "your user Id");
Analytics.trackEvent("EventName", properties);