Hızlı Başlangıç: Email olayları işleme

İletişim Hizmetleri Email olaylarını işlemek için Azure Event Grid kullanarak Azure İletişim Hizmetleri kullanmaya başlayın. Teslim raporları ve katılım raporları gibi Email olaylara abone olduktan sonra bu olayları oluşturup alırsınız. Bu hızlı başlangıcı tamamlamak, Azure hesabınızda birkaç ABD doları veya daha az bir maliyete neden olur.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
• İletişim Hizmetleri kaynağı. Ayrıntılı bilgi için bkz. Azure İletişim Hizmetleri kaynağı oluşturma.
• Sağlanan etki alanına sahip Email kaynağı. bir Email Kaynağı oluşturun.

Event Grid Hakkında

Event Grid , bulut tabanlı bir olay hizmetidir. Bu makalede, iletişim hizmeti olaylarına abone olmayı ve sonucu görüntülemek için bir olayı tetiklemeyi öğreneceksiniz. Normalde olayları, olay verilerini işleyen ve eylemler gerçekleştiren bir uç noktaya gönderirsiniz. Bu makalede, olayları iletileri toplayan ve görüntüleyen bir web uygulamasına göndereceğiz.

Ortamı ayarlama

Olayları oluşturmak ve almak için kullanacağımız ortamı ayarlamak için aşağıdaki bölümlerdeki adımları uygulayın.

Event Grid kaynak sağlayıcısını kaydetme

Daha önce Azure aboneliğinizde Event Grid kullanmadıysanız Event Grid kaynak sağlayıcınızı kaydetmeniz gerekebilir. Sağlayıcıyı kaydetmek için şu adımları izleyin:

1. Azure portala gidin.
2. Soldaki menüde Abonelikler'i seçin.
3. Event Grid için kullandığınız aboneliği seçin.
4. Sol menüdeki Ayarlar'ın altında Kaynak sağlayıcıları'nı seçin.
5. Microsoft.EventGrid öğesini bulun.
6. Kaynak sağlayıcınız kayıtlı değilse Kaydet'i seçin.

Kaydın tamamlanması biraz zaman alabilir. Durumu güncelleştirmek için Yenile'yi seçin. Durum'unaltında Kayıtlı göründüğünde devam etmeye hazırsınız demektir.

Event Grid görüntüleyicisini dağıtma

Bu hızlı başlangıçta, olayları neredeyse gerçek zamanlı olarak görüntülemek için bir Event Grid görüntüleyicisi kullanacağız. Görüntüleyici, kullanıcıya gerçek zamanlı akış deneyimi sağlar. Ayrıca, her olayın yükü inceleme için kullanılabilir olmalıdır.

Görüntüleyiciyi ayarlamak için Azure Event Grid Görüntüleyicisi'ndeki adımları izleyin.

Web kancalarını kullanarak Email olaylara abone olma

Event Grid'e izlemek istediğiniz olayların nereye gönderileceği hakkında bilgi sağlamak için belirli olaylara abone olabilirsiniz.

1. Portalda, oluşturduğunuz İletişim Hizmetleri kaynağına gidin.

2. İletişim Hizmetleri kaynağının içinde, İletişim Hizmetleri sayfasının sol menüsünde Olaylar'ı seçin.

3. Olay Aboneliği Ekle'yi seçin.

   

4. Olay Aboneliği Oluştur sayfasında, olay aboneliği için bir ad girin.

5. Olay Türleri'nin altında abone olmak istediğiniz olayları seçin. Email için ve Email Engagement Tracking Report Receivedöğesini seçebilirsinizEmail Delivery Report Received.

6. Sistem Konusu Adı sağlamanız istenirse, benzersiz bir dize sağlamaktan çekinmeyin. Bu alanın deneyiminiz üzerinde hiçbir etkisi yoktur ve iç telemetri amacıyla kullanılır.

   

7. Uç nokta türü için Web Kancası'yı seçin.

   

8. Uç Nokta için Uç nokta seçin'i seçin ve web uygulamanızın URL'sini girin.

   Bu durumda, hızlı başlangıçta daha önce ayarladığımız Event Grid görüntüleyicisinin URL'sini kullanacağız. Örneğin URL'si şu biçimdedir: https://{{site-name}}.azurewebsites.net/api/updates

9. Seçimi Onayla'yı seçin.

   

Email olaylarını görüntüleme

Email olayları oluşturmak ve almak için aşağıdaki bölümlerdeki adımları uygulayın.

Email olayları tetikleme

Olay tetikleyicilerini görüntülemek için bazı olaylar oluşturmamız gerekir. Bir olayı tetikleyebilmek için İletişim Hizmetleri kaynağına eklenmiş Email etki alanı kaynağını kullanarak e-posta gönderin.

• Email Delivery Report Receivedolaylar, Email durumu terminal durumunda olduğunda (teslim edildi, Başarısız, FilteredSpam, Karantinaya alındı) oluşturulur.
• Email Engagement Tracking Report Received olaylar, gönderilen e-posta açıldığında veya e-posta içindeki bir bağlantıya tıklandığında oluşturulur. Bir olayı tetikleyebilmek için Email etki alanı kaynağında seçeneğini açmanız User Interaction Tracking gerekir

İletişim Hizmetleri'nin desteklediği olayların tam listesine göz atın.

Email olayları alma

Bir olay oluşturduktan sonra ve Email Engagement Tracking Report Received olaylarının Email Delivery Report Received uç noktanıza gönderildiğini fark edeceksiniz. Bu olaylar, bu hızlı başlangıcın başında ayarladığımız Event Grid görüntüleyicisinde gösterilir. Yükün tamamını görmek için etkinliğin yanındaki göz simgesini seçin. Olaylar aşağıdaki verilere benzer görünmelidir:

• EngagementContext engagementType olduğunda tıklanan bağlantıya başvurur Click.
• UserAgent bu e-posta etkileşimi olayının kaynaklandığı User-Agent ifade eder. Örn. Kullanıcı Bir Win10 makinesi kullanarak Edge'de etkileşime girdiyse: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, Gecko gibi) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
• EngagementType görevlendirme türünü ifade eder, olası değerler 'Görünüm' veya 'Tıklama'dır.

Olay şemaları ve diğer olay kavramları hakkında daha fazla bilgi edinin.

Kaynakları temizleme

İletişim Hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler. Kaynakları temizleme hakkında daha fazla bilgi edinin.

Sonraki adımlar

Bu hızlı başlangıçta, Email olayları kullanmayı öğrendiniz. Event Grid aboneliği oluşturarak Email olayları alabilirsiniz.

E-posta Gönderme

Şema bilgileri ve örnek olaylar için bkz. Azure İletişim Hizmetleri - Email olayları.

Aşağıdaki makaleleri de görmek isteyebilirsiniz:

• Olay işleme kavramları hakkında bilgi edinin
• Event Grid hakkında bilgi edinin