Avviare l'analisi dell'app per dispositivi mobili con App Center e Application InsightsStart analyzing your mobile app with App Center and Application Insights

Questa guida introduttiva illustra come eseguire la connessione dell'istanza App Center dell'app ad Application Insights.This quickstart guides you through connecting your app's App Center instance to Application Insights. Con Application Insights è possibile eseguire query, segmentare, filtrare e analizzare i dati di telemetria con gli strumenti più potenti disponibili del servizio Analytics di App Center.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.

PrerequisitiPrerequisites

Per completare l'esercitazione introduttiva, sono necessari gli elementi seguenti:To complete this quickstart, you need:

  • Una sottoscrizione di Azure.An Azure subscription.
  • Un'app di iOS, Android, Xamarin, Universal Windows o React Native.An iOS, Android, Xamarin, Universal Windows, or React Native app.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Caricare in App CenterOnboard to App Center

Prima di poter usare Application Insights con l'app per dispositivi mobili, è necessario caricare l'app in App Center.Before you can use Application Insights with your mobile app, you need to onboard your app to App Center. Application Insights non riceve dati di telemetria direttamente dall'app per dispositivi mobili.Application Insights does not receive telemetry from your mobile app directly. L'app invia dati di telemetria personalizzati su un evento ad App Center.Instead, your app sends custom event telemetry to App Center. Pertanto, App Center esporta continuamente copie di questi eventi personalizzati in Application Insights quando vengono ricevuti gli eventi.Then, App Center continuously exports copies of these custom events into Application Insights as the events are received.

Per caricare l'app, attenersi alla guida introduttiva di App Center per ogni piattaforma supportata dall'app.To onboard your app, follow the App Center quickstart for each platform your app supports. Creare istanze di App Center separate per ogni piattaforma:Create separate App Center instances for each platform:

Tenere traccia degli eventi nell'appTrack events in your app

Dopo aver caricato l'app in App Center, è necessario modificarla per inviare dati di telemetria su un evento personalizzato tramite l'SDK di App Center.After your app is onboarded to App Center, it needs to be modified to send custom event telemetry using the App Center SDK. Gli eventi personalizzati sono l'unico tipo di dati di telemetria di App Center che viene esportato in Application Insights.Custom events are the only type of App Center telemetry that is exported to Application Insights.

Per inviare gli eventi personalizzati dalle app iOS, usare i metodi trackEvent o trackEvent:withProperties dell'SDK di App Center.To send custom events from iOS apps, use the trackEvent or trackEvent:withProperties methods in the App Center SDK. Altre informazioni sul monitoraggio di eventi da app iOS.Learn more about tracking events from iOS apps.

MSAnalytics.trackEvent("Video clicked")

Per inviare gli eventi personalizzati dalle app Android, usare il metodo trackEvent dell'SDK di App Center.To send custom events from Android apps, use the trackEvent method in the App Center SDK. Altre informazioni sul monitoraggio di eventi da app Android.Learn more about tracking events from Android apps.

Analytics.trackEvent("Video clicked")

Per inviare eventi personalizzati da altre piattaforme di app, usare il metodo trackEvent negli SDK di App Center.To send custom events from other app platforms, use the trackEvent methods in their App Center SDKs.

Per assicurarsi che gli eventi personalizzati vengano ricevuti, passare alla scheda Eventi nella sezione Analytics in App Center.To make sure your custom events are being received, go to the Events tab under the Analytics section in App Center. Dall'invio degli eventi dall'app fino alla visualizzazione potrebbero essere necessari un paio di minuti.It can take a couple minutes for events to show up from when they're sent from your app.

Creare una risorsa di Application InsightsCreate an Application Insights resource

Quando l'app invia eventi personalizzati e questi vengono ricevuti da App Center, è necessario creare una risorsa di Application Insights di tipo App Center nel portale di Azure: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. Accedere al Portale di Azure.Log in to the Azure portal.
  2. Selezionare Crea una risorsa > Strumenti di gestione > Application Insights.Select Create a resource > Management Tools > Application Insights.

    Aggiunta di una risorsa di Application Insights

    Verrà visualizzata una finestra di configurazione.A configuration box will appear. Usare la tabella seguente per completare i campi di input.Use the table below to fill out the input fields.

    ImpostazioniSettings ValoreValue DESCRIZIONEDescription
    NomeName Un valore univoco a livello globale, ad esempio "myApp-iOS"Some globally unique value, like "myApp-iOS" Nome che identifica l'app da monitorareName that identifies the app you are monitoring
    Tipo di applicazioneApplication Type Applicazione App CenterApp Center application Tipo di app da monitorareType of app you are monitoring
    Gruppo di risorseResource Group Un nuovo gruppo di risorse o un gruppo esistente del menuA new resource group, or an existing one from the menu Il gruppo di risorse in cui creare la nuova risorsa di Application InsightsThe resource group in which to create the new Application Insights resource
    PosizioneLocation Un percorso del menuA location from the menu Scegliere una località nelle vicinanze o vicina a quella in cui è ospitata l'appChoose a location near you, or near where your app is hosted
  3. Fare clic su Create(Crea).Click Create.

Se l'app supporta più piattaforme, iOS, Android e così via, è consigliabile creare risorse di Application Insights separate, una per ogni piattaforma.If your app supports multiple platforms (iOS, Android, etc.), it's best to create separate Application Insights resources, one for each platform.

Esportare in Application InsightsExport to Application Insights

Nella pagina Panoramica della nuova risorsa di Application Insights, nella sezione Informazioni di base in alto copiare la chiave di strumentazione per questa risorsa.In your new Application Insights resource on the Overview page in the Essentials section at the top, copy the instrumentation key for this resource.

Nell'istanza di App Center per l'app:In the App Center instance for your app:

  1. Nella pagina Impostazioni fare clic su Esporta.On the Settings page, click Export.
  2. Scegliere Nuova esportazione, selezionare Application Insights, quindi fare clic su Personalizza.Choose New Export, pick Application Insights, then click Customize.
  3. Incollare la chiave di strumentazione di Application Insights nella casella.Paste your Application Insights instrumentation key into the box.
  4. Consentire l'aumento dell'uso della sottoscrizione di Azure che contiene la risorsa di Application Insights.Consent to increasing the usage of the Azure subscription containing your Application Insights resource. Ogni risorsa di Application Insights offre gratuitamente la ricezione di 1 GB di dati al mese.Each Application Insights resource is free for the first 1 GB of data received per month. Altre informazioni sui prezzi di Application Insights.Learn more about Application Insights pricing.

Ricordarsi di ripetere l'operazione per ogni piattaforma supportata l'app.Remember to repeat this process for each platform your app supports.

Dopo aver configurato l'esportazione, ogni evento personalizzato ricevuto da App Center viene copiato in Application Insights.Once export is set up, each custom event received by App Center is copied into Application Insights. Affinché gli eventi raggiungano Application Insights potrebbero essere necessari alcuni minuti, pertanto se non vengono visualizzati immediatamente, attendere qualche istante prima eseguire altre indagini.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.

Per consentire all'utente di avere un numero maggiore di dati durante la prima connessione, gli eventi personalizzati di App Center delle ultime 48 ore vengono esportati automaticamente in 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.

Avviare il monitoraggio dell'appStart monitoring your app

Application Insights può eseguire query, segmentare, filtrare e analizzare i dati di telemetria relativi agli eventi personalizzati delle app, oltre agli strumenti di analisi offerti da 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. Eseguire query sui dati di telemetria relativi agli eventi personalizzati.Query your custom event telemetry. Nella pagina Panoramica di Application Insights scegliere Analytics.From the Application Insights Overview page, choose Analytics.

    Pulsante Analytics in Application Insights

    Verrà aperto il portale Analytics di Application Insights associato alla risorsa di Application Insights.The Application Insights Analytics portal associated with your Application Insights resource will open. Il portale Analytics consente di eseguire direttamente una query sui dati tramite il linguaggio di query di Log Analytics, pertanto è possibile porre domande complesse in modo arbitrario sull'app e i suoi utenti.The 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.

    Aprire una nuova scheda nel portale di Analytics, quindi incollare la query seguente.Open a new tab in the Analytics portal, then paste in the following query. Restituisce il conteggio del numero di singoli utenti che hanno inviato singoli eventi personalizzati dall'app nelle ultime 24 ore, ordinati in base ai singoli conteggi.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 
    

    Portale Analytics

    1. Selezionare la query facendo clic su un punto qualsiasi della query nell'editor di testo.Select the query by clicking anywhere on the query in the text editor.
    2. Quindi fare clic su Vai per eseguire la query.Then click Go to run the query.

    Altre informazioni su Analytics di Application Insights e il linguaggio di query di Log Analytics.Learn more about Application Insights Analytics and the Log Analytics query language.

  2. Segmentare e filtrare i dati di telemetria relativi a un evento personalizzato.Segment and filter your custom event telemetry. Nella pagina Panoramica di Application Insights scegliere Utenti nella tabella dei contenuti.From the Application Insights Overview page, choose Users in the table of contents.

    Icona dello strumento Utenti

    Lo strumento Utenti mostra il numero di utenti dell'app che hanno fatto clic su determinati pulsanti, hanno visitato determinate pagine o eseguito altre azioni di cui si esegue il monitoraggio come un evento con l'SDK di App Center.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. Se si sta cercando un modo per segmentare e filtrare gli eventi di App Center, lo strumento Utenti è un'ottima scelta.If you've been looking for a way to segment and filter your App Center events, the Users tool is a great choice.

    Strumento Utenti

    Segmentare, ad esempio, l'uso per area geografica scegliendo Paese o area geografica nel menu a discesa Split by (Dividi per).For example, segment your usage by geography by choosing Country or region in the Split by dropdown menu.

  3. Analizzare i modelli di conversione, conservazione e navigazione nell'app.Analyze conversion, retention, and navigation patterns in your app. Nella pagina Panoramica di Application Insights scegliere Flussi utente nella tabella dei contenuti.From the Application Insights Overview page, choose User Flows in the table of contents.

    Strumento Flussi utenti

    Lo strumento Flussi utenti mostra gli utenti che inviano gli eventi in seguito a un evento iniziale.The User Flows tool visualizes which events users send after some starting event. È utile per ottenere un quadro complessivo dell'uso che gli utenti fanno dell'app.It's useful for getting an overall picture of how users navigate through your app. Consente anche di vedere le pagine più visitate dell'app o le stesse azioni ripetute più volte.It can also reveal places where many users are churning from your app, or repeating the same actions over and over.

    Oltre a Flussi utente, Application Insights include diversi altri strumenti di analisi del comportamento degli utenti per rispondere a domande specifiche:In addition to User Flows, Application Insights has several other user behavior analytics tools to answer specific questions:

    • Imbuti per l'analisi e monitoraggio dei tassi di conversione.Funnels for analyzing and monitoring conversion rates.
    • Conservazione per analizzare il modo in cui l'app mantiene gli utenti nel tempo.Retention for analyzing how well your app retains users over time.
    • Cartelle di lavoro per la combinazione di visualizzazioni e testo in un report condivisibile.Workbooks for combining visualizations and text into a shareable report.
    • Coorti per la denominazione e il salvataggio di specifici gruppi di utenti o eventi in modo che sia possibile fare facilmente riferimento a questi da altri strumenti di analisi.Cohorts for naming and saving specific groups of users or events so they can be easily referenced from other analytics tools.

Pulire le risorseClean up resources

Se non si desidera continuare a usare Application Insights con App Center, disattivare l'esportazione in App Center ed eliminare la risorsa di 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. In questo modo si evita che Application Insights addebiti altri costi per questa risorsa.This will prevent you from being charged further by Application Insights for this resource.

Per disabilitare l'esportazione in App Center:To turn off export in App Center:

  1. In App Center passare a Impostazioni e scegliere Esporta.In App Center, go to Settings and choose Export.
  2. Scegliere l'esportazione di Application Insights che si desidera eliminare, quindi fare clic su Elimina esportazione nella parte inferiore e confermare.Click the Application Insights export you want to delete, then click Delete export at the bottom and confirm.

Per eliminare la risorsa di Application Insights:To delete the Application Insights resource:

  1. Nel menu a sinistra del portale di Azure fare clic su Gruppi di risorse e quindi scegliere il gruppo di risorse in cui è stata creata la risorsa di 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. Aprire la risorsa di Application Insights che si desidera eliminare.Open the Application Insights resource you want to delete. Quindi fare clic su Elimina nel menu in alto della risorsa e confermare.Then click Delete in the top menu of the resource and confirm. Questa operazione eliminerà definitivamente la copia dei dati che è stata esportata in Application Insights.This will permanently delete the copy of the data that was exported to Application Insights.

Passaggi successiviNext steps