Краткое руководство. Обработка событий электронной почты
Статья
Начало работы с Службы коммуникации Azure с помощью Сетка событий Azure для обработки событий электронной почты служб коммуникации. После подписки на события электронной почты, такие как отчеты о доставке и отчеты об участии, вы создаете и получаете эти события. Выполнение этого краткого руководства предполагает небольшую дополнительную плату в несколько центов США в учетной записи Azure.
Ресурс служб коммуникации. Подробные сведения см. в статье "Создание ресурса Службы коммуникации Azure".
Ресурс электронной почты с подготовленным доменом. Создайте ресурс электронной почты.
Сведения о службе "Сетка событий Azure"
Сетка событий — это облачная служба событий. В этой статье вы узнаете, как подписаться на события службы коммуникации и активировать событие для просмотра результата. Как правило, события отправляются на конечную точку, которая обрабатывает данные событий и выполняет соответствующие действия. В рамках этой статьи события отправляются в веб-приложение, которое собирает и отображает сообщения.
Настройка среды
Чтобы настроить среду, которую мы будем использовать для создания и получения событий, выполните действия, описанные в следующих разделах.
Регистрация поставщика ресурсов Сетки событий
Если вы ранее не использовали сетку событий в подписке Azure, может потребоваться зарегистрировать поставщика ресурсов Сетки событий. Чтобы зарегистрировать поставщика, выполните следующие действия.
Перейдите на портал Azure.
В меню слева выберите Подписки.
Выберите подписку, используемую для сетки событий.
В разделе Параметры выберите Поставщики ресурсов.
Найдите Microsoft.EventGrid.
Если поставщик ресурсов не зарегистрирован, выберите "Зарегистрировать".
Регистрация может занять некоторое время. Щелкните Обновить, чтобы обновить состояние. Когда зарегистрировано в разделе "Состояние", вы будете готовы продолжить.
Развертывание средства просмотра сетки событий
В этом кратком руководстве мы будем использовать средство просмотра сетки событий для просмотра событий практически в реальном времени. Средство просмотра предоставляет пользователю возможности веб-канала в режиме реального времени. Кроме того, полезные данные каждого события должны быть доступны для проверки.
Подписка на события электронной почты с помощью веб-перехватчиков
Вы можете подписаться на определенные события, чтобы предоставить сетку событий сведения о том, куда отправлять события, которые требуется отслеживать.
На портале перейдите к созданному ресурсу Служб коммуникации.
В ресурсе Служб коммуникации в меню слева на странице служб коммуникации выберите "События".
Выберите "Добавить подписку на события".
На странице "Создание подписки на событие" введите имя подписки на события.
В разделе "Типы событий" выберите события, на которые вы хотите подписаться. Для электронной почты можно выбрать Email Delivery Report Received и Email Engagement Tracking Report Received.
Если вам предложено ввести имя системного раздела, можно предоставить уникальную строку. Значение в этом поле не влияет на вашу работу и используется для внутренней телеметрии.
Для типа конечной точки выберите веб-перехватчик.
Для конечной точки выберите " Выбрать конечную точку" и введите URL-адрес веб-приложения.
В этом случае мы будем использовать URL-адрес из средства просмотра сетки событий, который мы настроили ранее в кратком руководстве. URL-адрес примера имеет следующий формат: https://{{site-name}}.azurewebsites.net/api/updates
Выберите Подтвердить выбор.
Просмотр событий электронной почты
Чтобы создать и получить события электронной почты, выполните действия, описанные в следующих разделах.
Email Delivery Report Received события создаются, когда состояние электронной почты находится в состоянии терминала, например "Доставлено", "Сбой", "Отфильтровано", "Карантин".
Email Engagement Tracking Report Received события создаются при открытии сообщения электронной почты или нажатии ссылки в сообщении электронной почты. Чтобы активировать событие, необходимо включить User Interaction Tracking параметр в ресурсе домена электронной почты.
Полный список событий, поддерживаемых службами коммуникации.
Получение событий электронной почты
После создания события вы заметите, что Email Delivery Report Received и Email Engagement Tracking Report Received события отправляются в конечную точку. Эти события отображаются в средстве просмотра сетки событий, который мы настроили в начале этого краткого руководства. Щелкните значок глаза рядом с событием, чтобы увидеть всю полезные данные. События должны выглядеть следующим образом:
EngagementContext ссылается на ссылку, щелкнув при использовании ClickengagementType.
UserAgent относится к агенту пользователя, из которого возникло это событие взаимодействия с электронной почтой. Например, Если пользователь взаимодействовал с 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.
Если вы хотите отменить и удалить подписку на Службы коммуникации, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы. См. сведения об очистке ресурсов.
Следующие шаги
Из этого краткого руководства вы узнали, как использовать события электронной почты. Вы можете получать события электронной почты, создав подписку "Сетка событий".
Создавайте комплексные решения в Microsoft Azure для создания Функции Azure, реализации веб-приложений и управления ими, разработке решений, использующих службу хранилища Azure, и т. д.