Thiết lập giới hạn thông báo

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Giới thiệu

Bạn có thể đặt các giới hạn liên quan đến việc kiếm tiền, như mô tả trong phần Thực thi các giới hạn kiếm tiền bằng chính sách Kiểm tra giới hạn kiếm tiền. Bạn cũng có thể thiết lập thông báo tự động để cảnh báo cho nhà phát triển và/hoặc người dùng trong tổ chức của bạn khi một hạn mức sắp đạt đến hoặc đã đạt đến.

Bạn có thể thiết lập thông báo tự động cho cả giới hạn tuỳ chỉnh và giới hạn ngầm. Ví dụ: hệ thống đặt một hạn mức ngầm định cho nhà phát triển trả trước, đó là số dư trả trước của họ. Bạn có thể thiết lập thông báo tự động để nhà phát triển của bạn nhận được thông báo nếu họ sắp hết hoặc đã hết số dư trả trước.

Hộp công cụ

Bạn có thể thiết lập thông báo tự động cho các hạn mức bằng giao diện người dùng quản lý hoặc API kiếm tiền. Nếu sử dụng giao diện người dùng, bạn có thể thiết lập thông báo tự động trên trang Thông báo.

Nếu sử dụng API, bạn có thể thiết lập thông báo tự động về hạn mức bằng cách chỉnh sửa mẫu thông báo do tính năng kiếm tiền cung cấp. Sau đó, bạn chỉ định điều kiện dẫn đến việc gửi thông báo do mẫu đã chỉnh sửa cung cấp.

Thiết lập thông báo về hạn mức bằng giao diện người dùng

1. Nhấp vào Thêm trong phần Thông báo trên trang Thêm hạn mức. Thao tác này sẽ mở phần Thông báo.

   

2. Chọn cấp độ cho thông báo. Đây là một ngưỡng dựa trên số tuyệt đối hoặc tỷ lệ phần trăm của cơ sở giới hạn. Chọn:
   • Dấu lớn hơn hoặc bằng (?) hoặc dấu nhỏ hơn hoặc bằng (?) trong trình đơn thả xuống.
   • Một số nguyên (tức là không có chữ số thập phân). Tuyệt đối (để cho biết giá trị số) hoặc Tỷ lệ phần trăm để cho biết giá trị tỷ lệ phần trăm. Đối với giới hạn phần trăm, hãy luôn đảm bảo bạn đặt giới hạn thành >, tức là thông báo sẽ được gửi khi nhà phát triển đạt đến hoặc vượt quá mức phần trăm đó.

   Ví dụ: nếu bạn đặt hạn mức chi tiêu là 1.000.000 VND và đặt thông báo ở mức lớn hơn hoặc bằng 90%, thì thông báo sẽ được gửi khi bạn đạt đến hoặc vượt quá 90% hạn mức (900.000 VND).

   

3. Trong trường Gửi email, hãy chọn một hoặc nhiều nhà phát triển hoặc chọn một hoặc nhiều người dùng trong tổ chức của bạn. Thông báo sẽ được gửi đến những nhà phát triển hoặc người dùng bị ảnh hưởng.

   Người nhận email: Bạn chỉ có thể gửi thông báo cho nhà phát triển nếu đặt điều kiện Giới hạn nhà phát triển là "Bất kỳ" hoặc đặt điều kiện Giới hạn nhà phát triển cho một nhà phát triển cụ thể. Nếu chọn "Bất kỳ", bạn sẽ thấy "Nhà phát triển đã chọn (Bất kỳ)" trong danh sách địa chỉ email. Điều này có nghĩa là hoạt động kiếm tiền sẽ gửi thông báo đến mọi nhà phát triển bị ảnh hưởng. Nếu đã chọn một nhà phát triển cụ thể, bạn sẽ thấy "Nhà phát triển đã chọn ({developer_id})" trong danh sách địa chỉ email (trong đó {developer_id} là thông tin nhận dạng của nhà phát triển đã chọn). Tính năng kiếm tiền sẽ chỉ gửi thông báo cho nhà phát triển cụ thể đó.

   Nếu không chọn điều kiện giới hạn Nhà phát triển là "Bất kỳ" hoặc một nhà phát triển cụ thể, bạn sẽ không thấy "Nhà phát triển đã chọn (Bất kỳ)" trong trường Gửi email. Tuy nhiên, bạn có thể chọn những người dùng trong tổ chức mà bạn muốn thông báo.

   Bạn có thể thêm địa chỉ email cho người dùng trong tổ chức bằng cách chọn Người dùng tổ chức trong thẻ Quản trị viên.

   Mẫu email: Bạn sẽ thấy một mẫu email sau khi chọn "Nhà phát triển đã chọn (Bất kỳ)" hoặc địa chỉ email của người dùng trong tổ chức của bạn (hoặc cả hai) trong trường Gửi email. Nội dung xuất hiện trong mẫu tuỳ thuộc vào những yếu tố sau:

   • Cấp độ của thông báo.
   • Hạn mức có phải là hạn mức dừng thực thi hay không.
   • Email đó dành cho người dùng tổ chức, nhà phát triển hay cả hai.

   Ví dụ: nếu tất cả các điều kiện sau đều được đáp ứng:

   • Hộp kiểm Dừng thực thi được đánh dấu.
   • Mức thông báo là 100% hoặc bằng với hạn mức.
   • Email này chỉ dành cho người dùng trong tổ chức.

   Mẫu này có dạng như sau:

   

   Giả sử tên công ty của nhà phát triển là "Công ty XYZ", hạn mức số lượng giao dịch được đặt ở mức 50 cho một gói API có tên là "Gói X" và một Sản phẩm API có tên là "Sản phẩm Y", đồng thời ngày hết hạn được đặt là ngày 30 tháng 9 năm 2013. Nội dung email được gửi sẽ có dạng như sau:

   Developer XYZ company has exceeded their transaction volume limit of 50 transactions for X package, Y product. Their API calls will be blocked till 2013-09-30

   Nếu email được gửi đến "Nhà phát triển được chọn (Bất kỳ)", thì mẫu sẽ xuất hiện như sau:

   

   Cả hai mẫu này sẽ giải quyết các biến có liên quan, chẳng hạn như tên nhà phát triển (nếu có), tên gói (nếu có) và tên sản phẩm (nếu có). Bạn có thể chỉnh sửa thông báo cho phù hợp với yêu cầu của mình bằng cách nhấp vào Chỉnh sửa ở bên trái mẫu.

   Nếu hạn mức là "Bất kỳ" hoặc một ứng dụng cụ thể và "Bất kỳ" hoặc một người dùng cụ thể, bạn cũng cần thêm các biến cho(các) ứng dụng và(các) người dùng vào mẫu. Bạn có thể làm như sau:

   • Nhấp vào biểu tượng Chỉnh sửa ở bên trái mẫu.
   • Thêm ${user.name} user, depending on whether the limit is for application and/or user.

   Dưới đây là mẫu được chỉnh sửa cho "Bất kỳ" hoặc một ứng dụng cụ thể.

   

   Nếu bạn không đánh dấu vào ô Dừng thực thi hoặc cấp thông báo lớn hơn hoặc bằng 100%, thì mẫu dành cho nhà phát triển đã chọn sẽ có dạng như sau:

   

   Tương tự, nếu hạn mức là cho "Bất kỳ" (hoặc một) ứng dụng cụ thể, hoặc "Bất kỳ" (hoặc một) người dùng cụ thể, bạn cần chỉnh sửa mẫu rồi thêm ứng dụng ${application.name} và/hoặc người dùng ${user.name}, tuỳ thuộc vào việc hạn mức là cho ứng dụng, người dùng hay cả hai.

   Biến mẫu: Khi chỉnh sửa thông báo trong mẫu email, bạn có thể thêm bất kỳ biến nào sau đây.

   Biến	Nội dung mô tả
   ${developer.name}	Tên của nhà phát triển.
   ${developer.legalName}	Tên công ty của nhà phát triển.
   ${ratePlan.monetizationPackage.displayName}	Tên của gói API.
   ${application.name}	Tên ứng dụng.
   ${USER}	Tên của người dùng.
   ${USAGE}	Mức sử dụng hiện tại (tổng doanh thu hoặc phí, hoặc số lượng).
   ${PERCENT}	Tỷ lệ phần trăm hạn mức mà mức sử dụng hiện tại đã đạt đến.
   ${QUOTA_TYPE}	Loại hạn mức (số lượng giao dịch, hạn mức chi tiêu hoặc mức phí).
   ${QUOTA_UNIT}	Đơn vị cơ bản cho hạn mức: đơn vị tiền tệ (đối với hạn mức chi tiêu) hoặc số lượt gọi (đối với giới hạn giao dịch).
   ${QUOTA_LIMIT}	Số tiền hạn mức.
   ${EXPIRY_DATE}	Ngày hoặc giờ mà hạn mức hết hạn hoặc được đặt lại.

   Ví dụ: nếu muốn nhận thông báo khi nhà phát triển đạt đến một tỷ lệ phần trăm nhất định về số lượng giao dịch cho bất kỳ gói nào trên bất kỳ ứng dụng nào, bạn có thể chỉnh sửa mẫu để có dạng như sau:

   ${developer.legalName} has reached a total volume of ${USAGE} on ${ratePlan.monetizationPackage.displayName}. This is ${PERCENT} of the daily/weekly/monthly (state period of limit as appropriate) transaction volume limit of ${QUOTA_LIMIT}.

4. Thêm thông báo nếu cần cho các cấp độ khác. Đối với mỗi cấp độ bổ sung, hãy nhấp vào Thêm. Thao tác này sẽ thêm một cấp độ, tính năng Gửi email và vùng Mẫu email vào phần Thông báo của trang. Bạn có thể thêm tối đa 6 cấp độ cho thông báo. Ví dụ: nếu bạn đặt thông báo là > 70%, 80%, 90%, 100%, thì thông báo sẽ được gửi khi đạt đến từng cấp độ này.
5. Sau khi bạn thêm tất cả thông báo, hãy nhấp vào Lưu (để lưu và xuất bản thông báo vào một ngày sau đó), Lưu và xuất bản (để xuất bản ngay) hoặc Huỷ (để huỷ).

Thiết lập thông báo về hạn mức bằng API

Tính năng kiếm tiền cung cấp một bộ mẫu chứa văn bản cho nhiều loại thông báo, bao gồm cả thông báo về hạn mức cũng như thông báo đặc biệt, chẳng hạn như thông báo cho nhà phát triển về việc có sản phẩm mới. Bạn có thể điều chỉnh bất kỳ mẫu nào trong số này cho phù hợp với nhu cầu của mình. Để thiết lập thông báo tự động về giới hạn, trước tiên, hãy chỉnh sửa một mẫu phù hợp. Sau đó, hãy chỉ định điều kiện dẫn đến việc gửi thông báo do mẫu đã chỉnh sửa cung cấp. Để biết thêm thông tin chi tiết, hãy xem phần Thiết lập thông báo bằng cách sử dụng mẫu thông báo.

Các bước tiếp theo

Tìm hiểu cách thiết lập thông báo tự động để bạn có thể cảnh báo nhà phát triển về các sự kiện như sản phẩm mới, phiên bản mới của Điều khoản và điều kiện hoặc gói giá mới. Hãy xem bài viết Thiết lập thông báo bằng cách sử dụng mẫu thông báo.