Introduzione ad Azure Mobile Engagement per la distribuzione di Unity in AndroidGet Started with Azure Mobile Engagement for Unity Android deployment

Questo argomento descrive come usare Azure Mobile Engagement per ottenere informazioni sull'uso dell'app e sull'invio di notifiche push a utenti segmentati di un'applicazione Unity durante lo sviluppo in un dispositivo Android.This topic shows you how to use Azure Mobile Engagement to understand your app usage and how to send push notifications to segmented users of a Unity application when deploying to an Android device. Questa esercitazione fa uso della classica esercitazione Roll-a-ball di Unity come punto di partenza.This tutorial uses the classic Unity Roll a Ball tutorial as the starting point. Seguire i passaggi dell' esercitazione Roll-a-ball prima di procedere con l'integrazione di Mobile Engagement dimostrata nell'esercitazione seguente.You should follow the steps in this tutorial before proceeding with the Mobile Engagement integration we showcase in the tutorial below.

Per completare questa esercitazione, è necessario disporre di:This tutorial requires the following:

Nota

Per completare l'esercitazione, è necessario disporre di un account Azure attivo.To complete this tutorial, you must have an active Azure account. Se non si dispone di un account, è possibile creare un account di valutazione gratuita in pochi minuti.If you don't have an account, you can create a free trial account in just a couple of minutes. Per informazioni dettagliate, vedere la pagina relativa alla versione di valutazione gratuita di Azure.For details, see Azure Free Trial.

Configurare Mobile Engagement per l'app AndroidSetup Mobile Engagement for your Android app

  1. Accedere al portale di Azure.Log on to the Azure Portal.
  2. Fare clic su Nuovo, quindi su Web e dispositivi mobili e infine su Mobile Engagement.Click on New, then Web + Mobile, and then Mobile Engagement.

  3. Nel pannello New Mobile Engagement App Collection (Nuova raccolta di app Mobile Engagement) visualizzato si creerà una raccolta di app invece che un'app come nel portale di Azure classico.In the New Mobile Engagement App Collection blade that appears, you will be creating an App Collection instead of an App like in the Azure classic portal. Immettere le seguenti informazioni:Enter the following information:

    • Nome: Nome of your raccolta di applicazioniName: Name of your application collection
    • Piattaforme: selezionare le piattaforme di destinazione per l'app nel pannello Piattaforme che verrà aperto.Platforms: Select target platforms for your app on the Platforms blade which will open up. Ad esempio,E.g. se è necessaria un'app sia per iOS che per Android, selezionare entrambe le piattaforme per creare due app in questa raccolta di app.if you want an app for both iOS & Android then select both platforms and you will get two apps created under this app collection.

    • Sottoscrizione: selezionare la sottoscrizione di Azure.Subscription: Select the Azure subscription.
    • Gruppo di risorse: selezionare il gruppo di risorse di Azure in cui inserire questa risorsa di Azure (Raccolta di app Mobile Engagement).Resource group: Select the Azure Resource group in which you want this Azure resource (Mobile Engagement App Collection). È possibile scegliere di crearne uno nuovo.You can choose to create a new one.
    • Località: area in cui verranno archiviati i dati su questa raccolta di app e su questa app.Location: Region where the data about this app collection & app will be stored.
  4. Esplorare le raccolte di app Mobile Engagement facendo clic su Esplora e cercando Mobile EngagementBrowse through the Mobile Engagement app collections by clicking Browse and search for Mobile Engagement

  5. Verrà visualizzato un elenco di raccolte di app Mobile Engagement: assicurarsi di avere la stessa sottoscrizione di Azure in cui è stata creata la raccolta di app.You will be shown a list of Mobile Engagement App Collections - make sure you have the same Azure subscription where you created your App Collection.

  6. Fare clic sulla raccolta di app creata nel passaggio precedente per aprire il pannello della risorsa raccolta di app che visualizzerà le diverse app presenti in questa raccolta di app.Click on the App Collection that you created in the prior step to open up the App Collection resource blade which will show the different apps present inside this app collection.

  7. Fare clic sull'app creata per la piattaforma per cui si sta sviluppando.Click on the App created for the platform you are developing for.

  8. Fare clic sul pulsante di comando Informazioni di connessione in alto per aprire il pannello Informazioni di connessione e copiare la stringa di connessione.Click on Connection Info command button at the top to open up the Connection Info blade and copy the connection string from there.

Connettere l'app al back-end di Mobile EngagementConnect your app to the Mobile Engagement backend

Importare il pacchetto UnityImport the Unity package

  1. Scaricare il pacchetto Unity per Mobile Engagement e salvarlo nel computer locale.Download the Mobile Engagement Unity package and save it to your local machine.
  2. Passare a Assets -> Import Package -> Custom Package (Asset -> Importa pacchetto -> Pacchetto personalizzato) e selezionare il pacchetto scaricato nel passaggio precedente.Go to Assets -> Import Package -> Custom Package and select the package you downloaded in the above step.

  3. Assicurarsi che tutti i file siano selezionati e fare clic sul pulsante Import .Make sure all files are selected and click Import button.

  4. Al termine dell'importazione verranno visualizzati i file dell'SDK importati nel progetto.Once Import is successful, you will see the imported SDK files in your project.

Aggiornare EngagementConfigurationUpdate the EngagementConfiguration

  1. Aprire il file di script EngagementConfiguration dalla cartella dell'SDK e aggiornare ANDROID_CONNECTION_STRING con la stringa di connessione ottenuta in precedenza dal portale di Azure.Open up the EngagementConfiguration script file from the SDK folder and update the ANDROID_CONNECTION_STRING with the connection string you obtained earlier from the Azure portal.

  2. Salvare il file.Save the file
  3. Eseguire File -> Engagement -> Generate Android Manifest (File -> Engagement -> Genera manifesto di Android).Execute File -> Engagement -> Generate Android Manifest. Si tratta del plug-in aggiunto da Mobile Engagement SDK. Facendo clic su di esso verranno aggiornate automaticamente le impostazioni del progetto.This is the plugin added by the Mobile Engagement SDK and clicking on it will automatically update your project settings.

Importante

Assicurarsi di eseguire questa operazione ogni volta che si aggiorna il file EngagementConfiguration. In caso contrario, le modifiche non saranno applicate all'app.Make sure to execute this every time you update the EngagementConfiguration file otherwise your changes will not be reflected in the app.

Configurare l'app per il rilevamento di baseConfigure the app for basic tracking

  1. Aprire lo script PlayerController collegato all'oggetto Player per la modifica.Open up the PlayerController script attached to the Player object for editing.
  2. Aggiungere l'istruzione using seguente:Add the following using statement:

     using Microsoft.Azure.Engagement.Unity;
    
  3. Aggiungere quanto segue al metodo Start():Add the following to the Start() method

     EngagementAgent.Initialize();
     EngagementAgent.StartActivity("Home");
    

Distribuire ed eseguire l'appDeploy and run the app

Assicurarsi che Android SDK sia installato nel computer prima di provare a distribuire l'app Unity nel dispositivo.Make sure that you have Android SDK installed on your machine before attempting to deploy this Unity app to your device.

  1. Connettere un dispositivo Android al computer.Connect an Android device to your machine.
  2. Aprire File -> Build Settings (File -> Impostazioni compilazione)Open up File -> Build Settings

  3. Selezionare Android e quindi fare clic su Switch Platform (Cambia piattaforma)Select Android and then click on Switch Platform

  4. Fare clic su Player Settings e fornire un identificatore del bundle valido.Click on Player settings and provide a valid Bundle Identifier.

  5. Infine, fare clic su Build And RunFinally click on Build And Run

  6. Potrebbe essere necessario specificare un nome della cartella in cui archiviare il pacchetto Android.You may be asked to provide a folder name to store the Android package.
  7. Se tutto va bene, il pacchetto verrà distribuito nel dispositivo connesso e il gioco Unity sarà disponibile nel telefono.If everything goes fine, then the package will be deployed to your connected device and you should see your Unity game on your phone!

Connettere l'app con monitoraggio in tempo realeConnect app with real-time monitoring

Questa sezione descrive come connettere l'app al back-end di Mobile Engagement usando la funzionalità di monitoraggio in tempo reale di Mobile Engagement.This section shows you how to connect your app to the Mobile Engagement backend by using the Mobile Engagement's real-time monitoring feature.

  1. Nell'account Azure Mobile Engagement, accertarsi di selezionare l'app che si desidera monitorare e gestire nel portale di Mobile Engagement.In your Azure Mobile Engagement account, make sure you select the app you wish to monitor and manage in the Mobile Engagement portal. Accedere al portale di Mobile Engagement facendo clic sul pulsante Engagement nella parte inferiore.Navigate to your Mobile Engagement portal by clicking the Engage button at the bottom.

  2. Viene visualizzato il portale Mobile Engagement.You will land in the Mobile Engagement portal. Se non è selezionata la scheda Monitoraggio, fare clic su Monitoraggio.If the Monitor tab is not selected, click on the Monitor.
  3. Verranno visualizzati, in tempo reale, tutti i dispositivi in cui l'app verrà avviata.The monitor is ready to show you any device in real time, which will start your app.
  4. Avviare l'app.Start your app now. Se l'integrazione è corretta si noterà una sessione di monitoraggio, che significa che l'app ora è collegata al back-end di Mobile Engagement e sta inviando dati ad esso.You should see one session in the monitor if your integration is correct which means that your app is now connected to the Mobile Engagement backend and is sending data to it.

Abilitare le notifiche push e la messaggistica in-appEnable push notifications and in-app messaging

Creare un progetto Google Firebase con chiave APICreate a Google Firebase project with API key

Nota

Per completare questa procedura, è necessario disporre di un account Google con un indirizzo di posta elettronica verificato.To complete this procedure, you must have a Google account that has a verified email address. Per creare un nuovo account Google, visitare il sito Web all'indirizzo accounts.google.com.To create a new Google account, go to accounts.google.com.

  1. Passare alla console di Firebase ed eseguire l'accesso con le credenziali dell'account Google.Navigate to the Firebase Console and sign-in with your Google account credentials.
  2. Fare clic sul pulsante Create new Project (Crea nuovo progetto) per creare un nuovo progetto.Click on Create new Project button to create a new project. In alternativa, è possibile fare clic su Import Google Project (Importa progetto di Google) per importare un progetto esistente.Alternatively, you can also click on Import Google Project to import and existing project.
  3. Se si è scelto di creare un nuovo progetto, specificare un nome progetto e scegliere un paese/area geografica.If you opted for creating a new project then provide a Project name and choose a Country/Region.
  4. Nella pagina del progetto fare clic sull'ingranaggio delle impostazioni nell'angolo superiore sinistro.On your project page, click the Settings cog wheel at the top left. Nel menu fare clic su Project settings (Impostazioni del progetto).In the menu, click on Project settings.
  5. Fare clic sulla scheda Cloud Messaging in alto.Click on the Cloud Messaging tab at the top.
  6. Prendere nota dei valori di Server Key (Chiave server) e Sender ID (ID mittente), che verranno usati più avanti nel file manifesto Android.Make a note of the Server Key and the Sender ID that you will use later in the Android Manifest file.

Aggiornare EngagementConfigurationUpdate the EngagementConfiguration

  1. Aprire il file di script EngagementConfiguration dalla cartella dell'SDK e aggiornare ANDROID_GOOGLE_NUMBER con il numero di progetto Google ottenuto in precedenza dal portale per sviluppatori di Google Cloud.Open up the EngagementConfiguration script file from the SDK folder and update the ANDROID_GOOGLE_NUMBER with the Google Project Number you obtained earlier from the Google Cloud Developer portal. Si tratta di un valore stringa, assicurarsi quindi che sia racchiuso tra virgolette doppie.This is a string value so make sure to enclose it in double quotes.

  2. Salvare il file.Save the file.
  3. Eseguire File -> Engagement -> Generate Android Manifest (File -> Engagement -> Genera manifesto di Android).Execute File -> Engagement -> Generate Android Manifest. Si tratta del plug-in aggiunto da Mobile Engagement SDK. Facendo clic su di esso verranno aggiornate automaticamente le impostazioni del progetto.This is the plugin added by the Mobile Engagement SDK and clicking on it will automatically update your project settings.

Configurare l'app per la ricezione di notificheConfigure the app to receive notifications

  1. Aprire lo script PlayerController collegato all'oggetto Player per la modifica.Open up the PlayerController script attached to the Player object for editing.
  2. Aggiungere quanto segue al metodo Start() :Add the following to the Start() method

     EngagementReachAgent.Initialize();
    
  3. Ora che l'app è aggiornata, distribuire ed eseguire l'app in un dispositivo in base alle istruzioni riportate di seguito.Now that the app is updated, deploy and run the app on a device per the instructions provided below.

Concedere a Mobile Engagement l'accesso alla chiave API GCMGrant Mobile Engagement access to your GCM API Key

Per consentire a Mobile Engagement di inviare notifiche push per conto dell'utente, è necessario concedere l'accesso alla chiave API.To allow Mobile Engagement to send push notifications on your behalf, you need to grant it access to your API Key. A tale scopo, è necessario configurare la chiave e immetterla nel portale di Mobile Engagement.This is done by configuring and entering your key into the Mobile Engagement portal.

  1. Nel portale di Azure classico verificare che l'app usata per questo progetto sia aperta e fare clic sul pulsante Attiva nella parte inferiore della schermata.From your Azure Classic Portal, ensure you're in the app we're using for this project, and then click the Engage button at the bottom:

  2. Fare quindi clic sulla sezione Impostazioni -> Push nativo per immettere la chiave GCM:Then click the Settings -> Native Push section to enter your GCM Key:

  3. Fare clic sull'icona Modifica vicino a Chiave API nella sezione delle impostazioni GCM, come illustrato di seguito:Click the Edit icon in front of API Key in the GCM Settings section as shown below:

  4. Nella finestra a comparsa incollare la chiave del server GCM ottenuta prima e quindi fare clic su OK.In the pop-up, paste the GCM Server Key you obtained before and then click Ok.

Inviare una notifica all'appSend a notification to your app

A questo punto si crea una campagna di notifica push semplice che invia una notifica push all'app.We will now create a simple push notification campaign that sends a push notification to our app.

  1. Passare alla scheda REACH nel portale di Mobile Engagement.Navigate to the REACH tab in your Mobile Engagement portal.
  2. Fare clic su Nuovo annuncio per creare una campagna di notifica push.Click New announcement to create your push notification campaign.

  3. Impostare il primo campo della campagna seguendo questa procedura:Set up the first field of your campaign through the following steps:

    a.a. Assegnare un nome alla campagna.Name your campaign.

    b.b. Selezionare Notifica di sistema -> Semplice per Tipo di recapito: si tratta di un tipo di notifica push Android semplice con un titolo e una breve riga di testo.Select the Delivery type as System notification -> Simple: This is the simple Android push notification type that features a title and a small line of text.

    c.c. Per Ora di recapito selezionare In qualsiasi momento per consentire all'app di ricevere una notifica anche se non è stata avviata.Select Delivery time as Any time to allow the app to receive a notification whether the app is started or not.

    d.d. Nel testo della notifica digitare il titolo che apparirà in grassetto nel push.In the notification text type the Title which will be in bold in the push.

    e.e. Digitare quindi il messaggioThen type your Message

  4. Scorrere verso il basso e nella sezione Contenuto selezionare Notification only (Solo notifica).Scroll down, and in the Content section, select Notification only.

  5. L'impostazione della campagna più semplice possibile è stata completata.You're done setting the most basic campaign possible. Ora scorrere nuovamente verso il basso e fare clic sul pulsante Crea per salvare la campagna.Now scroll down again and click the Create button to save your campaign.
  6. Come ultimo passaggio, fare clic su Attiva per attivare la campagna e inviare le notifiche push.Last step: click Activate to activate your campaign to send push notifications.