Amazon Mobile Analytics - AWS Mobile SDK
Concetti chiaveConfigurazione progettoIntegrazione di Mobile Analytics con l'applicazione

L'SDKAWS Mobile per Xamarin è ora incluso inAWS SDK for .NET. Questa guida fa riferimento alla versione archiviata di Mobile SDK per Xamarin.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Amazon Mobile Analytics

Amazon Mobile Analyticsè un servizio per raccogliere, visualizzare, conoscere ed estrarre dati sull'utilizzo di app su larga scala. Mobile Analytics acquisisce facilmente sia i dati dei dispositivi standard sia gli eventi personalizzati ed elabora i report per te automaticamente. Oltre ai report aggregati elencati di seguito, è anche possibile configurare i dati affinché siano esportati automaticamente a Redshift e S3 per un'ulteriore analisi.

Utilizzando Amazon Mobile Analytics, puoi monitorare i comportamenti dei clienti, aggregare metriche, generare visualizzazioni di dati e identificare modelli significativi.

Concetti chiave

Tipi di report

Mobile Analytics fornisce i seguenti report in Mobile Analytics Console:

  • Daily Active Users (DAU, Utenti attivi giornalieri), Monthly Active Users (MAU, Utenti attivi mensili) e New Users (Nuovi utenti)

  • Sticky Factor (Fattore sticky) (DAU diviso MAU)

  • Session Count (Conteggio sessioni) e Average Sessions per Daily Active User (Sessioni medie per utente attivo giornaliero)

  • Average Revenue per Daily Active User (ARPPDAU, Fatturato medio per utente attivo giornaliero a pagamento).

  • Day 1, 3, and 7 Retention (Conservazione giorno 1, 3 e 7) e Week 1, 2, and 3 Retention (Conservazione settimana 1, 2 e 3)

  • Eventi personalizzati

Questi report vengono forniti tramite sei schede di report nella console:

  • Panoramica— Tieni traccia di nove report preselezionati in unsimple-to-reviewdashboard per avere una rapida idea di coinvolgimento: MAU, DAU, Nuovi utenti, Sessioni giornaliere, Sticky Factor, 1 giorno di conservazione, ARPDAU, Daily Paying Users (Utenti giornalieri a pagamento), ARPPDAU.

  • Utenti attiviMonitora il numero degli utenti che interagiscono con la tua app giornalmente e mensilmente e monitora il fattore adesivo per valutare coinvolgimento, interesse e monetizzazione.

  • Sessioni— Monitora la frequenza con cui la tua app viene utilizzata in una specifica data e quella con cui i singoli utenti aprono l'app in una determinata giornata.

  • RetentionMonitora la frequenza con cui i clienti tornano a utilizzare la tua app su base giornaliera e settimanale.

  • Revenue (Fatturato)Monitora le tendenze di fatturato in-app per identificare le aree di miglioramento dal punto di vista della monet

  • Eventi personalizzati— Tiene traccia delle azioni personalizzate definite dall'utente specifiche dell'app.

Per ulteriori informazioni sui report di Mobile Analytics e sul lavoro nella console di Mobile Analytics, consulta la sezionePanoramica dei report della console Mobile Analyticsnella Guida per gli sviluppatori di Mobile Analytics.

Configurazione progetto

Prerequisiti

Per utilizzare Mobile Analytics nella tua applicazione, devi aggiungere l'SDK al tuo progetto. A tale scopo, segui le istruzioni riportate diConfigurazione dell'SDK AWS Mobile per.NET e Xamarin.

Configurazione Mobile Analytics

Mobile Analytics definisce alcune impostazioni che possono essere configurate nel file awsconfig.xml:

var config = new MobileAnalyticsManagerConfig();
config.AllowUseDataNetwork = true;
config.DBWarningThreshold = 0.9f;
config.MaxDBSize = 5242880;
config.MaxRequestSize = 102400;
config.SessionTimeout = 5;

  • SessionTimeout- Se l'app rimane in background per un tempo superiore alSessionTimeoutquindi il client Mobile Analytics termina la sessione corrente e viene creata una nuova sessione quando l'app torna in primo piano. Raccomandiamo di utilizzare valori compresi tra 5 e 10. Il valore predefinito è 5.

  • MaxDBSize- La dimensione massima del database (in byte) utilizzata per l'archiviazione locale degli eventi. Se la dimensione del database supera questo valore, gli eventi aggiuntivi verranno ignorati. Si consiglia di utilizzare valori che vanno da 1 MB a 10 MB. Il valore predefinito è 5242880 (5 MB).

  • DBWarningThreashold- La soglia di avviso. I valori validi variano tra 0 e 1. Se i valori superano la soglia, verranno generati i registri di avviso. Il valore predefinito è 0,9.

  • MaxRequestDimensioni- La dimensione massima di una richiesta HTTP inviata al servizio Mobile Analytics. Il valore è specificato in byte e può variare tra 1-512 KB. Il valore predefinito è 102400 (100 KB). Non utilizzare valori superiori a 512 KB, questo potrebbe causare il rifiuto della richiesta HTTP.

  • AllowUseDataNetwork- Un valore che indica se la chiamata di servizio è consentita su una rete dati cellulare. Utilizzare questa opzione con cautela in quanto ciò potrebbe aumentare l'utilizzo dei dati del cliente.

Le impostazioni mostrate sopra sono i valori predefiniti per ogni elemento di configurazione.

Integrazione di Mobile Analytics con l'applicazione

Le sezioni seguenti spiegano come integrare Mobile Analytics con la tua app.

Crea un'app nella console di Mobile Analytics

Accedi aConsole Amazon Mobile Analyticse crea un'app. Nota:appIdcome è necessario in seguito. Quando crei un'app in Mobile Analytics Console, dovrai specificare l'ID del pool di identità. Per istruzioni su come creare un pool di identità, consultaConfigurazione dell'SDK AWS Mobile per.NET e Xamarin.

Per ulteriori informazioni sulle operazioni con Mobile Analytics Console, consulta laPanoramica dei report della console Mobile Analyticsnella Guida per gli sviluppatori di Mobile Analytics.

Creazione di unMobileAnalyticsClient manager

Inizializzazione diMobileAnalyticsManager, chiamaGetOrCreateInstancesul tuoMobileAnalyticsManager, passando le credenziali AWS, la tua regione, l'ID dell'applicazione Mobile Analytics e l'oggetto di configurazione opzionale:

// Initialize the MobileAnalyticsManager
analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
  cognitoCredentials,
  RegionEndpoint.USEast1,
  APP_ID,
  config
);

LaAPP_IDviene generato per te durante la procedura guidata di creazione dell'app. Entrambi questi valori devono corrispondere a quelli di Mobile Analytics Console. LaAPP_IDviene utilizzato per raggruppare i dati nella console di Mobile Analytics. Per trovare il tuo ID app dopo aver creato l'app nella console di Mobile Analytics, accedi a Mobile Analytics Console, fai clic sull'icona a forma di ingranaggio nell'angolo in alto a destra dello schermo. Viene visualizzata la pagina Gestione app che elenca tutte le app registrate e i relativi ID app.

Registrazione di eventi di monetizzazione

L'SDK AWS Mobile per.NET e Xamarin fornisce laMonetizationEventclass, che consente di generare eventi di monetizzazione per monitorare gli acquisti effettuati all'interno di applicazioni mobili. Il seguente frammento di codice mostra come creare un evento di monetizzazione:

// Create the monetization event object
MonetizationEvent monetizationEvent = new MonetizationEvent();

// Set the details of the monetization event
monetizationEvent.Quantity = 3.0;
monetizationEvent.ItemPrice = 1.99;
monetizationEvent.ProductId = "ProductId123";
monetizationEvent.ItemPriceFormatted = "$1.99";
monetizationEvent.Store = "Your-App-Store";
monetizationEvent.TransactionId = "TransactionId123";
monetizationEvent.Currency = "USD";

// Record the monetiziation event
analyticsManager.RecordEvent(monetizationEvent);

Registrazione di eventi personalizzati

Mobile Analytics consente di definire eventi personalizzati. Gli eventi personalizzati sono definiti interamente da te e ti aiutano a monitorare le azioni degli utenti specifiche della tua app o del tuo gioco. Per ulteriori informazioni sugli eventi personalizzati, consultaEventi personalizzati.

Per questo esempio, diremo che la nostra app è un gioco e che vogliamo registrare un evento quando un utente completa un livello. Crea un»LevelComplete» evento creando un nuovoAmazonMobileAnalyticsEventistanza:

CustomEvent customEvent = new CustomEvent("LevelComplete");

// Add attributes
customEvent.AddAttribute("LevelName","Level1");
customEvent.AddAttribute("CharacterClass","Warrior");
customEvent.AddAttribute("Successful","True");

// Add metrics
customEvent.AddMetric("Score",12345);
customEvent.AddMetric("TimeInLevel",64);

// Record the event
analyticsManager.RecordEvent(customEvent);

Sessioni di registrazione

Xamarin iOS

Quando l'applicazione perde lo stato attivo è possibile sospendere la sessione. Per le app iOS, nelAppDelegatefile.cs, sovrascrivereDidEnterBackgroundeWillEnterForegroundper chiamareMobileAnalyticsManager.PauseSesioneMobileAnalyticsManager.ResumeSessioncome mostrato nel seguente frammento:

public override void DidEnterBackground(UIApplication application)
{
  // ...
  _manager.PauseSesson();
  // ...
}

public override void WillEnterForeground(UIApplication application)
{
  // ...
  _manager.ResumeSession();
  // ...
}

Xamarin per Android

Per le app Android chiamaMobileAnalyticsManager.PauseSesionnellaOnPause() metodo eMobileAnalyticsManager.ResumeSessionnellaOnResume() metodo come mostrato nel seguente frammento di codice:

protected override void OnResume()
{
  _manager.ResumeSession();
  base.OnResume();
}

protected override void OnPause()
{
  _manager.PauseSession();
  base.OnPause();
}

Per impostazione predefinita, se l'utente passa lo stato attivo dall'app per meno di 5 secondi e torna all'app, la sessione verrà ripresa. Se l'utente allontana lo stato attivo dall'app per 5 secondi o più, verrà creata una nuova sessione. Questa impostazione è configurabile nel file di configurazione aws_mobile_analytics.json impostando la proprietà «SESSION_DELTA» sul numero di secondi di attesa prima di creare una nuova sessione.