Поделиться через

Краткое руководство. Обработка событий Email

  • Статья

Начните работу с Службы коммуникации Azure с помощью Сетка событий Azure для обработки событий служб коммуникации Email. После подписки на Email события, такие как отчеты о доставке и отчеты о задействовании, вы создаете и получаете эти события. Выполнение этого краткого руководства предполагает небольшую дополнительную плату в несколько центов США в учетной записи Azure.

Предварительные требования

Сведения о службе "Сетка событий Azure"

Сетка событий — это облачная служба обработки событий. Из этой статьи вы узнаете, как подписаться на события службы коммуникации и активировать событие для просмотра результата. Как правило, события отправляются на конечную точку, которая обрабатывает данные событий и выполняет соответствующие действия. В рамках этой статьи события отправляются в веб-приложение, которое собирает и отображает сообщения.

Настройка среды

Чтобы настроить среду, которая будет использоваться для создания и получения событий, выполните действия, описанные в следующих разделах.

Регистрация поставщика ресурсов Сетки событий

Если вы ранее не использовали Службу "Сетка событий" в подписке Azure, может потребоваться зарегистрировать поставщик ресурсов Сетки событий. Чтобы зарегистрировать поставщика, выполните следующие действия.

  1. Перейдите на портал Azure.
  2. В меню слева выберите Подписки.
  3. Выберите подписку, используемую для Сетки событий.
  4. В разделе Параметры выберите Поставщики ресурсов.
  5. Найдите Microsoft.EventGrid.
  6. Если поставщик ресурсов не зарегистрирован, выберите Зарегистрировать.

Регистрация может занять некоторое время. Щелкните Обновить, чтобы обновить состояние. Когда в разделе Состояние появится значение Зарегистрировано, вы можете продолжить.

Развертывание средства просмотра Сетки событий

В этом кратком руководстве мы будем использовать средство просмотра Сетки событий для просмотра событий практически в реальном времени. Средство просмотра предоставляет пользователю возможности веб-канала в режиме реального времени. Кроме того, полезные данные каждого события должны быть доступны для проверки.

Чтобы настроить средство просмотра, выполните действия, описанные в разделе Сетка событий Azure Viewer.

Подписка на события Email с помощью веб-перехватчиков

Вы можете подписаться на определенные события, чтобы предоставить Сетке событий сведения о том, куда отправлять события, которые требуется отслеживать.

  1. На портале перейдите к созданному ресурсу Служб коммуникации.

  2. В ресурсе Служб коммуникации в меню слева на странице Службы коммуникации выберите События.

  3. Выберите Добавить подписку на события.

    Снимок экрана: страница

  4. На странице Создание подписки на события введите имя подписки на события.

  5. В разделе Типы событий выберите события, на которые вы хотите подписаться. Для Email можно выбрать Email Delivery Report Received и Email Engagement Tracking Report Received.

  6. Если вам предложено ввести имя системного раздела, можно предоставить уникальную строку. Значение в этом поле не влияет на вашу работу и используется для внутренней телеметрии.

    Снимок экрана: диалоговое окно

  7. В поле Тип конечной точки выберите Веб-перехватчик.

    Снимок экрана: сведения о диалоговом окне

  8. В поле Конечная точка выберите Выбрать конечную точку и введите URL-адрес веб-приложения.

    В этом случае мы будем использовать URL-адрес из средства просмотра Сетки событий , который мы настроили ранее в этом кратком руководстве. URL-адрес примера имеет следующий формат: https://{{site-name}}.azurewebsites.net/api/updates

  9. Выберите Подтвердить выбор.

    Снимок экрана: диалоговое окно

Просмотр событий Email

Чтобы создать и получить события Email, выполните действия, описанные в следующих разделах.

Активация событий Email

Чтобы просмотреть триггеры событий, необходимо создать некоторые события. Чтобы активировать событие, отправьте сообщение электронной почты с помощью ресурса домена Email, присоединенного к ресурсу Служб коммуникации.

  • Email Delivery Report Receivedсобытия создаются, когда состояние Email находится в состоянии терминала, т. е. Доставлено, Сбой, ОтфильтрованоСпам, Помещено в карантин.
  • Email Engagement Tracking Report Received события создаются при открытии отправленного сообщения или щелчке ссылки в сообщении электронной почты. Чтобы активировать событие, необходимо включить User Interaction Tracking параметр для ресурса домена Email.

Ознакомьтесь с полным списком событий, поддерживаемых Службами коммуникации.

Получение событий Email

После создания события вы заметите, что Email Delivery Report Received события и Email Engagement Tracking Report Received отправляются в конечную точку. Эти события отображаются в средстве просмотра Сетки событий , которое мы настроили в начале этого краткого руководства. Щелкните значок глаза рядом с событием, чтобы просмотреть все полезные данные. События должны выглядеть примерно так:

Снимок экрана: средство просмотра Сетка событий Azure, в котором показана схема сетки событий для полученного события отчета о доставке по электронной почте.

Снимок экрана: средство просмотра Сетка событий Azure, на котором показана схема Сетки событий для события отчета отслеживания задействования электронной почты.

  • EngagementContext ссылается на ссылку, щелкнув, когда engagementType имеет значение Click.
  • UserAgent относится к User-Agent, из которого возникло это событие взаимодействия с электронной почтой. Например, Если пользователь взаимодействовал в Edge с помощью компьютера Win10: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, например Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType относится к типу задействования, возможные значения: View или Click.

Дополнительные сведения см. в статье Обработка событий в Службах коммуникации Azure.

Очистка ресурсов

Если вы хотите очистить и удалить подписку на Службы коммуникации, вы можете удалить ресурс или группу ресурсов. При этом удаляются все ресурсы, связанные с ней. См. сведения об очистке ресурсов.

Дальнейшие действия

Из этого краткого руководства вы узнали, как использовать события Email. Вы можете получать события Email, создав подписку сетки событий.

Отправка сообщения электронной почты

Сведения о схеме и примеры событий см. в разделе Службы коммуникации Azure — события Email.

Вам также может потребоваться ознакомиться со следующими статьями: