Come raggiungere gli utenti dell'applicazione con le notifiche pushHow to reach out to the users of your application with push notifications

In questo articolo viene descritta la scheda REACH del portale Mobile Engagement.This article describes the REACH tab of the Mobile Engagement portal. Utilizzare il portale Mobile Engagement per monitorare e gestire le app per dispositivi mobili.You use the Mobile Engagement portal to monitor and manage your mobile apps. Si noti che per iniziare a utilizzare il portale, è innanzitutto necessario creare un account Azure Mobile Engagement .Note that to start using the portal you first need to create an Azure Mobile Engagement account. Per ulteriori informazioni, vedere Creare un account Azure Mobile Engagement.For more information, see Create an Azure Mobile Engagement account.

La sezione Reach dell'interfaccia utente è lo strumento di gestione delle campagne push dove è possibile creare, modificare, attivare, terminare, monitorare e ottenere statistiche per le campagne di notifica push nonché funzionalità a cui è possibile accedere anche tramite l'API Reach e alcuni elementi dell'API Push di basso livello.The Reach section of the UI is the Push campaign management tool where you can create/edit/activate/finish/monitor and get statistics on Push notification campaigns and features that can also be accessed via the Reach API (and some elements of the low level Push API). Tenere presente che, indipendentemente dall'uso delle API o dell'interfaccia utente, è necessario integrare Azure Mobile Engagement e Reach nell'applicazione per ogni piattaforma con l'SDK prima di poter usare le campagne Reach.Remember that whether you are using the APIs or the UI, you will need to integrate both Azure Mobile Engagement and Reach into your application for each platform with the SDK before you can use Reach campaigns.

Nota

Molte sezioni dell'interfaccia utente del portale Mobile Engagement contengono il pulsante MOSTRA GUIDA.Many sections of the Mobile Engagement portal UI contain the SHOW HELP button. Premere questo pulsante per ottenere ulteriori informazioni contestuali su una sezione.Press this button to get more contextual information about a section.

Quattro tipi di notifiche pushFour types of Push notifications

  1. Annunci: consentono di inviare messaggi pubblicitari agli utenti che li reindirizzano a un'altra posizione all'interno dell'app o di inviarli a una pagina Web o a un archivio esterno all'app.Announcements - allow you to send advertising messages to users that redirect them to another location inside your app or to send them to a webpage or store outside of your app.
  2. Sondaggi: consentono di raccogliere informazioni dagli utenti finali ponendo loro domande.Polls - allow you to gather information from end users by asking them questions.
  3. Push di dati: consentono di inviare un file di dati binario o base64.Data Pushes - allow you to send a binary or base64 data file. Le informazioni contenute in un push di dati vengono inviate all'applicazione per modificare l'esperienza corrente degli utenti nell'app.The information contained in a data push is sent to your application to modify your users' current experience in your app. L'applicazione deve essere in grado di elaborare i dati di un push di dati.Your application needs to be able to process the data in a data push.

Dettagli della campagnaCampaign Details

È possibile modificare, duplicare, eliminare o attivare campagne che non sono state ancora attivate passando il puntatore sopra i relativi nomi oppure fare clic per aprirle.You can edit, clone, delete, or activate campaigns that have not been activated yet by hovering over their names or you can click to open them. È possibile duplicare campagne che sono già state attivate passando il puntatore sopra i nomi o fare clic per aprirle.You can clone campaigns that have already been activated by hovering over their names or you can click to open them. Tuttavia, non è possibile modificare una campagna dopo che è stata attivata.However, you can't change a campaign once it has been activated.

Reach1

Feedback di ReachReach Feedback

Per visualizzare i dettagli di una campagna di copertura, fare clic su Statistiche .Click on Statistics to see the details of a Reach campaign. La visualizzazione Semplice offre una rappresentazione visiva in forma di istogramma a barre di ciò che accade dopo l'attivazione di una campagna.The Simple view provides a visual representation in the form of a column bar graph about what happened after a campaign was activated. La visualizzazione Avanzata offre informazioni più granulari sulla campagna push.The Advanced view provides more granular details about the push campaign. Tali informazioni non saranno disponibili se si invia una campagna di prova, ad esempio una campagna push, a un dispositivo di test.These details will not be available if you are sending a test campaign i.e. a push sent to a test device. Le informazioni devono essere interpretate nel modo seguente:Here is how you should interpret these details:

  1. Con push : specifica il numero di messaggi inviati ai dispositivi.Pushed - This specifies the number of messages pushed to the devices. Questo numero dipenderà dai destinatari specificati durante la creazione della campagna push.This number will depend on the target audience you specified while creating the push campaign. Se non si specificano destinatari, i messaggi verranno inviati a tutti i dispositivi registrati.If you do not specify any target audience, then this push will be sent out to all the registered devices. Come per tutti gli altri servizi push, le notifiche push non vengono inviate direttamente ai dispositivi, ma ai rispettivi servizi di notifica push (Push Notification Service, PNS - APN/GCM/WNS) specifici della piattaforma in modo che recapitino le notifiche ai dispositivi.Like all other push services, we do not push the notifications directly to the devices but instead push them to the respective platform specific Push Notification Services (PNS - APNS/GCM/WNS) so that they can deliver the notifications to the devices.
  2. Recapitati : specifica il numero di messaggi recapitati correttamente dal servizio PNS al dispositivo e confermati come ricevuti da Mobile Engagement SDK.Delivered - This specifies the number of messages which are successfully delivered by the PNS to the device and acknowledged as received by Mobile Engagement SDK.

    Motivi per cui il numero dei messaggi Recapitati può essere inferiore al numero dei massaggi Inviati:Reasons for Delivered count being less than Pushed count:

    1. Se l'utente ha disinstallato l'app dal dispositivo, ma il PNS non ne è a conoscenza al momento dell'invio del push, il messaggio verrà eliminato.If the user has uninstalled the app from the device but the PNS doesn't know about it at the time we send the push to the PNS then the message will be dropped.
    2. Se nel dispositivo è installata l'app, ma i dispositivi sono stati offline per lunghi periodi di tempo, il PNS non riuscirà a recapitare il messaggio al dispositivo.If the device has the app but the devices themselves were offline for long periods of time, then the PNS will fail to deliver the message to the device.
    3. Se il messaggio viene recapitato al dispositivo ma Mobile Engagement SDK nell'app non riconosce il contenuto del messaggio, il messaggio viene eliminato.If the message does get delivered to the device but the Mobile Engagement SDK in the app doesn’t recognize the content of the message, then it drops that message. Questo problema può verificarsi se la personalizzazione della notifica nell'app genera un'eccezione che viene rilevata nell'SDK e il messaggio viene eliminato.This could happen if the customization of the notification in the app generates an exception which we catch in the SDK and drop the message. Ciò può verificarsi anche se l'app nel dispositivo usa una versione di Mobile Engagement SDK che non è in grado di comprendere la versione più recente del messaggio push inviato dalla piattaforma, ma solo quando l'app è stata aggiornata dopo l'invio della notifica dalla piattaforma del servizio.This could also occur if the app on the device is using a version of the Mobile Engagement SDK which is not able to understand the newer version of the push message sent from the platform but this is only when the app was upgraded after the notification was dispatched from the service platform. La scheda Avanzate indicherà il numero di messaggi eliminati.The Advanced tab will tell how many messages were dropped.
    4. Nei dispositivi iOS, i messaggi a volte non vengono recapitati se la batteria del dispositivo è scarica o se l'app utilizza una quantità significativa di alimentazione durante l'elaborazione delle notifiche remote.On iOS devices, messages sometimes do not get delivered if either the device is on low battery or if the app is consuming significant amount of power when processing remote notifications. Si tratta di una limitazione dei dispositivi iOS.This is a limitation of the iOS devices.
  3. Visualizzati : specifica il numero di messaggi visualizzati correttamente dall'utente dell'app sul dispositivo sotto forma di una notifica di sistema push o out-of-app nel centro notifiche o di una notifica in-app all'interno dell'app per dispositivi mobili.Displayed - This specifies the number of messages which are successfully shown to the app user on the device in the form of a system push/out-of-app notification in the notification center or an in-app notification within the mobile app. La scheda Avanzate indicherà il numero di notifiche di sistema e il numero di notifiche in-app.The Advanced tab will tell you how many were system notifications and how many were in-app notifications.

    Motivi per cui il numero dei messaggi Visualizzati può essere inferiore al numero dei massaggi Recapitati (in attesa di visualizzazione)Reasons for Displayed count being less than Delivered count (waiting to be displayed)

    1. Se la campagna di notifica ha una data di fine, è possibile che la notifica sia stata recapitata, ma che la campagna fosse già scaduta nel momento in cui la notifica doveva essere aperta e visualizzata all'utente dell'app e che quindi non sia mai stata visualizzata.If the notification campaign had an end date on it then it is possible that the notification was delivered but when the time came to open and display it to the app user, it was already expired so it was never displayed.
    2. Se la notifica è una notifica in-app, viene visualizzata solo quando l'utente dell'app apre l'app.If the notification is an in-app notification then the notification is only displayed when the app user opens the app. Nei casi in cui l'app non è stata aperta dall'utente, l'SDK segnalerà che la notifica è stata recapitata ma non ancora visualizzata, fino all'apertura dell'app.In cases where the app user hasn't opened the app, the SDK will report that the notification was delivered but not yet displayed until the app is opened.
    3. Se la notifica è una notifica in-app ed è configurata per la visualizzazione in un'attività/schermata specifica, anche in questo caso la notifica verrà segnalata come recapitata ma non ancora visualizzata fino all'apertura di una schermata specifica dell'app da parte dell'utente.If the notification is an in-app notification and configured to be shown on a specific activity/screen then also the notification will be reported as delivered but not yet delivered until the user opens the app on a specific screen.
  4. Interazioni dell'utente : specifica il numero di messaggi con cui l'utente dell'app ha interagito e includerà i messaggi attivati o chiusi.User Interactions - This specifies the number of messages which the app user has interacted with and will include the messages which are either actioned or exited.

    • L'utente dell'app può attivare una notifica in uno dei modi seguenti:The app user can action a notification in either of the following ways:

      1. Se la notifica è una notifica di sistema o out-of-app o una notifica in-app inviata come sola notifica, l'utente dell'app deve fare clic sulla notifica.If the notification is a system/out-of-app notification or an in-app notification sent as notification-only then the app user clicks on the notification.
      2. Se la notifica è una notifica in-app con un testo, una visualizzazione Web o sondaggi, l'utente dell'app deve fare clic sul pulsante di attivazione nella notifica.If the notification is an in-app notification with a text or web-view or polls then the app user clicks on the Action button in the notification.
      3. Se la notifica è una notifica in-app con una visualizzazione Web, l'utente dell'app deve fare clic su un URL nella visualizzazione Web [solo per Android]If the notification is an in-app notification with a web-view then the app user clicks on a URL in the web view [Android Only]
    • L'utente dell'app può chiudere una notifica in uno dei modi seguenti:The app user can exit a notification in either of the following ways:

      1. Facendo clic sul pulsante di chiusura direttamente nella notifica.Clicking the close button on the notification directly.
      2. Facendo scorrere rapidamente con un dito o eliminando la notifica.Swiping away or deleting the notification.
      3. Le notifiche in-app con testo o contenuto Web e sondaggi vengono in genere visualizzate dall'utente dell'app con un processo in due passaggi.In-app notifications with text/web content and polls are typically displayed to the app user in a two-step process. Viene prima visualizzata una notifica e, facendo clic su di essa, viene visualizzato il testo, il contenuto Web o i sondaggi.They see a notification first and when they click on it, they see the subsequent text/web/poll content. L'utente dell'app può chiudere una notifica con uno di questi passaggi e i dettagli vengono acquisiti nella visualizzazione Avanzata.The app user can exit a notification in either of these steps and the details in the Advanced view captures this.
  5. Attivati : specifica il numero di messaggi esplicitamente attivati dall'utente dell'app.Actioned - This specifies the number of messages which were explicitly actioned by the app user. Si tratta del dato più interessante, in quanto indica il numero di utenti dell'app interessati al messaggio inviato nella notifica.This is the most interesting number as this tells how many app users were interested by the message you pushed out in the notification.

Nota

Nelle piattaforme iOS e Windows, se l'utente ha l'app aperta e la campagna era di tipo "AnyTime", è possibile che le notifiche out-of-app e in-app vengano visualizzate nello stesso momento.On iOS & Windows platforms, if the user has the app open and the campaign was an "AnyTime" campaign then it is possible that both out of app and in-app notifications are displayed at the same time. Il numero di messaggi Visualizzati può pertanto essere superiore al numero dei messaggi Recapitati.This may cause a Displayed count higher than the Delivered. Se l'utente interagisce con la notifica o la attiva, anche il numero di Interazioni utente o di messaggi Attivati può essere superiore al numero dei messaggi Recapitati.If the user interacts or actions the notification, then even the User Interactions/Actioned count could be greater than Delivered.

Reach2

Vedere ancheSee also