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
Trong gói theo bảng giá, nhà phát triển sẽ bị tính phí cho mỗi giao dịch. Đối với loại kế hoạch này, bạn cần cung cấp thêm thông tin chi tiết, chẳng hạn như mô hình tính phí và giá cho mô hình tính phí.
Bạn có thể chỉ định một gói freemium cho từng sản phẩm (thay vì cho một gói API) — bạn chỉ có thể làm việc này cho một gói dành riêng cho sản phẩm.
Khi nào các khoản phí định kỳ được tính và gói kết hợp được đặt lại?
Kế hoạch giá có thể bao gồm các khoản phí định kỳ cũng như các gói API (gói theo mức sử dụng và gói theo nhóm). Cả hai đều có thời điểm cụ thể để tính phí và đặt lại gói theo nhóm về 0. Bảng sau đây mô tả thời điểm tính phí định kỳ và thời điểm đặt lại số lượng gói. Nếu các ứng dụng của nhà phát triển không thể thực hiện thêm lệnh gọi API vì đã đạt đến một giới hạn giao dịch nhất định, thì đây là những thời điểm số lượng lệnh gọi API được đặt lại về 0 và các ứng dụng có thể bắt đầu thực hiện lại lệnh gọi.
| Nếu gói thành viên có... | ...điều này xảy ra |
|---|---|
|
Phí định kỳ và gói ưu đãi sẽ được đặt lại vào ngày đầu tiên của tháng (mặc định). Đối với tần suất lặp lại hằng tháng vào một ngày cụ thể, hãy tạo một kế hoạch giá bằng cách sử dụng API quản lý và cho biết ngày bằng thuộc tính |
|
Phí định kỳ và gói theo nhóm sẽ được đặt lại sau mỗi 7 ngày kể từ ngày bắt đầu gói tỷ lệ của nhà phát triển. |
|
Phí định kỳ và gói ưu đãi sẽ được đặt lại sau mỗi X ngày kể từ ngày bắt đầu gói giá của nhà phát triển. |
|
Các gói kết hợp được đặt lại dựa trên Cơ sở tổng hợp được xác định trên thẻ giá. Ví dụ: nếu nhà phát triển bắt đầu một gói giá vào ngày 19 của tháng và Cơ sở tổng hợp là mỗi tháng một lần, thì mức sử dụng gói sẽ được đặt lại mỗi tháng vào ngày 19. Xin lưu ý rằng ngày trong tháng có thể không phải lúc nào cũng giống nhau. Ví dụ: nếu một kế hoạch giá bắt đầu vào ngày 31 tháng 12, thì ngày đặt lại sẽ là ngày 28 tháng 2 trong một năm không nhuận vì tháng 2 chỉ có 28 ngày. Sau đó, ngày 28 sẽ là ngày đặt lại hạn mức vĩnh viễn. |
Định cấu hình gói thẻ giá bằng giao diện người dùng
Định cấu hình các gói trong bảng giá như mô tả dưới đây.
Edge
Để thiết lập một kế hoạch thẻ giá, khi bạn tạo hoặc chỉnh sửa một kế hoạch giá, hãy chọn loại kế hoạch giá Thẻ giá hoặc Thẻ giá và chia sẻ doanh thu, rồi trong mục Thẻ giá, hãy chọn một trong các mô hình tính phí sau:
| Mô hình tính phí | Nội dung mô tả |
| Mức phí cố định | Nhà phát triển phải trả một mức phí cố định cho mỗi giao dịch. |
| Phân nhóm theo số lượng | Nhà phát triển sẽ bị tính một mức phí linh hoạt tuỳ thuộc vào số lượng giao dịch. |
| Bundle | Nhà phát triển sẽ trả trước một khoản tiền cố định cho mỗi gói giao dịch. Nhà phát triển sẽ bị tính phí theo số tiền đã đặt, bất kể gói có được sử dụng hoàn toàn hay không.
Lưu ý: Bạn không thể dùng lựa chọn này khi chọn Thẻ giá và Chia sẻ doanh thu. |
Sau đó, hãy định cấu hình thông tin sau đây dựa trên mô hình tính phí đã chọn.
| Mô hình tính phí | Trường | Nội dung mô tả |
| Tất cả | Tần suất tính toán | Khoảng thời gian mà số lượng giao dịch (hoặc số lượng liên quan đến thuộc tính tuỳ chỉnh) được tính. Chọn số tháng (từ 1 đến 24 tháng). |
| Mức phí cố định | Mức phí cố định | Mức phí được tính cho mỗi giao dịch. Nhập một số thập phân (có tối đa 4 chữ số thập phân).
Lưu ý: Bạn có thể định cấu hình số lượng chữ số thập phân có thể được chỉ định cho mức phí bằng API (không phải giao diện người dùng). Để biết thông tin chi tiết, hãy xem bài viết Định cấu hình số lượng chữ số thập phân cho mức giá của gói giá. Ví dụ: nếu bạn nhập 0,10 và đơn vị tiền tệ là đô la Mỹ, thì nhà phát triển sẽ bị tính phí 0,10 USD cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tùy chỉnh, chẳng hạn như số byte được truyền trong một giao dịch, thì nhà phát triển sẽ bị tính phí 0,10 USD cho việc truyền số byte được chỉ định). |
| Phân nhóm theo số lượng | Dải âm lượng | Một hoặc nhiều khoảng giao dịch (hoặc dựa trên thuộc tính của khách hàng) (mỗi khoảng là một "khoảng số lượng") cho mô hình tính phí theo khoảng số lượng. Bạn có thể chỉ định một mức giá cho mỗi dải khối lượng. Tỷ lệ này được áp dụng cho tất cả giao dịch trong khoảng khối lượng áp dụng. Chỉ định giới hạn trên của dải đầu tiên, ví dụ: tối đa 1.000 (giới hạn dưới được đặt sẵn là lớn hơn 0).
Nhấp vào +Mới để thêm các dải tần bổ sung. Để trống giới hạn trên của dải cuối cùng để cho biết tất cả giao dịch trên mức này. Lưu ý: Bạn có thể định cấu hình số lượng chữ số thập phân có thể được chỉ định cho mức phí bằng API (không phải giao diện người dùng). Để biết thông tin chi tiết, hãy xem bài viết Định cấu hình số lượng chữ số thập phân cho mức giá của gói giá. Ví dụ: nếu chỉ định 2 dải âm lượng trong phần Dải âm lượng (>0-1000 và 1000 trở lên), bạn có thể nhập 0,15 cho dải âm lượng >0-1000 và 0,10 cho dải âm lượng 1000 trở lên. Nếu đơn vị tiền tệ được chọn là đô la Mỹ, thì mức phí cho 1.000 giao dịch đầu tiên là 0, 15 USD cho mỗi giao dịch và mức phí cho hơn 1.000 giao dịch là 0, 1 USD cho mỗi giao dịch. |
| Bundle | Giá theo gói API | Số giao dịch trong một gói (hoặc một số liên quan đến thuộc tính tùy chỉnh, chẳng hạn như tổng số byte được truyền trong một gói). Bạn có thể chỉ định giá cho từng gói. Giá áp dụng cho toàn bộ gói. Chỉ định giới hạn trên của gói đầu tiên, ví dụ: tối đa 1.000 (giới hạn dưới được đặt sẵn là lớn hơn 0).
Nhấp vào +Mới để thêm các gói bổ sung. Bạn phải chỉ định giới hạn trên cho gói cuối cùng, trừ phi bạn muốn tính phí nhà phát triển một khoản tiền cố định cho số lượng giao dịch không giới hạn trong gói cuối cùng. Lưu ý: Bạn có thể định cấu hình số lượng chữ số thập phân có thể được chỉ định cho mức phí bằng API (không phải giao diện người dùng). Để biết thông tin chi tiết, hãy xem bài viết Định cấu hình số lượng chữ số thập phân cho mức giá của gói giá. Ví dụ: nếu chỉ định 2 gói trong phần Kích thước gói (lớn hơn 0 đến 1000 và lớn hơn 1000 đến 2000), bạn có thể nhập 50 cho gói lớn hơn 0 đến 1000 và 40 cho gói lớn hơn 1000 đến 2000. Nếu đơn vị tiền tệ bạn chọn là đô la Mỹ, thì giá của gói đầu tiên là 50 đô la và giá của gói thứ hai là 40 đô la. Nhà phát triển sẽ bị tính giá gói áp dụng, bất kể họ sử dụng bao nhiêu giao dịch trong gói (tức là nhà phát triển sẽ bị tính giá gói ngay khi giao dịch đầu tiên trong gói được hoàn tất). |
Nếu đã xác định các thuộc tính tùy chỉnh cho sản phẩm API, bạn có thể định cấu hình một tham số định giá tùy chỉnh để tính phí nhà phát triển ứng dụng dựa trên một thuộc tính tùy chỉnh trong mỗi giao dịch. Ví dụ: nếu thiết lập một kế hoạch mà bạn tính phí nhà phát triển cho mỗi giao dịch, thì bạn có thể đặt mức phí cho kế hoạch dựa trên một thuộc tính tùy chỉnh, chẳng hạn như số byte được truyền trên phần phụ trợ có thể thay đổi theo từng giao dịch.
Trong trường hợp này, hãy chọn Sử dụng thông số phân loại tuỳ chỉnh rồi chọn thuộc tính tuỳ chỉnh trong danh sách thả xuống. Để biết thêm thông tin, hãy xem bài viết Định cấu hình gói giá bằng các thuộc tính tuỳ chỉnh.
Classic Edge (Private Cloud)
Cách định cấu hình các gói bảng giá bằng giao diện người dùng Classic Edge:
- Làm theo các bước để tạo gói giá.
- Chọn Thẻ giá trong trình đơn thả xuống Loại kế hoạch giá để thiết lập mô hình doanh thu.
- Nếu gói API đã chọn có nhiều sản phẩm API, hãy chọn một trong các lựa chọn sau:
Lưu ý: Nếu gói API chỉ có một sản phẩm API, bạn có thể bỏ qua bước này.
- Kế hoạch dành riêng cho từng sản phẩm để định cấu hình thông tin chi tiết về kế hoạch giá cho từng sản phẩm API riêng lẻ.
- Kế hoạch chung cho tất cả sản phẩm để định cấu hình thông tin chi tiết về kế hoạch giá cho tất cả sản phẩm API.
- Nhấp vào Thẻ giá cho gói giá chung hoặc cho từng gói giá dành riêng cho sản phẩm API.
Lưu ý: Khi định cấu hình các gói dành riêng cho sản phẩm API, bạn sẽ cần định cấu hình một gói thẻ giá cho từng sản phẩm API riêng lẻ.
Cửa sổ Bảng giá sẽ mở ra.
- Thiết lập gói freemium cho một sản phẩm API. Gói freemium cho phép nhà phát triển sử dụng miễn phí một sản phẩm API trong một khoảng thời gian hoặc dựa trên mức sử dụng.
Nhập thông tin dưới đây:
Trường Mô tả Sản phẩm kết hợp miễn phí và tính phí? Thời gian miễn phí. Chọn một trong các nút sau:
- Theo số lượng. Khoảng thời gian miễn phí dựa trên số lượng được chỉ định trong trường Số lượng.
- Theo thời lượng. Khoảng thời gian tính phí dựa trên khoảng thời gian được chỉ định trong trường Thời lượng Freemium.
- Tuỳ theo điều kiện nào đến trước. Thời gian miễn phí kết thúc khi đạt đến số lượng trong trường Số lượng hoặc khoảng thời gian trong trường Thời lượng miễn phí, tuỳ vào trường hợp nào xảy ra trước.
- Không. Đây không phải là gói freemium. Đây là tuỳ chọn mặc định.
Số lượng người dùng sử dụng mô hình kết hợp miễn phí và tính phí Số lượng giao dịch (hoặc số lượng liên quan đến một thuộc tính tuỳ chỉnh được ghi lại trong chính sách ghi lại giao dịch) mà nhà phát triển không bị tính phí. Khối lượng được đo lường cho sản phẩm API. Nhập số lượng, chẳng hạn như 5000. Điều này có nghĩa là khi bắt đầu sử dụng gói này, nhà phát triển sẽ không bị tính phí cho 5.000 giao dịch đầu tiên (hoặc cho 5.000 lần sử dụng đầu tiên của một mục liên quan đến thuộc tính tuỳ chỉnh). Trường này chỉ được bật nếu bạn chọn "Theo số lượng" hoặc "Tuỳ theo điều kiện nào đến trước" trong trường "Sản phẩm freemium?".
Thời lượng sử dụng miễn phí Khoảng thời gian mà nhà phát triển không bị tính phí. Nhập một số và chọn một khoảng thời gian, ví dụ: 1 tháng. Điều này có nghĩa là nhà phát triển sẽ không bị tính phí trong 1 tháng. Trường này chỉ được bật nếu bạn chọn "Theo thời lượng" hoặc "Tuỳ theo điều kiện nào đến trước" trong trường "Sản phẩm freemium?".
- Chọn một trong các mô hình tính phí sau:
- Mức phí cố định. Trong mô hình này, nhà phát triển phải trả một mức phí cố định cho mỗi giao dịch.
- Phân theo khối lượng. Trong mô hình này, nhà phát triển sẽ bị tính một mức phí linh hoạt tuỳ thuộc vào số lượng giao dịch.
- Gói. Trong mô hình này, nhà phát triển sẽ trả một khoản tiền cố định (trả trước) cho mỗi gói giao dịch. Nhà phát triển sẽ bị tính phí theo số tiền đã đặt, bất kể gói có được sử dụng hoàn toàn hay không.
Đối với mô hình giá cố định: Nhập thông tin sau trong phần Định giá của cửa sổ Bảng giá chung:
Trường Mô tả Đơn vị vận hành (hoặc Tổ chức) Tên của tổ chức. Trường này được đặt sẵn bằng giá trị trường Nhà điều hành (hoặc Tổ chức) trong hồ sơ tổ chức.
Quốc gia Quốc gia nơi tổ chức của bạn hoạt động. Trường này được đặt sẵn bằng giá trị của trường Quốc gia trong hồ sơ tổ chức.
Mức phí cố định Mức phí được tính cho mỗi giao dịch. Nhập một số thập phân (có tối đa 4 chữ số thập phân).
Lưu ý: Bạn có thể định cấu hình số lượng chữ số thập phân có thể được chỉ định cho mức phí được tính bằng API (không phải giao diện người dùng). Để biết thông tin chi tiết, hãy xem bài viết Định cấu hình số lượng chữ số thập phân cho mức giá của gói giá.
Ví dụ: nếu bạn nhập 0,10 và đơn vị tiền tệ là đô la Mỹ, thì nhà phát triển sẽ bị tính phí 0,10 USD cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tùy chỉnh, chẳng hạn như số byte được truyền trong một giao dịch, thì nhà phát triển sẽ bị tính phí 0,10 USD cho việc truyền số byte được chỉ định).
Đối với mô hình theo dải số lượng: Cửa sổ Bảng giá chung sẽ hiển thị các trường bổ sung mà bạn dùng để chỉ định cơ sở tổng hợp và chỉ định "dải số lượng", tức là các dải số lượng giao dịch mà bạn có thể áp dụng các mức giá khác nhau.
Loại kế hoạch này thường được thiết lập để khuyến khích nhà phát triển tạo ra số lượng lớn hơn bằng cách cung cấp mức chiết khấu cho các mức số lượng lớn hơn.
Nhập thông tin sau vào cửa sổ Bảng giá chung:
Trường Mô tả Cơ sở tổng hợp Khoảng thời gian mà số lượng giao dịch (hoặc số lượng liên quan đến thuộc tính tuỳ chỉnh) được tổng hợp. Tổng khối lượng được dùng để xác định khoảng khối lượng và mức giá áp dụng cho từng giao dịch. Chọn số tháng (từ 1 đến 12 tháng).
Để biết thông tin chi tiết về thời điểm gói được đặt lại, hãy xem bài viết Khi nào phí định kỳ được tính và gói được đặt lại?
Dải âm lượng Một hoặc nhiều khoảng số lượng giao dịch (hoặc dựa trên thuộc tính khách hàng) (mỗi khoảng là một "khoảng số lượng"). Bạn có thể chỉ định một mức giá cho mỗi dải chiết khấu (bạn đặt mức giá này trong trường Dải chiết khấu của mục Định giá). Tỷ lệ này được áp dụng cho tất cả giao dịch trong dải khối lượng áp dụng. Chỉ định giới hạn trên của dải đầu tiên, ví dụ: tối đa 1000 (giới hạn dưới được đặt sẵn là lớn hơn 0). Nhấp vào + để thêm một dải thứ hai, ví dụ: lớn hơn 1.000 đến 2.000. Nhấp vào biểu tượng + để thêm các dải tần khác. Bạn có thể để trống giới hạn trên của dải cuối cùng để cho biết tất cả các giao dịch trên cấp này.
Định giá Đơn vị vận hành (hoặc Tổ chức) Tên của tổ chức. Trường này được đặt sẵn bằng giá trị trường Nhà điều hành (hoặc Tổ chức) trong Hồ sơ tổ chức.
Quốc gia Quốc gia nơi tổ chức của bạn hoạt động. Trường này được đặt sẵn bằng giá trị của trường Quốc gia trong Hồ sơ tổ chức.
Đơn vị tiền tệ Đơn vị tiền tệ "cơ sở" hoặc đơn vị tiền tệ kế toán mà tổ chức của bạn sử dụng. Trường này được đặt sẵn bằng giá trị của trường Đơn vị tiền tệ trong Hồ sơ tổ chức, nhưng bạn có thể thay đổi giá trị này tại đây.
Dải âm lượng Mức giá cho một khoảng số lượng. Bạn chỉ định một mức giá cho từng khoảng số lượng. Nhập một số thập phân cho mỗi dải (có tối đa 4 chữ số thập phân).
Lưu ý: Bạn có thể định cấu hình số lượng chữ số thập phân có thể được chỉ định cho tỷ lệ chiết khấu theo dải số lượng bằng API (không phải giao diện người dùng). Để biết thông tin chi tiết, hãy xem bài viết Định cấu hình số lượng chữ số thập phân cho mức giá của gói giá.
Ví dụ: nếu chỉ định 2 dải âm lượng trong phần Dải âm lượng (>0-1000 và 1000 trở lên), bạn có thể nhập 0,15 cho dải âm lượng >0-1000 và 0,10 cho dải âm lượng 1000 trở lên. Nếu đơn vị tiền tệ được chọn là đô la Mỹ, thì mức phí cho 1.000 giao dịch đầu tiên là 0,15 USD cho mỗi giao dịch, còn đối với hơn 1.000 giao dịch, mức phí là 0,10 USD cho mỗi giao dịch.
Đối với mô hình theo gói: Cửa sổ Thẻ giá chung sẽ hiển thị các trường bổ sung mà bạn dùng để chỉ định cơ sở tổng hợp (khoảng thời gian mà nhà phát triển có thể sử dụng gói giao dịch) và để chỉ định thông tin liên quan đến gói, chẳng hạn như quy mô của gói.
Nhập thông tin sau vào cửa sổ Bảng giá chung:
Trường Mô tả Cơ sở tổng hợp Khoảng thời gian mà nhà phát triển có thể sử dụng gói giao dịch (hoặc sử dụng gói tuỳ chỉnh dựa trên thuộc tính). Chọn số tháng (từ 1 đến 12 tháng). Sau khoảng thời gian này, gói sẽ hết hạn và nhà phát triển phải mua lại gói (và gói kết hợp).
Để biết thông tin chi tiết về thời điểm gói được đặt lại, hãy xem bài viết Khi nào phí định kỳ được tính và gói được đặt lại?
Kích thước gói Số lượng giao dịch trong một gói (hoặc một số liên quan đến thuộc tính tùy chỉnh, chẳng hạn như tổng số byte được truyền trong một gói). Bạn có thể chỉ định giá cho từng gói (bạn đặt giá này trong trường Kích thước gói của mục Định giá). Giá áp dụng cho toàn bộ gói. Chỉ định giới hạn trên của gói đầu tiên, ví dụ: tối đa 1.000 (giới hạn dưới được đặt sẵn là lớn hơn 0). Nhấp vào dấu + để thêm gói thứ hai, ví dụ: lớn hơn 1.000 đến 2.000. Nhấp vào dấu + để thêm các gói khác. Bạn phải chỉ định giới hạn trên cho gói cuối cùng, trừ phi bạn muốn tính cho nhà phát triển một khoản tiền cố định cho số lượng giao dịch không giới hạn trong gói cuối cùng.
Định giá Đơn vị vận hành (hoặc Tổ chức) Tên của tổ chức. Trường này được đặt sẵn bằng giá trị trường Nhà điều hành (hoặc Tổ chức) trong Hồ sơ tổ chức.
Quốc gia Quốc gia nơi tổ chức của bạn hoạt động. Trường này được đặt sẵn bằng giá trị của trường Quốc gia trong Hồ sơ tổ chức.
Đơn vị tiền tệ Đơn vị tiền tệ "cơ sở" hoặc đơn vị tiền tệ kế toán mà tổ chức của bạn sử dụng. Trường này được đặt sẵn bằng giá trị của trường Đơn vị tiền tệ trong Hồ sơ tổ chức, nhưng bạn có thể thay đổi giá trị này tại đây.
Kích thước gói (giá) Giá của một gói. Bạn chỉ định giá cho từng gói. Nhập một số thập phân (có tối đa 4 chữ số thập phân).
Lưu ý: Bạn có thể định cấu hình số lượng chữ số thập phân có thể được chỉ định cho tỷ lệ chiết khấu theo gói bằng API (không phải giao diện người dùng). Để biết thông tin chi tiết, hãy xem bài viết Định cấu hình số lượng chữ số thập phân cho mức giá của gói giá.
Ví dụ: nếu chỉ định 2 gói trong phần Kích thước gói (lớn hơn 0 đến 1000 và lớn hơn 1000 đến 2000), bạn có thể nhập 50 cho gói lớn hơn 0 đến 1000 và 40 cho gói lớn hơn 1000 đến 2000. Nếu đơn vị tiền tệ bạn chọn là đô la Mỹ, thì giá của gói đầu tiên là 50 đô la và giá của gói thứ hai là 40 đô la. Nhà phát triển sẽ bị tính giá gói áp dụng, bất kể họ sử dụng bao nhiêu giao dịch trong gói (tức là nhà phát triển sẽ bị tính giá gói ngay khi giao dịch đầu tiên trong gói được hoàn tất).
- Nhấp vào Áp dụng và đóng để lưu thông tin chi tiết về thẻ giá và quay lại cửa sổ Gói giá tiêu chuẩn.
- Đối với các gói giá dành riêng cho sản phẩm API, hãy định cấu hình thông tin chi tiết về gói giá cho các sản phẩm API khác (nếu cần).
Định cấu hình gói bảng giá bằng API
Định cấu hình thông tin chi tiết về gói thẻ giá bằng API, như mô tả trong các phần sau.
Chỉ định thông tin chi tiết về gói trong thẻ giá bằng API
Bạn chỉ định thông tin chi tiết về gói thẻ giá khi tạo gói giá. Bạn chỉ định thông tin chi tiết trong thuộc tính ratePlanDetails trong nội dung yêu cầu trong lệnh gọi đến /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. Những gì bạn chỉ định trong thuộc tính ratePlanDetails phụ thuộc vào mô hình tính phí mà bạn chọn: mức phí cố định, theo khối lượng hoặc theo gói.
Chỉ định mô hình sạc theo mức phí cố định
Để triển khai mô hình tính phí cố định, bạn chỉ định những thông tin sau trong phần thông tin chi tiết về gói giá:
- Một tham số xếp hạng cho biết rằng gói cước dựa trên giao dịch (
VOLUME) hoặc dựa trên một thuộc tính tùy chỉnh (ví dụ:MINT_CUSTOM_ATTRIBUTE_1).VOLUMElà giá trị mặc định. - Một loại đo lường (
UNIT) cho biết mức giá cố định theo đơn vị (tức là không dựa trên số lượng giao dịch, như trường hợp của mô hình tính phí theo gói hoặc theo số lượng). - Khoảng thời gian đến hạn thanh toán (ví dụ: 30 ngày).
- Mã nhận dạng của tổ chức.
- "Cơ sở" hoặc đơn vị tiền tệ kế toán mà công ty của bạn sử dụng.
- Giá của gói giá cung cấp thông tin chi tiết về cách tính giá. Vì mô hình tính phí dựa trên mức phí cố định, nên bạn chỉ cần chỉ định một mức phí của gói giá.
Trong giá của gói giá, bạn chỉ định:
- Loại giá của gói giá (
RATECARD). - Mức giá của gói. Ví dụ: nếu bạn chỉ định 0,10 và đơn vị tiền tệ là đô la Mỹ, thì nhà phát triển sẽ bị tính phí 0,10 USD cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tùy chỉnh, chẳng hạn như số byte được truyền trong một giao dịch, thì nhà phát triển sẽ bị tính phí 0,10 USD cho việc truyền số byte được chỉ định).
- Đơn vị bắt đầu của ứng dụng tỷ lệ (
0). Điều này có nghĩa là tỷ lệ được áp dụng cho từng giao dịch, bắt đầu từ giao dịch đầu tiên.
Hãy xem Chế độ cài đặt cấu hình chi tiết về kế hoạch giá để biết danh sách đầy đủ các lựa chọn chi tiết về kế hoạch giá.
Ví dụ: đoạn mã sau đây tạo một gói bảng giá có mô hình tính phí cố định. Mức phí được đặt ở mức 0,10 USD cho mỗi giao dịch. Thời hạn thanh toán là 30 ngày. (Thông tin chi tiết liên quan đến bảng giá được đánh dấu.)
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flat rate card plan",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan",
"displayName" : "Flat rate card plan",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
Chỉ định mô hình tính phí theo mức chiết khấu
Trong mô hình theo dải số lượng, bạn chỉ định thông tin chi tiết về kế hoạch giá, bao gồm một hoặc nhiều mức giá trong kế hoạch giá. Mỗi mức giá áp dụng cho một "dải số lượng", tức là một phạm vi số lượng giao dịch (hoặc một phạm vi dựa trên một thuộc tính tuỳ chỉnh, chẳng hạn như số lượng byte được truyền). Loại kế hoạch này thường được thiết lập để khuyến khích nhà phát triển tạo ra số lượng lớn hơn bằng cách cung cấp mức chiết khấu cho các mức số lượng lớn hơn.
Ngoài giá của gói giá, bạn cũng chỉ định những thông tin sau trong phần thông tin chi tiết về gói giá:
- Một tham số xếp hạng cho biết rằng gói cước dựa trên giao dịch (
VOLUME) hoặc dựa trên một thuộc tính tùy chỉnh (ví dụ:CUSTOM_ATTRIBUTE_1).VOLUMElà giá trị mặc định. - Một loại đo lường (
VOLUME) cho biết rằng mức phí dựa trên số lượng giao dịch (tức là không phải mức phí cố định cho mỗi giao dịch, như trường hợp của mô hình tính phí cố định). - Khoảng thời gian đến hạn thanh toán (ví dụ: 30 ngày).
- Mã nhận dạng của tổ chức.
- "Cơ sở" hoặc đơn vị tiền tệ kế toán mà công ty của bạn sử dụng.
- Thời lượng và loại thời lượng cùng nhau chỉ định khoảng thời gian mà số lượng giao dịch (hoặc số lượng liên quan đến thuộc tính tuỳ chỉnh) được tổng hợp. Đây cũng được gọi là "cơ sở tổng hợp". Số lượng giao dịch được tổng hợp theo cơ sở tổng hợp (ví dụ: 1 tháng) để xác định khoảng số lượng áp dụng.
- Bộ đếm tổng hợp được dùng để xác định dải âm lượng áp dụng.
Đối với mỗi mức giá trong gói giá, bạn chỉ định:
- Loại giá của gói giá (
RATECARD). - Mức giá của gói. Ví dụ: nếu bạn chỉ định 0,10 và đơn vị tiền tệ là đô la Mỹ, thì nhà phát triển sẽ bị tính phí 0,15 đô la cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tùy chỉnh, chẳng hạn như số byte được truyền trong một giao dịch, thì nhà phát triển sẽ bị tính phí 0,15 đô la cho việc truyền số byte được chỉ định).
- Đơn vị bắt đầu và kết thúc của dải âm lượng. Đơn vị bắt đầu chỉ định giới hạn dưới của dải âm lượng, còn đơn vị kết thúc chỉ định giới hạn trên của dải âm lượng. Ví dụ: nếu bạn chỉ định đơn vị bắt đầu là 0 và đơn vị kết thúc là 1000, thì dải khối lượng sẽ bao gồm tối đa 1000 giao dịch trong khoảng thời gian tổng hợp. Nếu đơn vị tiền tệ là đô la Mỹ, khoảng thời gian tổng hợp là 1 tháng và tỷ lệ cho 1.000 giao dịch đầu tiên là 0,15, thì nhà phát triển sẽ bị tính phí 0,15 USD cho mỗi giao dịch (tối đa 1.000 giao dịch) trong tháng.
Để biết thông tin chi tiết về thời điểm gói được đặt lại, hãy xem bài viết Khi nào phí định kỳ được tính và gói được đặt lại?
Nếu bạn không chỉ định đơn vị kết thúc cho dải khối lượng cuối cùng, thì mức giá cho dải đó sẽ được áp dụng cho tất cả giao dịch sau khi số lượng giao dịch vượt quá đơn vị bắt đầu cho dải đó. Ví dụ: nếu đơn vị bắt đầu cho dải cuối cùng là 1000 và bạn không chỉ định đơn vị kết thúc cho dải đó, thì tỷ lệ cho dải đó sẽ được áp dụng cho tất cả các giao dịch sau 1000 giao dịch trong khoảng thời gian tổng hợp.
Hãy xem Chế độ cài đặt cấu hình chi tiết về kế hoạch giá để biết danh sách đầy đủ các lựa chọn chi tiết về kế hoạch giá.
Ví dụ: mã sau đây tạo một gói bảng giá có mô hình tính phí theo mức sử dụng. Mức phí được đặt ở mức 0,15 USD cho 1.000 giao dịch đầu tiên và 0,1 USD cho tất cả các giao dịch trên 1.000. Cơ sở tổng hợp là 1 tháng. Thời hạn thanh toán là 30 ngày. (Thông tin chi tiết về bảng giá được làm nổi bật.)
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Volume banded rate card plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Volume banded rate card plan",
"displayName" : "Volume banded rate card plan",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "VOLUME",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.15",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "1000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
Chỉ định mô hình sạc theo gói
Trong mô hình tính phí theo gói, nhà phát triển trả tiền (trả trước) cho một "gói" giao dịch (hoặc cho một gói dựa trên một thuộc tính tùy chỉnh, chẳng hạn như số lượng byte được truyền). Bạn chỉ định một mức giá cho mỗi gói và cơ sở tổng hợp, tức là khoảng thời gian mà nhà phát triển có thể sử dụng gói.
Ví dụ: giả sử bạn thiết lập 2 gói, trong đó gói đầu tiên có quy mô từ 1 đến 1.000 giao dịch và gói thứ hai có quy mô từ 1.001 đến 2.000 giao dịch. Mức giá là 50 đô la cho gói đầu tiên và 40 đô la cho gói thứ hai, đồng thời cơ sở tổng hợp là 1. Nếu nhà phát triển mua gói thẻ giá cho gói đầu tiên, họ sẽ trả 50 USD (trả trước) cho 1.000 giao dịch trong một tháng. Nhà phát triển sẽ bị tính phí theo số tiền đã đặt, bất kể gói có được sử dụng hết hay không. Sau khi thời gian tổng hợp kết thúc, gói sẽ hết hạn. Nếu muốn sử dụng lại gói, nhà phát triển phải mua lại gói (và gói ưu đãi).
Những gì bạn chỉ định trong thông tin chi tiết về gói giá về cơ bản giống với những gì bạn chỉ định trong thông tin chi tiết về gói giá cho mô hình tính phí theo bậc. Những điểm khác biệt này bao gồm:
- Mỗi gói giá mà bạn chỉ định là dành cho một gói (chứ không phải cho một dải số lượng).
- Bạn phải chỉ định giới hạn trên cho gói cuối cùng, trừ phi bạn muốn tính cho nhà phát triển một khoản tiền cố định cho số lượng giao dịch không giới hạn trong gói cuối cùng.
Hãy xem Chế độ cài đặt cấu hình chi tiết về kế hoạch giá để biết danh sách đầy đủ các lựa chọn chi tiết về kế hoạch giá.
Ví dụ: đoạn mã sau đây tạo một kế hoạch bảng giá với mô hình tính phí theo gói. Mức phí được đặt ở 50 USD cho gói đầu tiên (tối đa 1.000 giao dịch) và 40 USD cho gói thứ hai (hơn 1.000 giao dịch và tối đa 2.000 giao dịch). Cơ sở tổng hợp là 1 tháng. Bạn phải thanh toán trong vòng 30 ngày.
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Bundled rate plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Bundled rate plan",
"displayName" : "Bundled rate plan",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "true",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "STAIR_STEP",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "50",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "40",
"startUnit": "1000",
"endUnit": "2000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
Chỉ định gói freemium cho từng sản phẩm bằng API
Trong gói theo bảng giá, bạn có thể thiết lập một gói freemium cho từng sản phẩm (thay vì cho một gói API). Gói freemium cho phép nhà phát triển sử dụng miễn phí một sản phẩm API trong một khoảng thời gian hoặc dựa trên mức sử dụng.
Khi thiết lập gói freemium cho một sản phẩm API, bạn sẽ chỉ định trong phần thông tin chi tiết về gói của bảng giá khoảng thời gian mà nhà phát triển có thể sử dụng miễn phí các tài nguyên do sản phẩm API cung cấp. Khoảng thời gian có thể dựa trên một trong những yếu tố sau:
- Thời hạn, tức là khoảng thời gian giữa ngày có hiệu lực và ngày kết thúc.
- Số lượng, chẳng hạn như số giao dịch liên quan đến sản phẩm API hoặc số lượng liên quan đến một thuộc tính tuỳ chỉnh được ghi lại trong chính sách ghi lại giao dịch.
Nếu thời gian dùng thử miễn phí dựa trên số lượng, hãy chỉ định thời gian đó dưới dạng số lượng đơn vị dùng thử miễn phí. Ví dụ: mã sau đây tạo một gói theo bảng giá có gói freemium dựa trên số lượng 5.000 đơn vị (các thông số kỹ thuật liên quan đến gói freemium được làm nổi bật).
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flat rate card plan with freemium period",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan with freemium period",
"displayName" : "Flat rate card plan with freemium period",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "myorg"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "false",
"ratePlanDetails": [
{
"currency": {
"aggregateFreemiumCounters" : true,
"aggregateStandardCounters" : true,
"id" : "usd"
},
"product" : {
"id" : "location",
"displayName":"Location"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "myorg"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"freemiumUnit": "5000",
"freemiumDuration": "0",
"freemiumDurationType": "DAY",
"ratingParameterUnit":"MB",
"customPaymentTerm": "false",
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password