App Center Analytics (Unity)

App Center Analytics 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 le istruzioni nella sezione Introduzione a Unity .

using Microsoft.AppCenter.Unity.Analytics;

Informazioni sulla sessione e sul dispositivo

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

Eventi personalizzati

È possibile tenere traccia degli eventi personalizzati con un massimo di 20 proprietà per sapere cosa accade nell'app, comprendere le azioni degli utenti e visualizzare le aggregazioni nel portale di App Center.

Usare il TrackEvent() metodo per tenere traccia degli eventi con le proprietà. È possibile inviare fino a 200 nomi di eventi distinti. È previsto un limite massimo di 256 caratteri per nome evento e 125 caratteri per nome e valore della proprietà evento.

Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
});

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

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 smetterà di raccogliere informazioni di analisi per l'app. Per disabilitare Analytics, usare l'API seguente, passando false come parametro.

Analytics.SetEnabledAsync(false);

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

Analytics.SetEnabledAsync(true);

Lo stato viene salvato in modo permanente nella risorsa di archiviazione del dispositivo tra i lanci dell'applicazione.

Questa API è asincrona. Per altre informazioni, vedere la guida alle API asincrone di App Center .

Controllare se App Center Analytics è abilitato

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

bool isEnabled = await Analytics.IsEnabledAsync();

Priorità e persistenza degli eventi

È possibile tenere traccia degli eventi business critical con un'importanza maggiore rispetto ad altri eventi.

Gli sviluppatori possono impostare la persistenza degli eventi come Normal (Flags.PersistenceNormal nell'API) o Critical (Flags.PersistenceCritical nell'API).

È possibile usare l'API seguente per tenere traccia di un evento come critico:

Analytics.TrackEvent("eventName", Flags.PersistenceCritical);

Se si usano proprietà:

Analytics.TrackEvent("eventName", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
}, Flags.PersistenceCritical);

Sospendere e riprendere l'invio dei log

La sospensione della trasmissione degli eventi può essere utile negli scenari in cui l'app deve controllare la larghezza di banda di rete per esigenze aziendali più critiche. È possibile sospendere l'invio dei log al back-end di App Center. Quando vengono sospesi, gli eventi possono comunque essere rilevati e salvati, ma non vengono inviati immediatamente. Tutti gli eventi tracciati dall'app durante la sospensione verranno inviati solo dopo la chiamata Analytics.Resumea .

Analytics.Pause();
Analytics.Resume();

Questa API è asincrona. Per altre informazioni, vedere la guida alle API asincrone di App Center .

Gestire la sessione di avvio

Per impostazione predefinita, l'ID sessione dipende dal ciclo di vita dell'applicazione. Se si vuole controllare manualmente l'inizio di una nuova sessione, seguire questa procedura:

• Deselezionare la casella di controllo Abilita rilevamento sessione manuale nella sezione Analisi dell'oggetto gioco con AppCenterBehavior collegato.
• È quindi possibile usare l'API StartSession dopo :AppCenter.Start

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 è presente alcuna connettività di rete, l'SDK salva fino a 10 MB di log nella risorsa di archiviazione locale. Al termine dell'archiviazione, l'SDK inizierà a eliminare 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.

Invio in batch dei log eventi

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

App Center SDK supporta i tentativi di back-off in caso di errori di rete ripristinabili. Di seguito è riportata la logica di ripetizione dei tentativi:

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

Logica di back-off

• 50% casualizzazione, primo tentativo tra 5 e 10, secondo tentativo tra 2,5 e 5 minuti, ultimo tentativo tra 10 e 20 minuti.
• Se la rete passa da off a on (o da Wi-Fi a mobile), gli stati di ripetizione dei tentativi vengono reimpostati e le richieste vengono ritentate immediatamente.