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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về 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 về hoạt động 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 sắp đạt đến hoặc đạt giới hạn.

Bạn có thể thiết lập thông báo tự động cho các giới hạn tuỳ chỉnh cũng như các giới hạn ngầm định. Ví dụ: hệ thống đặt hạn mức ngầm cho các nhà phát triển trả trước của bạn, đó 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 thông báo nếu họ sắp đến hạn thanh toán hoặc đã dùng 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 về các giới hạn bằng cách sử dụ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ề các giới hạn 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 giới hạn bằng cách sử dụng giao diện người dùng

  1. Nhấp vào Thêm trong phần Thông báo của trang Thêm giới hạn. Thao tác này sẽ mở ra phần Thông báo.

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

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

  3. Trong trường Gửi email, hãy chọn ít nhất một nhà phát triển hoặc chọn một hay nhiều người dùng trong tổ chức của bạn. Chúng tôi sẽ gửi thông báo đế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 bạn đặt điều kiện Giới hạn dành cho nhà phát triển là "Bất kỳ" hoặc đặt điều kiện Giới hạn dành cho nhà phát triển với 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 được chọn (Bất kỳ)" trong danh sách địa chỉ email. Điều này có nghĩa là nhóm kiếm tiền sẽ gửi thông báo cho tất cả 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 được chọn ({developer_id})" trong danh sách địa chỉ email (trong đó {developer_id} là mã nhận dạng của nhà phát triển được 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 dành cho nhà phát triển là "Bất kỳ" hoặc một nhà phát triển cụ thể nào, thì bạn sẽ không thấy "Nhà phát triển được chọn (Bất kỳ)" trong trường Gửi email. Tuy nhiên, bạn có thể chọn người dùng nào trong tổ chức của bạn 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 của mình bằng cách chọn Người dùng tổ chức trong thẻ Quản trị.

    Mẫu email: Bạn sẽ thấy mẫu email sau khi chọn trong trường Gửi email "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).Nội dung xuất hiện trong mẫu tùy thuộc vào các yếu tố sau:

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

    Ví dụ: nếu tất cả các điều sau đều đúng:

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

    Mẫu sẽ 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 gói API có tên "Gói X" và một Sản phẩm API có tên là "Sản phẩm Y" và ngày hết hạn được đặt vào 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ỳ)", mẫu sẽ xuất hiện như sau:

    Cả hai mẫu đều sẽ phân giải 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 giới hạn là cho "Any" hoặc một ứng dụng cụ thể và "Any" 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à người dùng vào mẫu. Bạn có thể thực hiện việc này như sau:

    • Nhấp vào 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.

    Mẫu đã chỉnh sửa cho "Bất kỳ" hoặc một ứng dụng cụ thể được hiển thị bên dưới.

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

    Xin nhắc lại rằng nếu giới hạn là dành cho người dùng "Bất kỳ" (hoặc một người dùng cụ thể) hoặc "Bất kỳ" (hoặc một người dùng cụ thể nào), 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 giới hạn là dành cho một ứng dụng, một người dùng hay cả hai.

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

    Biến 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 gói API.
    ${application.name}

    Tên ứng dụng.
    ${USER}

    Tên người dùng.
    ${USAGE}

    Mức sử dụng hiện tại (tổng doanh thu, chi phí hoặc số lượng).
    ${PERCENT}

    Phần trăm giới hạn đã đạt đến theo mức sử dụng hiện tại.
    ${QUOTA_TYPE}

    Loại hạn mức (khối lượng giao dịch, hạn mức chi tiêu hoặc mức phí).
    ${QUOTA_UNIT}

    Đơn vị cơ bản của hạn mức: đơn vị tiền tệ (cho hạn mức chi tiêu) hoặc cuộc gọi (cho hạn mức giao dịch).
    ${QUOTA_LIMIT}

    Số tiền của hạn mức.
    ${EXPIRY_DATE}

    Ngày hoặc giờ mà giới hạn hết hạn hoặc khi được đặt lại.

    Ví dụ: nếu muốn nhận thông báo khi một nhà phát triển bất kỳ đã đạt đến một tỷ lệ phần trăm khối lượng giao dịch nhất định đối với một gói bất kỳ trên ứng dụng bất kỳ, 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 vùng mẫu Cấp, Gửi email và 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ì hệ thống sẽ gửi thông báo 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à phát hành thông báo 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 giới hạn bằng API

Kiếm tiền cung cấp một bộ mẫu cung cấp văn bản cho nhiều loại thông báo, bao gồm cả thông báo giới hạn 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ề tính sẵn có của 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 giới hạn tự động, trước tiên hãy chỉnh sửa 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 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ể thông báo cho 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 phần Thiết lập thông báo bằng mẫu thông báo.