hatang.dev

Lịch sử email, số liệu và nhật ký

Biết chuyện gì đã xảy ra với từng email, xem tỉ lệ tới hộp thư, mở, click, bị trả lại và báo spam, và xem các lệnh gọi API từ website của bạn.

Cập nhật ngày

Trong bài này

Hạ Tầng có ba góc nhìn về email của bạn. Email trả lời "lá thư này đã ra sao?", Số liệu trả lời "email của chúng ta nhìn chung có tốt không?", còn Logs cho thấy website hay ứng dụng của bạn đã yêu cầu Hạ Tầng làm gì, hữu ích khi email không hề được gửi đi.

Email: lịch sử từng lá thư

Email → Email liệt kê mọi email doanh nghiệp đã gửi, mới nhất ở trên: từ website hay ứng dụng, qua SMTP relay, chiến dịch email và automation. Tìm theo người nhận, tiêu đề hoặc người gửi, và lọc theo trạng thái và nguồn (API, SMTP, Chiến dịch email).

Trạng thái Ý nghĩa
Trong hàng đợi Đã nhận, sắp được gửi
Đã lên lịch Đang chờ tới giờ đã hẹn
Đã gửi Đã chuyển cho dịch vụ chuyển phát, đang chờ máy chủ nhận trả lời
Đã gửi đến Máy chủ nhận đã chấp nhận thư
Gửi chậm Máy chủ nhận tạm thời chưa nhận thư; hệ thống sẽ thử gửi lại
Bị trả lại Bị từ chối hẳn, hoặc mọi người nhận đều nằm trong danh sách chặn
Bị báo spam Người nhận đã báo thư là spam
Đã huỷ Email hẹn giờ bị huỷ trước khi gửi
Thất bại Không gửi được

Mở một email để xem nội dung (HTML, văn bản và mã nguồn), trạng thái của từng người nhận, và mọi sự kiện kèm thời gian. Khi tên miền bật theo dõi mở hoặc nhấp, phần Tương tác hiện số lượt mở duy nhất và tổng, cùng số lượt nhấp trên từng link.

"Khách không nhận được email"

  1. Tìm địa chỉ của khách ở Email → Email.
  2. Không có email nào: website hay ứng dụng chưa hề gửi. Xem phần Logs bên dưới, hoặc cài đặt SMTP relay trong ứng dụng.
  3. Bị trả lại: mở email và đọc lý do. Nếu người nhận hiện Bị chặn, địa chỉ đang nằm trong danh sách chặn; xem Danh sách chặn và thư bị trả lại. Nếu không, nhiều khả năng địa chỉ bị gõ sai.
  4. Đã gửi đến: thư đã tới máy chủ thư của khách. Nhờ khách xem thư mục spam và tab Quảng cáo, và thêm địa chỉ của bạn vào danh bạ.
  5. Gửi chậm: máy chủ của khách đang tạm từ chối; Hạ Tầng tiếp tục thử lại.

Số liệu: email của bạn hoạt động thế nào

Email → Số liệu hiện 7 ngày, 14 ngày hoặc 30 ngày gần nhất, cho mọi tên miền hoặc một tên miền. Ngày tính theo giờ Việt Nam.

Số liệu hai tuần: lượng thư mỗi ngày và biểu đồ bị trả lại, báo spam
Số liệu hai tuần: lượng thư mỗi ngày và biểu đồ bị trả lại, báo spam
Chỉ số Cách tính
Đã gửi Số người nhận Hạ Tầng đã gửi tới, không tính người bị chặn và thư đã huỷ
Tỉ lệ tới hộp thư Số thư tới nơi trên số đã gửi
Tỉ lệ mở Số người mở ít nhất một lần, trên số thư tới nơi
Tỉ lệ click Số người nhấp ít nhất một lần, trên số thư tới nơi
Tỉ lệ bị trả lại Số thư bị trả lại trên số đã gửi, tính cả người nhận bị bỏ qua vì nằm trong danh sách chặn
Tỉ lệ báo spam Số lần bị báo spam trên số thư tới nơi

Biểu đồ bị trả lại có đường đứt ở mức 4%, biểu đồ báo spam ở mức 0,08%. Vượt các mức này, Gmail và Yahoo bắt đầu chặn bớt email của bạn hoặc cho vào thư rác. Nếu vượt ngưỡng, hãy dừng lại tìm nguyên nhân trước lần gửi lớn tiếp theo.

Tỉ lệ mở chỉ là ước tính. Apple Mail Privacy Protection và một số trình quét bảo mật tự tải ảnh dù không ai đọc, làm tỉ lệ mở cao lên; ứng dụng chặn ảnh làm tỉ lệ thấp đi. Hãy so sánh tỉ lệ mở giữa các email của chính bạn thay vì với doanh nghiệp khác. Lượt mở và lượt nhấp chỉ được ghi nhận khi tên miền gửi đã bật Theo dõi mở và Theo dõi nhấp (Email → Tên miền, rồi chọn tên miền).

Logs: website của bạn đã yêu cầu gì

Email → Logs ghi lại mọi lệnh gọi tới API của Hạ Tầng bằng API key của doanh nghiệp trong 30 ngày gần nhất, mới nhất ở trên: endpoint, kết quả, thời gian xử lý, key nào đã gọi và công cụ nào (SDK và phiên bản). Xem logs cần quyền Developer trong doanh nghiệp.

Nhật ký API với một lệnh gửi bị từ chối (403) và một template không tồn tại (404)
Nhật ký API với một lệnh gửi bị từ chối (403) và một template không tồn tại (404)
  • Lọc theo trạng thái, phương thức, API key, đường dẫn hoặc user agent. Mọi trạng thái gồm cả lệnh thành công; lọc theo lỗi giúp tìm vấn đề nhanh.
  • Mở một lệnh gọi để xem nội dung đã gửi và Hạ Tầng đã trả lời gì. Mật khẩu, token và API key trong đó được thay bằng [redacted], tệp đính kèm được thay bằng dung lượng.
  • Với lệnh gọi lỗi, nút Chép để hỏi AI sao chép request, response và link tài liệu, sẵn sàng dán vào trợ lý AI hoặc gửi cho lập trình viên.
  • Thao tác từ chính dashboard không được ghi, thư gửi qua SMTP relay cũng không: hãy tìm chúng ở Email.

Các mã trả lời thường gặp:

Mã Ý nghĩa
200 hoặc 202 Đã xong
401 API key sai, đã bị thu hồi, hoặc không được dùng cho tên miền này
403 "domain is not verified" Địa chỉ người gửi không thuộc tên miền đã xác minh của doanh nghiệp, hoặc việc gửi đang tạm dừng
404 Template, contact hoặc email được yêu cầu không tồn tại
422 Request thiếu hoặc sai một trường; thông báo nói rõ trường nào
429 Gọi quá nhiều cùng lúc; website nên thử lại sau một chút

Lập trình viên có thể lấy cùng các số liệu qua API, và tra mọi mã lỗi, trong hướng dẫn số liệu và nhật ký ở trang dành cho lập trình viên.

Bài viết này có giúp ích cho bạn không?

Bài viết liên quan

Chưa tìm thấy điều bạn cần?

Đội ngũ của chúng tôi trả lời qua chat, bằng tiếng Việt hoặc tiếng Anh.

Gửi email cho chúng tôi

Bạn đang tích hợp API hoặc SDK? Xem tài liệu cho lập trình viên →