Dzienniki e-mail

Usługi Azure Communication Services oferują funkcje rejestrowania, których można użyć do monitorowania i debugowania rozwiązania usług Komunikacyjnych. Skonfiguruj te możliwości za pośrednictwem witryny Azure Portal.

Wymagania wstępne

Usługi Azure Communications Services udostępniają funkcje monitorowania i analizy za pośrednictwem przeglądu dzienników usługi Azure Monitor i metryk usługi Azure Monitor. Każdy zasób platformy Azure wymaga własnego ustawienia diagnostycznego, które definiuje następujące kryteria:

• Kategorie dzienników i danych metryk wysyłanych do miejsc docelowych zdefiniowanych w ustawieniu. Dostępne kategorie różnią się w zależności od różnych typów zasobów.
• Co najmniej jedno miejsce docelowe do wysyłania dzienników. Bieżące miejsca docelowe obejmują obszar roboczy usługi Log Analytics, usługę Event Hubs i usługę Azure Storage.
• Jedno ustawienie diagnostyczne może definiować nie więcej niż jedno z miejsc docelowych. Jeśli chcesz wysłać dane do więcej niż jednego z określonego typu docelowego (na przykład dwóch różnych obszarów roboczych usługi Log Analytics), utwórz wiele ustawień. Każdy zasób może mieć maksymalnie pięć ustawień diagnostycznych.

Wykonaj poniższe instrukcje, aby skonfigurować zasób usługi Azure Monitor, aby rozpocząć tworzenie dzienników i metryk dla usług Communications Services. Aby uzyskać więcej informacji na temat używania ustawień diagnostycznych we wszystkich zasobach platformy Azure, zobacz: Włączanie rejestrowania w ustawieniach diagnostycznych

Kategorie dzienników zasobów

Usługi komunikacyjne oferują następujące typy dzienników, które można włączyć:

• Dzienniki użycia — udostępnia dane użycia skojarzone z każdą rozliczaną ofertą usług.
• Dzienniki operacyjne wysyłania poczty e-mail — zawierają szczegółowe informacje dotyczące żądań wysyłania wiadomości przez usługę e-mail.
• Dzienniki operacyjne aktualizacji stanu wiadomości e-mail — udostępnia aktualizacje stanu dostarczania na poziomie wiadomości i adresata związane z żądaniami wysyłania wiadomości e-mail przez usługę poczty e-mail.
• Dzienniki operacyjne zaangażowania użytkowników poczty e-mail — zawiera informacje dotyczące metryk zaangażowania użytkownika "otwórz" i "kliknij" dla wiadomości wysyłanych z usługi poczty e-mail.

Schemat dzienników użycia

Operacyjne dzienniki wysyłania poczty e-mail

Dzienniki operacyjne wysyłania e-maili dostarczają cennego wglądu w trendy żądań interfejsu API w czasie. Te dane ułatwiają odnajdywanie kluczowych analiz poczty e-mail, takich jak łączna liczba wysłanych wiadomości e-mail, rozmiar wiadomości e-mail i liczba wiadomości e-mail z załącznikami. Te informacje można szybko analizować w czasie niemal rzeczywistym i wizualizować w przyjazny dla użytkownika sposób, aby ułatwić podejmowanie lepszych decyzji.

Próbki

{
  "OperationType":"SendMail", 
  "OperationCategory":"EmailSendMailOperational",
  "Size":0.026019,
  "ToRecipientsCount":2,
  "CcRecipientsCount":3, 
  "BccRecipientsCount":1, 
  "UniqueRecipientsCount":6, 
  "AttachmentsCount":0,
  "TrafficSource":"Email .NET SDK"
}

Dzienniki operacyjne aktualizacji statusu wiadomości e-mail

Dzienniki operacyjne aktualizacji stanu poczty e-mail zapewniają szczegółowe informacje na temat aktualizacji stanu dostarczania na poziomie komunikatów i adresatów w żądaniach interfejsu API wysyłania poczty e-mail.

• Aktualizacje stanu na poziomie komunikatu zapewniają stan długotrwałej operacji wysyłania wiadomości e-mail (podobnie jak aktualizacje stanu otrzymywane za pośrednictwem wywoływania naszych interfejsów API GET). Są one oznaczone brakiem RecipientId właściwości, ponieważ te aktualizacje dotyczą całej wiadomości i nie mają zastosowania do określonego adresata w tym żądaniu wiadomości. DeliveryStatus właściwość zawiera stan dostarczania na poziomie komunikatu. Możliwe wartości dla DeliveryStatus tego typu zdarzenia to Dropped, OutForDeliveryi Queued.
• Aktualizacje stanu adresata zapewniają stan dostarczania wiadomości e-mail dla każdego indywidualnego adresata, do którego wysłano wiadomość e-mail w jednej wiadomości. Zawierają właściwość RecipientId z adresem e-mail odbiorcy. Stan dostarczania na poziomie odbiorcy jest udostępniany we DeliveryStatus właściwości . Możliwe wartości dla DeliveryStatus tego typu zdarzenia to Delivered, , Expanded, FailedQuarantined, , FilteredSpam, Suppressed, i Bounced. Śledząc te dzienniki, możesz zapewnić pełny wgląd w proces dostarczania poczty e-mail, szybko identyfikując wszelkie problemy, które mogą wystąpić i podejmując odpowiednie działania naprawcze.

Próbki

{
  "OperationType":"DeliveryStatusUpdate", 
  "OperationCategory":"EmailStatusUpdateOperational", 
  "RecipientId":"user@email.com", 
  "DeliveryStatus":"Delivered", 
  "SenderDomain":"contoso.com", 
  "SenderUsername":"donotreply", 
  "IsHardBounce":false
}

Dzienniki operacyjne zaangażowania użytkowników poczty e-mail

Dzienniki operacyjne zaangażowania użytkowników e-mail zapewniają wgląd w trendy zaangażowania w wiadomości e-mail dla systemu poczty e-mail. Te dane ułatwiają śledzenie i analizowanie kluczowych metryk poczty e-mail, takich jak stawki otwarcia, stawki kliknięć i stawki anulowania subskrypcji. Te dzienniki można przechowywać i analizować, co pozwala uzyskać bardziej szczegółowy wgląd w wydajność systemu poczty e-mail i odpowiednio dostosować strategię. Ogólnie rzecz biorąc, dzienniki operacyjne usługi Email User Engagement zapewniają zaawansowane narzędzie do poprawy wydajności systemu poczty e-mail, proaktywnego mierzenia i optymalizowania kampanii e-mail oraz poprawy zaangażowania użytkowników w czasie.

Próbki

{
    "OperationType": "UserEngagementUpdate",
    "OperationCategory": "EmailUserEngagementOperational",
    "EngagementType": "View",
    "UserAgent": "Mozilla/5.0"
}

{
  "OperationType":"UserEngagementUpdate", 
  "OperationCategory":"EmailUserEngagementOperational",
  "EngagementType":"Click",
  "EngagementContext":"https://www.contoso.com/support?id=12345", 
  "UserAgent":"Mozilla/5.0"
}