App Center Analytics (React Native)

2025-05-05

Importante

Visual Studio App Center è stato ritirato il 31 marzo 2025, ad eccezione delle funzionalità di Analisi e diagnostica, che continueranno a essere supportate fino al 30 giugno 2026. Ulteriori informazioni.

Analisi di App Center consente di comprendere il comportamento degli utenti e il coinvolgimento dei clienti per migliorare l'app. L'SDK acquisisce automaticamente il numero di sessioni e le proprietà del dispositivo, ad esempio modello, versione del sistema operativo e così via. È possibile definire eventi personalizzati per misurare le cose importanti. Tutte le informazioni acquisite sono disponibili nel portale di App Center per analizzare i dati.

Se non è ancora stato configurato l'SDK nell'applicazione, seguire la sezione Introduzione .

Informazioni sulla sessione e sul dispositivo

Dopo aver aggiunto App Center Analytics all'app e l'SDK viene avviato, tiene automaticamente traccia delle sessioni e delle proprietà del dispositivo, ad esempio Versione del sistema operativo, modello e così via.

Eventi personalizzati

Tenere traccia dei propri eventi personalizzati con un massimo di 20 proprietà per comprendere l'interazione tra gli utenti e l'app.

Dopo aver avviato l'SDK, usare il trackEvent metodo per tenere traccia degli eventi con le proprietà. È possibile inviare fino a 200 nomi di eventi distinti. C'è inoltre un limite massimo di 256 caratteri per il nome dell'evento e 125 caratteri per il nome e il valore di ogni proprietà dell'evento.

// import App Center Analytics at the top of the file.
import Analytics from 'appcenter-analytics';

Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' });

Questa funzione restituisce una promessa, il caso di esito positivo restituisce una stringa vuota e il caso di errore restituisce l'errore.

Le proprietà per gli eventi sono facoltative; se si vuole solo tenere traccia di un evento, usare questo comando:

Analytics.trackEvent('Video clicked');

Abilitare o disabilitare Analisi di App Center in fase di esecuzione

È possibile abilitare e disabilitare Analisi di App Center in fase di esecuzione. Se la si disabilita, l'SDK non raccoglierà altre informazioni di analisi per l'app.

await Analytics.setEnabled(false);

Questa funzione restituisce una promessa che si risolve in void.

Per abilitare di nuovo App Center Analytics, usare la stessa API ma passare true come parametro.

await Analytics.setEnabled(true);

Lo stato viene salvato in modo permanente nella risorsa di archiviazione del dispositivo all'avvio dell'applicazione.

Controllare se App Center Analytics è abilitato

È anche possibile verificare se App Center Analytics è abilitato o meno.

const enabled = await Analytics.isEnabled();

Questa funzione restituisce una promessa che viene risolta in un oggetto boolean.

Attendere che JS abiliti Analisi di App Center

Se vuoi raccogliere informazioni di analisi per gli utenti dell'app, ma vuoi prima ottenere l'autorizzazione utente, puoi scegliere di non abilitare l'analisi all'avvio, ma attendere fino al momento giusto e abilitarlo in JavaScript.

Aprire il file del ios/YourAppName/AppDelegate.m progetto e sostituire [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true]; con [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];.
Aprire il file del android/app/src/main/res/values/strings.xml progetto e sostituire <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string> con <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>.

Ciò significa che per qualsiasi informazione da inviare ad App Center (anche informazioni di base sulla sessione), è prima necessario abilitare App Center Analytics aggiungendo la riga di codice seguente:

await Analytics.setEnabled(true);

Gestire la sessione di avvio

Per impostazione predefinita, l'ID sessione dipende dal ciclo di vita dell'applicazione. Se si vuole controllare manualmente l'avvio di una nuova sessione, seguire i passaggi successivi:

Annotazioni

Prestare attenzione che ogni chiamata dell'API Analytics.StartSession() genererà una nuova sessione. Se in modalità di rilevamento sessione manuale questa API non verrà chiamata, tutti i log di invio avranno un valore di sessione Null.

Annotazioni

Prestare attenzione che dopo l'avvio di una nuova applicazione l'ID sessione verrà rigenerato.

Per configurare manualmente l'SDK per la sessione di rilevamento, è necessario usare le API di Analisi enableManualSessionTracker native:

In iOS chiamare [MSACAnalytics enableManualSessionTracker]; prima [AppCenterReactNative register]; nel metodo delegato dell'app didFinishLaunchingWithOptions in AppDelegate.m. Aggiungere @import AppCenterAnalytics se mancante nel file.
In Android, chiamare Analytics.enableManualSessionTracker(); prima di SoLoader.init nel metodo onCreate in MainApplication.java. Aggiungere l'importazione com.microsoft.appcenter.analytics.Analytics se mancante nel file.

È quindi possibile usare l'API startSession nel progetto React Native:

Analytics.startSession();

Dimensioni di archiviazione locale

Per impostazione predefinita, l'SDK archivia fino a 10 MB di log nella risorsa di archiviazione.

Nessun accesso a Internet

Quando non è disponibile alcuna connettività di rete, l'SDK salva fino a 10 MB di log nella risorsa di archiviazione locale. Una volta completata l'archiviazione, l'SDK inizierà a rimuovere i log precedenti per liberare spazio per i nuovi log. Quando il dispositivo ottiene nuovamente l'accesso a Internet, l'SDK invierà i log nel batch di 50 o dopo ogni 6 secondi.

Registrazione dei log degli eventi in batch

App Center SDK carica i log in un batch di 50 e se l'SDK non dispone di 50 log da inviare, i log verranno comunque inviati dopo 6 secondi. È possibile inviare un massimo di tre batch in parallelo.

Logica di ripetizione e back-off

L'SDK di App Center supporta i tentativi di riprovare con intervalli di tempo in caso di errori di rete recuperabili. Di seguito è riportata la logica di ripetizione dei tentativi:

Massimo 3 tentativi per ogni richiesta.
Ogni richiesta ha una propria macchina a stati di ripetizione dei tentativi.
Tutti i canali di trasmissione sono disabilitati (fino al processo successivo dell'app) dopo che una richiesta esaurisce tutti i tentativi.

Logica di riduzione graduale

50% randomizzazione, primo tentativo tra 5s e 10s, secondo tentativo tra 2,5 e 5 minuti, ultimo tentativo compreso tra 10 e 20 minuti.
Se la rete passa da off a on (o da wi-fi a dispositivi mobili), gli stati di ripetizione dei tentativi vengono reimpostati e le richieste vengono ritentate immediatamente.