Guida introduttiva: Gestire gli eventi Email

  • Articolo

Iniziare a usare Servizi di comunicazione di Azure usando Griglia di eventi di Azure per gestire gli eventi Email di Servizi di comunicazione. Dopo aver effettuato la sottoscrizione a Email eventi, ad esempio report di recapito e report di coinvolgimento, si generano e ricevono questi eventi. Le procedure illustrate in questa guida di avvio rapido comportano l'addebito di qualche centesimo (USD) o meno nell'account Azure.

Prerequisiti

Informazioni su Griglia di eventi

Griglia di eventi è un servizio di eventi basato sul cloud. In questo articolo si apprenderà come sottoscrivere eventi del servizio di comunicazione e attivare un evento per visualizzare il risultato. In genere, si inviano eventi a un endpoint che elabora i dati dell'evento e intraprende azioni. In questo articolo gli eventi vengono inviati a un'app Web che raccoglie e visualizza i messaggi.

Configurare l'ambiente

Per configurare l'ambiente che verrà usato per generare e ricevere eventi, seguire questa procedura nelle sezioni seguenti.

Registrare un provider di risorse griglia di eventi

Se griglia di eventi non è stata usata in precedenza nella sottoscrizione di Azure, potrebbe essere necessario registrare il provider di risorse griglia di eventi. Per registrare il provider, seguire questa procedura:

  1. Accedere al portale di Azure.
  2. Nel menu a sinistra selezionare Sottoscrizioni.
  3. Selezionare la sottoscrizione usata per Griglia di eventi.
  4. Nel menu sinistro, in Impostazioni, scegliere Provider di risorse.
  5. Cercare Microsoft.EventGrid.
  6. Se il provider di risorse non è registrato, selezionare Registra.

La registrazione può richiedere qualche secondo. Selezionare Aggiorna per aggiornare lo stato. Quando viene visualizzato Registrato in Stato, è possibile continuare.

Distribuire il visualizzatore griglia di eventi

Per questa guida introduttiva si userà un visualizzatore griglia di eventi per visualizzare gli eventi in tempo quasi reale. Il visualizzatore fornisce all'utente l'esperienza di un feed in tempo reale. Inoltre, il payload di ogni evento deve essere disponibile per l'ispezione.

Per configurare il visualizzatore, seguire la procedura descritta in Visualizzatore Griglia di eventi di Azure.

Sottoscrivere gli eventi Email usando gli hook Web

È possibile sottoscrivere eventi specifici per fornire a Griglia di eventi informazioni su dove inviare gli eventi da tenere traccia.

  1. Nel portale passare alla risorsa Servizi di comunicazione creata.

  2. All'interno della risorsa Servizi di comunicazione selezionare Eventi nel menu a sinistra della pagina Servizi di comunicazione.

  3. Selezionare Aggiungi sottoscrizione evento.

    Screenshot che mostra la pagina Eventi di una risorsa Servizi di comunicazione di Azure. Viene chiamato il pulsante Sottoscrizione eventi.

  4. Nella pagina Crea sottoscrizione evento immettere un nome per la sottoscrizione dell'evento.

  5. In Tipi di eventi selezionare gli eventi che si desidera sottoscrivere. Per Email, è possibile scegliere Email Delivery Report Received e Email Engagement Tracking Report Received.

  6. Se viene chiesto di specificare un valore per Nome dell'argomento del sistema, è possibile fornire una stringa univoca. Questo campo non ha effetto sull'esperienza utente e viene usato solo a scopi di telemetria interna.

    Screenshot che mostra la finestra di dialogo Crea sottoscrizione eventi. In Tipi di evento, vengono selezionati Email Report di recapito ricevuti e Email Report di rilevamento engagement ricevuti.

  7. Per Tipo di endpoint selezionare Web Hook.

    Screenshot che mostra un dettaglio della finestra di dialogo Crea sottoscrizione evento. Nell'elenco Tipo di endpoint è selezionato Web Hook.

  8. Per Endpointselezionare Seleziona un endpoint e quindi immettere l'URL dell'app Web.

    In questo caso, verrà usato l'URL dal visualizzatore griglia di eventi configurato in precedenza nella guida introduttiva. L'URL dell'esempio ha questo formato: https://{{site-name}}.azurewebsites.net/api/updates

  9. Selezionare Confermare la selezione.

    Screenshot che mostra la finestra di dialogo Seleziona collegamento Web. La casella Endpoint sottoscrittore contiene un URL e un pulsante Conferma selezione è visibile.

Visualizzare gli eventi Email

Per generare e ricevere eventi Email, seguire questa procedura nelle sezioni seguenti.

Attivare eventi Email

Per visualizzare i trigger di eventi, è necessario generare alcuni eventi. Per attivare un evento, inviare un messaggio di posta elettronica usando la risorsa di dominio Email collegata alla risorsa Servizi di comunicazione.

  • Email Delivery Report Receivedgli eventi vengono generati quando lo stato del Email è in stato terminale, ad esempio Recapitato, Non riuscito, FilteredSpam, In quarantena.
  • Email Engagement Tracking Report Received gli eventi vengono generati quando il messaggio di posta elettronica inviato viene aperto o viene fatto clic su un collegamento all'interno del messaggio di posta elettronica. Per attivare un evento, è necessario attivare l'opzione nella User Interaction Tracking risorsa di dominio Email

Vedere l'elenco completo degli eventi supportati da Servizi di comunicazione.

Ricevere eventi Email

Dopo aver generato un evento, si noterà che Email Delivery Report Received e Email Engagement Tracking Report Received gli eventi vengono inviati all'endpoint. Questi eventi vengono visualizzati nel visualizzatore griglia di eventi configurato all'inizio di questa guida introduttiva. Selezionare l'icona dell'occhio accanto all'evento per visualizzare l'intero payload. Gli eventi devono essere simili ai dati seguenti:

Screenshot del visualizzatore Griglia di eventi di Azure che mostra lo schema griglia di eventi per un report di recapito EMAIL ricevuto.

Screenshot del visualizzatore di Griglia di eventi di Azure che mostra lo schema griglia di eventi per un evento di report di rilevamento dell'engagement EMAIL.

  • EngagementContext fa riferimento al collegamento fatto clic quando il engagementType è Click.
  • UserAgent fa riferimento alla User-Agent da cui ha avuto origine questo evento di engagement tramite posta elettronica. Ad esempio: Se l'utente ha interagito su Edge usando un computer Win10: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, come Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType fa riferimento al tipo di coinvolgimento, i valori possibili sono "Visualizza" o "Click".

Altre informazioni sugli schemi di eventi e altri concetti relativi agli eventi.

Pulire le risorse

Per pulire e rimuovere una sottoscrizione di Servizi di comunicazione, è possibile eliminare la risorsa o il gruppo di risorse. Eliminando il gruppo di risorse vengono eliminate anche tutte le altre risorse associate. Vedere altre informazioni sulla pulizia delle risorse.

Passaggi successivi

In questa guida introduttiva si è appreso come usare gli eventi Email. È possibile ricevere Email eventi creando una sottoscrizione di Griglia di eventi.

Send Email (Invia messaggi di posta elettronica)

Per informazioni sullo schema ed eventi di esempio, vedere Servizi di comunicazione di Azure - eventi Email.

È anche possibile visualizzare gli articoli seguenti: