App Center と Application Insights によるモバイル アプリの分析の開始Start analyzing your mobile app with App Center and Application Insights

このクイックスタート ガイドでは、アプリの App Center インスタンスを Application Insights に接続する手順を説明します。This quickstart guides you through connecting your app's App Center instance to Application Insights. Application Insights を使用すると、App Center の Analytics サービスで提供されているツールよりも強力なツールを利用して、テレメトリのクエリ、セグメント化、フィルター、分析を実行できます。With Application Insights, you can query, segment, filter, and analyze your telemetry with more powerful tools than are available from the Analytics service of App Center.

前提条件Prerequisites

このクイック スタートを完了するには、次のものが必要です。To complete this quickstart, you need:

  • Azure サブスクリプション。An Azure subscription.
  • iOS、Android、Xamarin、Universal Windows、または React Native アプリ。An iOS, Android, Xamarin, Universal Windows, or React Native app.

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。If you don't have an Azure subscription, create a free account before you begin.

App Center にサインアップするSign up with App Center

まず、アカウントを作成し、App Center にサインアップします。To begin, create an account and sign up with App Center.

App Center へのオンボードOnboard to App Center

モバイル アプリで Application Insights を使用する前に、アプリを App Center にオンボードする必要があります。Before you can use Application Insights with your mobile app, you need to onboard your app to App Center. Application Insights は、モバイル アプリから直接テレメトリを受信しません。Application Insights does not receive telemetry from your mobile app directly. その代わりに、アプリが App Center にカスタム イベント テレメトリを送信します。Instead, your app sends custom event telemetry to App Center. App Center は、イベントを受信すると、これらのカスタム イベントのコピーを Application Insights に継続的にエクスポートします。Then, App Center continuously exports copies of these custom events into Application Insights as the events are received. (このことは、テレメトリが Application Insights に直接送信される Application Insights JS SDK または React Native プラグインには適用されません)。(This does not apply to the Application Insights JS SDK or the React Native plugin where telemetry is sent directly to Application Insights.)

アプリをオンボードするには、アプリでサポートされている各プラットフォームの App Center クイックスタートに従ってください。To onboard your app, follow the App Center quickstart for each platform your app supports. プラットフォームごとに個別の App Center インスタンスを作成します。Create separate App Center instances for each platform:

アプリでのイベントの追跡Track events in your app

アプリを App Center にオンボードしたら、App Center SDK を使用して、カスタム イベント テレメトリを送信するようにアプリを変更する必要があります。After your app is onboarded to App Center, it needs to be modified to send custom event telemetry using the App Center SDK. カスタム イベントは、Application Insights にエクスポートされる唯一の種類の App Center テレメトリです。Custom events are the only type of App Center telemetry that is exported to Application Insights.

iOS アプリからカスタム イベントを送信するには、App Center SDK の trackEvent または trackEvent:withProperties メソッドを使用します。To send custom events from iOS apps, use the trackEvent or trackEvent:withProperties methods in the App Center SDK. 詳しくは、iOS アプリからのイベントの追跡に関するページをご覧ください。Learn more about tracking events from iOS apps.

MSAnalytics.trackEvent("Video clicked")

Android アプリからカスタム イベントを送信するには、App Center SDK の trackEvent メソッドを使用します。To send custom events from Android apps, use the trackEvent method in the App Center SDK. 詳しくは、Android アプリからのイベントの追跡に関するページをご覧ください。Learn more about tracking events from Android apps.

Analytics.trackEvent("Video clicked")

その他のアプリ プラットフォームからカスタム イベントを送信するには、それらの App Center SDK の trackEvent メソッドを使用します。To send custom events from other app platforms, use the trackEvent methods in their App Center SDKs.

カスタム イベントが受信されていることを確認するには、App Center で [イベント] タブの [Analytics] セクションに移動します。To make sure your custom events are being received, go to the Events tab under the Analytics section in App Center. アプリから送信されたイベントが表示されるまでに、数分かかる場合があります。It can take a couple minutes for events to show up from when they're sent from your app.

Application Insights リソースの作成Create an Application Insights resource

アプリからカスタム イベントが送信され、App Center で受信されるようになったら、Azure Portal で App Center 型の Application Insights リソースを作成する必要があります。Once your app is sending custom events and these events are being received by App Center, you need to create an App Center-type Application Insights resource in the Azure portal:

  1. Azure portal にサインインするSign in to the Azure portal.

  2. [リソースの作成] > [開発者ツール] > [Application Insights] の順に選択します。Select Create a resource > Developer tools > Application Insights.

    注意

    Application Insights リソースを初めて作成する場合は、「Application Insights リソースの作成」のドキュメントにアクセスして詳細を確認できます。If this is your first time creating an Application Insights resource you can learn more by visiting the Create an Application Insights Resource doc.

    構成ボックスが表示されます。A configuration box will appear. 下の表を使用して、入力フィールドに入力します。Use the table below to fill out the input fields.

    設定Settings Value [説明]Description
    NameName グローバルに一意の値 (例: "myApp-iOS")Some globally unique value, like "myApp-iOS" 監視しているアプリを識別する名前Name that identifies the app you are monitoring
    リソース グループResource Group 新しいリソース グループ、またはメニューから選択した既存のリソース グループA new resource group, or an existing one from the menu 新しい Application Insights リソースの作成先のリソース グループThe resource group in which to create the new Application Insights resource
    LocationLocation メニューから選択した場所A location from the menu 近くにある場所か、アプリがホストされている場所の近くを選択します。Choose a location near you, or near where your app is hosted
  3. Create をクリックしてください。Click Create.

アプリが複数のプラットフォーム (iOS、Android など) をサポートしている場合は、プラットフォームごとに個別の Application Insights リソースを作成することをお勧めします。If your app supports multiple platforms (iOS, Android, etc.), it's best to create separate Application Insights resources, one for each platform.

Application Insights へのエクスポートExport to Application Insights

新しい Application Insights リソースの [概要] ページで、In your new Application Insights resource on the Overview page. リソースからインストルメンテーション キーをコピーします。Copy the instrumentation key from your resource.

アプリの App Center インスタンスで、次の手順を実行します。In the App Center instance for your app:

  1. [設定] ページで [エクスポート] をクリックします。On the Settings page, click Export.
  2. [新しいエクスポート][Application Insights] の順に選択し、 [カスタマイズ] をクリックします。Choose New Export, pick Application Insights, then click Customize.
  3. Application Insights のインストルメンテーション キーをボックスに貼り付けます。Paste your Application Insights instrumentation key into the box.
  4. 作成した Application Insights リソースを含む Azure サブスクリプションの使用量の増加に同意します。Consent to increasing the usage of the Azure subscription containing your Application Insights resource. Application Insights リソースごとに、1 か月に受信したデータの最初の 1 GB が無料となります。Each Application Insights resource is free for the first 1 GB of data received per month. 詳しくは、Application Insights の価格に関する記事をご覧ください。Learn more about Application Insights pricing.

アプリがサポートしているプラットフォームごとに、このプロセスを繰り返します。Remember to repeat this process for each platform your app supports.

エクスポートの設定が完了すると、App Center が受信した各カスタム イベントが Application Insights にコピーされるようになります。Once export is set up, each custom event received by App Center is copied into Application Insights. イベントが Application Insights に到達するまでに数分かかるため、すぐに表示されない場合は、少し待ってから詳細な診断を行ってください。It can take several minutes for events to reach Application Insights, so if they don't show up immediately, wait a bit before diagnosing further.

最初の接続時は、より多くのデータが得られるように、App Center 内の過去 48 時間のカスタム イベントが Application Insights に自動的にエクスポートされます。To give you more data when you first connect, the most recent 48 hours of custom events in App Center are automatically exported to Application Insights.

アプリの監視の開始Start monitoring your app

Application Insights は、App Center で提供されている分析ツールよりも高度な、アプリからのカスタム イベント テレメトリのクエリ、セグメント化、フィルター、分析を行うことができます。Application Insights can query, segment, filter, and analyze the custom event telemetry from your apps, beyond the analytics tools App Center provides.

  1. カスタム イベント テレメトリのクエリ。Query your custom event telemetry. Application Insights の [概要] ページから [ログ (Analytics)] を選択します。From the Application Insights Overview page, choose Logs (Analytics).

    Application Insights リソースに関連付けられている Application Insights のログ (Analytics) ポータルが開きます。The Application Insights Logs (Analytics) portal associated with your Application Insights resource will open. ログ (Analytics) ポータルでは Log Analytics クエリ言語を使用してデータを直接クエリできるので、アプリとそのユーザーに関する任意の複雑な質問をすることができます。The Logs (Analytics) portal lets you directly query your data using the Log Analytics query language, so you can ask arbitrarily complex questions about your app and its users.

    ログ (Analytics) ポータルで新しいタブを開き、次のクエリを貼り付けます。Open a new tab in the Logs (Analytics) portal, then paste in the following query. このクエリは、過去 24 時間にアプリから各カスタム イベントを送信した個別ユーザーの数を、これらの数を基準として並べ替えて返します。It returns a count of how many distinct users have sent each custom event from your app in the last 24 hours, sorted by these distinct counts.

    customEvents
    | where timestamp >= ago(24h)
    | summarize dcount(user_Id) by name 
    | order by dcount_user_Id desc 
    

    ログ (Analytics) ポータル

    1. テキスト エディターでクエリの任意の場所をクリックして、クエリを選択します。Select the query by clicking anywhere on the query in the text editor.
    2. [実行] をクリックしてクエリを実行します。Then click Go to run the query.

    詳しくは、Application Insights Analyticsに関するページおよび Log Analytics クエリ言語に関するページをご覧ください。Learn more about Application Insights Analytics and the Log Analytics query language.

  2. カスタム イベント テレメトリのセグメント化とフィルター。Segment and filter your custom event telemetry. Application Insights の [概要] ページで、目次の [ユーザー] を選択します。From the Application Insights Overview page, choose Users in the table of contents.

    [ユーザー] ツールのアイコン

    [ユーザー] ツールは、特定のボタンのクリック、特定の画面の閲覧、または App Center SDK を使用してイベントとして追跡している他のアクションを実行したアプリ ユーザーの数を表示します。The Users tool shows how many users of your app clicked certain buttons, visited certain screens, or performed any other action that you are tracking as an event with the App Center SDK. App Center イベントをセグメント化およびフィルターする方法を探していた場合は、[ユーザー] ツールが最適な選択肢となります。If you've been looking for a way to segment and filter your App Center events, the Users tool is a great choice.

    [ユーザー] ツール

    たとえば、 [次で分割] ドロップダウン メニューで [国または地域] を選択して、利用状況を地理別にセグメント化できます。For example, segment your usage by geography by choosing Country or region in the Split by dropdown menu.

  3. アプリのコンバージョン、リテンション、ナビゲーションのパターンの分析。Analyze conversion, retention, and navigation patterns in your app. Application Insights の [概要] ページで、目次の [ユーザー フロー] を選択します。From the Application Insights Overview page, choose User Flows in the table of contents.

    [ユーザー フロー] ツール

    [ユーザー フロー] ツールは、特定の開始イベントの後にユーザーがどのようなイベントを送信するかを視覚化します。The User Flows tool visualizes which events users send after some starting event. これは、ユーザーがアプリ内をどのように移動しているかの全体像を把握するのに便利です。It's useful for getting an overall picture of how users navigate through your app. また、多くのユーザーがアプリから離脱している場所や、何度も同じアクションを繰り返している場所を特定できます。It can also reveal places where many users are churning from your app, or repeating the same actions over and over.

    Application Insights には、[ユーザー フロー] 以外にも、特定の質問に答えるためのユーザー行動分析ツールがいくつか用意されています。In addition to User Flows, Application Insights has several other user behavior analytics tools to answer specific questions:

    • [じょうご] : コンバージョン レートを分析および監視します。Funnels for analyzing and monitoring conversion rates.
    • [リテンション期間] : アプリが時間の経過と共にどの程度ユーザーを保持できているかを分析します。Retention for analyzing how well your app retains users over time.
    • [Workbooks] : 視覚化とテキストを共有可能なレポートに結合します。Workbooks for combining visualizations and text into a shareable report.
    • [コーホート] : 特定のユーザーまたはイベントのグループに名前を付けて保存し、他の分析ツールから簡単に参照できるようにします。Cohorts for naming and saving specific groups of users or events so they can be easily referenced from other analytics tools.

リソースをクリーンアップするClean up resources

App Center での Application Insights の使用を続行しない場合は、App Center でエクスポートをオフにして、Application Insights リソースを削除します。If you do not want to continue using Application Insights with App Center, turn off export in App Center and delete the Application Insights resource. これにより、Application Insights でこのリソースに対する課金が行われなくなります。This will prevent you from being charged further by Application Insights for this resource.

App Center でエクスポートをオフにするには:To turn off export in App Center:

  1. App Center で [設定] に移動し、 [エクスポート] を選択します。In App Center, go to Settings and choose Export.
  2. 削除する Application Insights のエクスポートをクリックし、下部にある [エクスポートの削除] をクリックして確認します。Click the Application Insights export you want to delete, then click Delete export at the bottom and confirm.

Application Insights リソースを削除するには、次の手順に従います。To delete the Application Insights resource:

  1. Azure Portal の左側のメニューで、 [リソース グループ] をクリックし、Application Insights リソースが作成されたリソース グループを選択します。In the left-hand menu of the Azure portal, click Resource groups and then choose the resource group in which your Application Insights resource was created.
  2. 削除する Application Insights リソースを開きます。Open the Application Insights resource you want to delete. リソースの上部のメニューで、 [削除] をクリックして確認します。Then click Delete in the top menu of the resource and confirm. これにより、Application Insights にエクスポートされたデータのコピーが完全に削除されます。This will permanently delete the copy of the data that was exported to Application Insights.

次のステップNext steps