LaAWSMobile SDK for Unity è ora incluso nel kit SDK MobileAWS SDK for .NET. Questa guida fa riferimento alla versione archiviata dell'SDK Mobile per Unity. Per ulteriori informazioni, consultaChe cos'è ?AWSMobile SDK for Unity?

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

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

Integrazione di Amazon Mobile Analytics

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

Crea un'app nella console di Mobile Analytics

Passa allaConsole Amazon Mobile Analyticse crea un'app. Nota:appIdvalore, come è necessario in un secondo momento.

Quando crei un'app in Mobile Analytics Console, dovrai specificare un ID del pool di identità Cognito. Per creare un nuovo Cognito Identity Pool e generare un ID, vedereGuida per sviluppatori Cognito Identity.

Integra Mobile Analytics nella tua app

Per accedere a Mobile Analytics da Unity è necessario utilizzare le seguenti istruzioni:

using Amazon.MobileAnalytics.MobileAnalyticsManager;
using Amazon.CognitoIdentity;

La procedura consigliata è utilizzare Amazon Cognito per fornire credenziali AWS temporanee alla tua applicazione. che occorrono per accedere alle risorse AWS. Per creare un provider di credenziali, segui le istruzioni riportate inAmazon Cognito Identity.

Creare un'istanza di unMobileAnalyticsIstanza di manager con le seguenti informazioni:

Utilizzo dell'MobileAnalyticsClientContextConfig per inizializzare un MobileAnalyticsManager istanza come mostrato nel seguente frammento di codice:

// Initialize the MobileAnalyticsManager
void Start()
{
    // ...
    analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
        new CognitoAWSCredentials(<cognitoIdentityPoolId>, <cognitoRegion>),
        <region>,
        <appId>);
    // ...
}

LaappIdviene 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.

Registrare gli eventi di monetizzazione

SDK for Unity fornisce ilMonetizationEventclass, 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);

Registrare 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, supponiamo che la tua app sia un gioco e desideri 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

Quando l'applicazione perde lo stato attivo è possibile sospendere la sessione. Nello statoOnApplicationFocuscontrolla se l'app è in pausa. In tal caso, chiamaPauseSessionaltrimenti chiamaResumeSessioncome illustrato nel seguente frammento di codice:

void OnApplicationFocus(bool focus)
{
    if(focus)
    {
        analyticsManager.ResumeSession();
    }
    else
    {
        analyticsManager.PauseSession();
    }
}

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 awsconfig.xml. Per ulteriori informazioni, consulta la sezione Configurazione di Mobile Analytics diNozioni di base su SDK AWS Mobile per Unity.