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
Trong gói giá, nhà phát triển sẽ bị tính phí cho mỗi giao dịch. Đối với loại gói 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 kiểu sạc.
Nếu muốn, bạn có thể chỉ định gói thu phí trong miễn phí cho từng sản phẩm (thay vì cho API gói) — bạn chỉ có thể làm việc này cho gói dành riêng cho sản phẩm.
Khi nào thì bạn sẽ đặt lại các gói phí định kỳ và gói theo gói?
Gói giá có thể bao gồm các khoản phí định kỳ cũng như gói API (gói theo phạm vi khối lượng và gói theo gói), cả hai đều liên quan đến thời điểm cụ thể khi tính phí và các gói dịch vụ được đặt lại về 0. Chiến lược phát hành đĩa đơn bảng sau đây mô tả trường hợp bạn phải trả phí định kỳ và đặt lại số lượng gói. Nếu ứng dụng của nhà phát triển bị chặn không cho thực hiện thêm lệnh gọi API vì đã đạt đến ngưỡng nhất định hạn mức giao dịch, đây là những lần số lượng lệnh gọi API được đặt lại về 0 và ứng dụng có thể bắt đầu gọi lại trở lại.
Nếu gói này có... | ...điều này sẽ xảy ra |
---|---|
|
Việc đặt lại phí định kỳ và gói theo gói diễn ra 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 gói giá bằng cách sử dụng phần quản lý
API và cho biết ngày bằng thuộc tính |
|
Việc đặt lại phí định kỳ và gói theo gói sẽ diễn ra 7 ngày một lần sau mức giá của nhà phát triển ngày bắt đầu gói. |
|
Việc đặt lại phí định kỳ và gói theo gói sẽ diễn ra X ngày một lần sau ngày bắt đầu gói giá của nhà phát triển. |
|
Các gói giá được đặt lại dựa trên Cơ sở tổng hợp đã xác định trên bảng giá. Cho ví dụ: nếu nhà phát triển bắt đầu gói giá vào ngày 19 của tháng và gói Theo cơ sở là 1 tháng một lần, sau đó việc sử dụng gói được đặt lại mỗi tháng vào ngày 19. Xin lưu ý rằng ngày trong tháng không phải lúc nào cũng giống nhau. Ví dụ: nếu tỷ lệ kế hoạch bắt đầu vào ngày 31 tháng 12, ngày đặt lại trở thành ngày 28 trong năm không nhuận Tháng 2 vì tháng 2 chỉ có 28 ngày. Ngày 28 vẫn là ngày đặt lại mãi mãi. |
Định cấu hình gói bảng giá bằng Giao diện người dùng
Định cấu hình gói bảng giá như mô tả dưới đây.
Edge
Để thiết lập một gói giá, khi tạo hoặc chỉnh sửa một gói giá, hãy chọn loại gói giá là Thẻ giá hoặc Thẻ giá và phần doanh thu rồi trong mục Bảng giá, hãy chọn một trong các mô hình tính phí sau đây:
Kiểu sạc | Nội dung mô tả |
Mức phí cố định | Nhà phát triển bị tính phí cố định cho mỗi giao dịch. |
Dây âm lượng | Nhà phát triển được tính phí theo tỷ lệ thay đổi tuỳ thuộc vào số lượng giao dịch. |
Bundle | Nhà phát triển cần trả trước một số tiền đã định cho mỗi gói giao dịch. Nhà phát triển sẽ phải trả một khoản phí đã định cho dù có sử dụng toàn bộ gói hay không.
Lưu ý: Lựa chọn này không có sẵn khi bạn chọn Thẻ giá và Phần doanh thu chia sẻ. |
Sau đó, hãy thiết lập các thông tin sau dựa trên mô hình sạc đã chọn.
Kiểu sạc | Trường | Nội dung mô tả |
Tất cả | Tần suất tính toán | Khoảng thời gian tính toán khối lượng giao dịch (hoặc khối lượng liên quan đến thuộc tính tuỳ chỉnh). Chọn số tháng (1-24 tháng). |
Mức phí cố định | Mức phí cố định | Giá được tính cho từng 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ố chữ số thập phân có thể được chỉ định cho mức phí tính 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ố chữ số thập phân cho mức giá gói giá. Ví dụ: nếu bạn nhập 0,10 và đơn vị tiền tệ là đô la Mỹ, nhà phát triển sẽ bị tính phí $0,1 cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tùy chỉnh như số byte được truyền trong giao dịch, nhà phát triển bị tính phí $0,1 cho việc truyền số byte được chỉ định). |
Dây âm lượng | Băng tần | Một hoặc nhiều phạm vi khối lượng giao dịch (hoặc dựa trên thuộc tính của khách hàng) (mỗi phạm vi là một "dải lưu lượng") cho mô hình tính phí theo dải âm lượng. Bạn có thể chỉ định một mức giá cho mỗi dải âm lượng. Mức phí này được áp dụng cho tất cả các giao dịch trong khoảng số lượng có thể áp dụng. Chỉ định giới hạn trên của dải đầu tiên, ví dụ: lên tới 1000 (giới hạn dưới được đặt trước ở mức lớn hơn 0).
Nhấp vào +Mới để thêm dây đeo khác. Để trống giới hạn trên của dải cuối cùng để biểu thị tất cả các giao dịch trên mức này. Lưu ý: Bạn có thể định cấu hình số chữ số thập phân có thể được chỉ định cho mức phí tính 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ố chữ số thập phân cho mức giá gói giá. Ví dụ: nếu bạn chỉ định hai 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 từ 1000 trở lên. Nếu đơn vị tiền tệ được chọn là đô la Mỹ, tỷ giá cho 1000 giao dịch đầu tiên là 0,15 đô la cho mỗi giao dịch và đối với hơn 1.000 giao dịch, tỷ giá là 0,1 đô la cho mỗi giao dịch. |
Bundle | Giá gói API | Số giao dịch trong một gói (hoặc một số liên quan đến một thuộc tính tuỳ chỉnh, chẳng hạn như tổng số byte được truyền trong một gói). Mỗi gói có thể được chỉ định một mức 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ụ: lên tới 1000 (giới hạn dưới được đặt trước ở mức lớn hơn 0).
Nhấp vào +Mới để 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 phí nhà phát triển một số tiền cố định đối với các 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ố chữ số thập phân có thể được chỉ định cho mức phí tính 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ố chữ số thập phân cho mức giá gói giá. Ví dụ: nếu bạn chỉ định hai 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ệ được chọn là đô la Mỹ, giá cho gói đầu tiên là 50 đô la và gói thứ hai là 40 đô la. Nhà phát triển sẽ trả phí theo giá gói hiện hành bất kể họ sử dụng bao nhiêu giao dịch trong gói (nghĩa là nhà phát triển sẽ bị tính phí theo giá của gói ngay khi giao dịch đầu tiên trong gói hoàn tất). |
Nếu đã xác định thuộc tính tùy chỉnh cho sản phẩm API của mình, bạn có thể định cấu hình một thông số xếp hạng tùy chỉnh để tính phí nhà phát triển ứng dụng dựa trên thuộc tính tùy chỉnh trong mỗi giao dịch. Ví dụ: nếu bạn lập một gói mà trong đó bạn tính phí nhà phát triển cho mỗi giao dịch, bạn có thể đặt mức phí cho gói đó dựa trên thuộc tính tuỳ 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ố xếp hạng 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 thuộc tính tuỳ chỉnh.
Classic Edge (Đám mây riêng tư)
Cách định cấu hình 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 Bảng giá trong trình đơn thả xuống Loại gói giá để thiết lập mô hình doanh thu.
- Nếu gói API đã chọn bao gồm 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 bao gồm một sản phẩm API duy nhất, thì bạn có thể bỏ qua bước này.
- Gói dành riêng cho sản phẩm để thiết lập thông tin chi tiết về gói giá cho từng sản phẩm API.
- Gói chung cho tất cả sản phẩm để thiết lập thông tin chi tiết về gói giá cho tất cả các sản phẩm API.
- Nhấp vào Bảng giá để xem gói giá chung hoặc cho từng gói giá theo sản phẩm API.
Lưu ý: Khi định cấu hình gói dành riêng cho sản phẩm API, bạn cần phải thiết lập gói bảng giá cho từng sản phẩm API riêng lẻ.
Cửa sổ Thẻ giá sẽ mở ra.
- Thiết lập gói thu phí trong miễn phí cho sản phẩm API. Gói thu phí trong miễn phí cho phép nhà phát triển sử dụng miễn phí
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 thu phí trong miễn phí? Khoảng thời gian miễn phí. Chọn một trong các nút chọn sau:
- Theo số lượng. Khoảng thời gian miễn phí dựa trên số lượng đã chỉ định trong Tập .
- Theo Thời lượng. Kỳ tính phí dựa trên khoảng thời gian được chỉ định trong trường Thời lượng thu phí trong miễn phí.
- Tính năng nào xuất hiện trước. Thời gian miễn phí kết thúc khi số lượng trong Đã đạt đến trường Âm lượng hoặc khoảng thời gian trong trường Thời lượng thu phí trong miễn phí, tuỳ theo điều kiện nào xảy ra trước.
- Không. Đây không phải là gói thu phí trong miễn phí. Đây là tuỳ chọn mặc định.
Thể tích thu phí trong miễn phí Số lượng giao dịch (hoặc số lượng giao dịch 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 sẽ không bị tính phí. Âm lượng là được đo lường cho sản phẩm API. Nhập số tập, chẳng hạn như 5000. Điều này có nghĩa là khi bắt đầu dùng gói, 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 có liên quan đến thuộc tính tuỳ chỉnh). Trường này là chỉ được bật nếu bạn chọn "Theo số lượng" hoặc "Tuỳ chọn nào đến trước" trong gói "Freemium" sản phẩm?" .
Thời hạn thu phí trong 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 khoảng thời gian, ví dụ: 1 Tháng. Điều này có nghĩa là nhà phát triển 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 "Lựa chọn nào đến trước" trong "Sản phẩm thu phí trong miễn phí?" .
- Chọn một trong các kiểu sạc 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.
- Băng tần. Trong mô hình này, nhà phát triển được tính một khoản phí thay đổi tuỳ thuộc vào khối lượng giao dịch.
- Bundle. Trong mô hình này, nhà phát triển phải trả một khoản tiền cố định (trả trước) cho mỗi lần gói giao dịch. Nhà phát triển phải trả khoản tiền đã định cho dù có gói dịch vụ hay không hoàn toàn được sử dụng.
Đối với mô hình mức giá cố định: Nhập thông tin sau vào phần Giá của cửa sổ Bảng giá chung:
Trường Mô tả Nhà điều hành (hoặc tổ chức) Tên của tổ chức. Trường này được đặt trước bằng cách sử dụng Toán tử (hoặc Tổ chức) trong hồ sơ tổ chức.
Quốc gia Quốc gia hoạt động của tổ chức của bạn. Trường này được đặt trước bằng cách sử dụng Giá trị của trường quốc gia trong hồ sơ tổ chức.
Mức phí cố định Giá được tính cho mỗi giao dịch. Nhập một số thập phân (tối đa 4) chữ số thập phân).
Lưu ý: Bạn có thể định cấu hình số lượng vị trí thập phân có thể chỉ định cho mức giá được tính qua API (không phải giao diện người dùng). Để biết chi tiết, hãy xem phần Định cấu hình số chữ số thập phân cho mức giá 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 là tính phí 0,1 USD cho mỗi giao dịch (hoặc nếu dựa trên thuộc tính tuỳ chỉnh, chẳng hạn như số byte được truyền trong một giao dịch, nhà phát triển phải trả $0,10 đối với đang truyền số byte được chỉ định).
Đối với mô hình phân chia phạm vi số lượng: Cửa sổ Bảng giá chung sẽ hiện các thông tin bổ sung mà bạn sử dụng để chỉ định cơ sở tổng hợp và chỉ định "dải âm lượng", là phạm vi khối lượng giao dịch mà bạn có thể áp dụng các tỷ lệ khác nhau.
Loại kế hoạch này thường được lập ra để khuyến khích các nhà phát triển tạo ra số lượng lớn hơn bằng cách cung cấp mức giá chiết khấu cho các nhó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à khối lượng giao dịch (hoặc liên quan đến thuộc tính) được tổng hợp. Số lượng tổng hợp được dùng để xác định khoảng số lượng và mức giá áp dụng cho mỗi giao dịch. Chọn số tháng (1 – 12 tháng).
Để biết thông tin chi tiết về thời điểm các gói được đặt lại, hãy xem phần Khi nào được lặp lại tính phí và đặt lại gói theo gói?
Dải âm lượng Một hoặc nhiều phạm vi số lượng giao dịch (hoặc dựa trên thuộc tính của khách hàng) (mỗi phạm vi là "dây âm lượng"). Mỗi khoảng âm lượng có thể được chỉ định một mức phí (bạn đặt tỷ lệ này trong trường Băng tần khối lượng của phần Giá.) Mức phí này được áp dụng cho tất cả giao dịch trong phạm vi số lượng áp dụng. Chỉ định giới hạn trên của giá trị đầu tiên dải, ví dụ: lên tới 1000 (giới hạn dưới được đặt trước ở mức lớn hơn 0). Nhấp vào + để thêm dải thứ hai, ví dụ: lớn hơn 1000 đến 2000. Nhấp vào + để thêm người dùng khác ban nhạ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 cao hơn cấp này.
Mức giá Nhà điều hành (hoặc tổ chức) Tên của tổ chức. Trường này được đặt trước bằng cách sử dụng Toán tử (hoặc Tổ chức) trong Hồ sơ tổ chức.
Quốc gia Quốc gia hoạt động của tổ chức của bạn. Trường này được đặt trước bằng cách sử dụng Giá trị của trường quốc gia trong Hồ sơ tổ chức.
Đơn vị tiền tệ "Cơ sở" hoặc đơn vị tiền tệ dùng để tính toán mà tổ chức của bạn sử dụng. Trường này là giá trị đặt trước bằng cách sử dụng giá trị trường Đơn vị tiền tệ trong Hồ sơ tổ chức, nhưng bạn có thể đặt giá trị này đã thay đổi ở đây.
Băng tần Mức giá cho một dải âm lượng. Bạn chỉ định mức phí cho từng khoảng âm lượng. Nhập một số thập phân cho từng dải (với tối đa 4 chữ số thập phân).
Lưu ý: Bạn có thể định cấu hình số lượng vị trí thập phân có thể chỉ định cho tỷ lệ khoảng âm lượng bằng API (không phải giao diện người dùng). Để biết chi tiết, hãy xem phần Định cấu hình số chữ số thập phân cho mức giá gói giá.
Ví dụ: nếu bạn chỉ định hai dải âm lượng trong phần Băng âm lượng (> 0-1000 và 1000 trở lên), bạn có thể nhập 0,15 cho â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à Hoa Kỳ. đô la, tỷ giá đối với 1.000 giao dịch đầu tiên là 0, 15 đô la cho mỗi giao dịch và Đối với hơn 1000 giao dịch, tỷ giá là 0,1 USD cho mỗi giao dịch.
Đối với mô hình đi kèm: Cửa sổ Bảng giá chung hiển thị các trường bổ sung mà bạn sử dụng để chỉ định cơ sở tổng hợp (khoảng thời gian nhà phát triển có thể sử dụng tập hợp các giao dịch) và để chỉ định thông tin liên quan đến gói, chẳng hạn như kích thước 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 hãy sử dụng gói dựa trên thuộc tính tuỳ chỉnh). Chọn số tháng (1-12 tháng). Sau trong khoảng thời gian này, gói sẽ hết hạn và nhà phát triển phải mua gói (và các gói) một lần nữa.
Để biết thông tin chi tiết về thời điểm các gói được đặt lại, hãy xem phần Khi nào được lặp lại tính phí và đặt lại gói theo gói?
Kích thước gói Số giao dịch trong một gói (hoặc một số liên quan đến thuộc tính tuỳ 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 mỗi gói một mức giá (bạn đặt giá này trong trường Kích thước gói của phần Giá). Chiến lược phát hành đĩa đơn 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, cho ví dụ: lên đến 1000 (giới hạn dưới được đặt trước là lớn hơn 0). Nhấp vào + để thêm gói thứ hai, ví dụ: lớn hơn 1000 đến 2000. Nhấp vào + để thêm người dùng khác gói. 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 số tiền cố định cho các giao dịch không giới hạn trong gói.
Mức giá Nhà điều hành (hoặc tổ chức) Tên của tổ chức. Trường này được đặt trước bằng cách sử dụng Toán tử (hoặc Tổ chức) trong Hồ sơ tổ chức.
Quốc gia Quốc gia hoạt động của tổ chức của bạn. Trường này được đặt trước bằng cách sử dụng Giá trị của trường quốc gia trong Hồ sơ tổ chức.
Đơn vị tiền tệ "Cơ sở" hoặc đơn vị tiền tệ dùng để tính toán mà tổ chức của bạn sử dụng. Trường này là giá trị đặt trước bằng cách sử dụng giá trị trường Đơn vị tiền tệ trong Hồ sơ tổ chức, nhưng bạn có thể đặt giá trị này đã thay đổi ở đây.
Kích thước gói (giá) Giá của một gói. Bạn chỉ định giá cho mỗi gói. Nhập số thập phân số (với tối đa bốn chữ số thập phân).
Lưu ý: Bạn có thể định cấu hình số lượng vị trí thập phân có thể chỉ định cho giá gói bằng API (không phải giao diện người dùng). Để biết chi tiết, hãy xem phần Định cấu hình số chữ số thập phân cho mức giá gói giá.
Ví dụ: nếu bạn chỉ định hai gói trong phần Kích thước gói (lớn hơn 0 lên đến 1000 và lớn hơn 1000 đến 2000), bạn có thể nhập 50 cho số lớn hơn số từ 0 đến 1000 gói và nhỏ hơn 40 cho số từ 1000 đến 2000. Nếu đơn vị tiền tệ đã chọn là đô la Mỹ, giá của gói đầu tiên là 50 USD và gói thứ hai, giá là 40 USD. Nhà phát triển sẽ trả phí theo giá gói hiện hành 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ẽ trả phí theo giá của gói ngay khi giao dịch đầu tiên trong gói đã hoàn tất).
- Nhấp vào Áp dụng và đóng để lưu chi tiết bảng giá và quay lại Gói giá tiêu chuẩn cửa sổ.
- Đối với gói giá dành riêng cho sản phẩm API, hãy thiết lập chi tiết gói giá cho các sản phẩm API bổ sung theo yêu cầu.
Định cấu hình gói giá bằng API
Định cấu hình thông tin chi tiết về gói giá bằng API như mô tả trong các phần sau.
Chỉ định chi tiết gói giá bằng API
Bạn chỉ định thông tin chi tiết về gói giá khi tạo gói giá. Bạn chỉ định chi tiết trong
thuộc tính ratePlanDetails
trong nội dung yêu cầu bằng lệnh gọi đến
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans
Nội dung
chỉ định trong thuộc tính ratePlanDetails
, tuỳ thuộc vào mô hình sạc bạn chọn:
mức giá cố định, dải số lượng hoặc gói.
Chỉ định một mô hình tính phí mức cố định
Để triển khai mô hình tính phí cố định, bạn chỉ định thông tin sau trong gói giá chi tiết:
- Một thông số điểm xếp hạng cho biết gói giá dựa trên các giao dịch
(
VOLUME
) hoặc dựa trên một thuộc tính tuỳ chỉnh (ví dụ:MINT_CUSTOM_ATTRIBUTE_1
).VOLUME
là giá trị mặc định. - Loại định mức (
UNIT
) cho biết rằng tốc độ được cố định trên mỗi đơn vị (tức là là không dựa trên số lượng giao dịch, như trường hợp kênh phân chia số lượng hoặc mô hình sạc theo gói). - Khoảng thời gian đến hạn thanh toán (ví dụ: 30 ngày).
- Mã tổ chức của bạn.
- "Cơ sở" hoặc đơn vị tiền tệ kế toán mà công ty của bạn sử dụng.
- Mức giá gói giá cung cấp thông tin chi tiết về cách tính mức giá. Vì mô hình tính phí dựa trên mức phí cố định, bạn chỉ được chỉ định một mức giá cho gói giá.
Trong giá gói giá, bạn chỉ định:
- Loại mức giá gói giá (
RATECARD
). - Giá cho gói. Ví dụ: nếu bạn chỉ định 0,10 và đơn vị tiền tệ là đô la Mỹ, nhà phát triển bị tính phí 0,1 USD cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tuỳ chỉnh như số byte được truyền trong một giao dịch, nhà phát triển phải trả $0,10 đang truyền số byte được chỉ định).
- Đơn vị bắt đầu của ứng dụng giá (
0
). Điều này có nghĩa là tỷ lệ này được áp dụng cho mỗi giao dịch, bắt đầu từ giao dịch đầu tiên.
Xem Gói giá chế độ cài đặt cấu hình chi tiết để xem danh sách đầy đủ các lựa chọn chi tiết về gói giá.
Ví dụ: đoạn mã sau đây sẽ tạo một gói giá theo mô hình tính phí cố định. Tỷ lệ là được đặt ở mức 0,1 đô la Mỹ cho mỗi giao dịch. Khoản thanh toán sẽ đến hạn sau 30 ngày nữa. (Các chi tiết liên quan đến bảng giá là highlighted.)
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 sạc dải âm lượng
Trong mô hình phân chia theo dải số lượng, bạn sẽ chỉ định thông tin chi tiết về gói giá bao gồm một hoặc nhiều gói giá giá, mỗi mức giá áp dụng cho một "phạm vi số lượng", tức là một phạm vi khối lượng giao dịch (hoặc một phạm vi dựa trên thuộc tính tuỳ chỉnh như số byte được truyền). Loại gói 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 đưa ra mức giá chiết khấu cho các băng tần có âm lượng cao hơn.
Ngoài giá gói giá, bạn còn nêu rõ các thông tin sau trong thông tin chi tiết về gói giá:
- Một thông số điểm xếp hạng cho biết gói giá dựa trên các giao dịch
(
VOLUME
) hoặc dựa trên một thuộc tính tuỳ chỉnh (ví dụ:CUSTOM_ATTRIBUTE_1
).VOLUME
là giá trị mặc định. - Một loại định mức (
VOLUME
) cho biết rằng tốc độ dựa trên âm lượng giao dịch (nghĩa là đây không phải là mức giá cố định cho mỗi giao dịch, như trong 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ã tổ chức của bạn.
- "Cơ sở" hoặc đơn vị tiền tệ kế toán mà công ty của bạn sử dụng.
- Loại thời lượng và thời lượng cùng chỉ định khoảng thời gian mà âm lượng giao dịch (hoặc khối lượng liên quan đến thuộc tính tuỳ chỉnh) được tổng hợp. Đây còn được gọi là "cơ sở tổng hợp". Số lượng giao dịch được tổng hợp trên cơ sở tổng hợp (đối với ví dụ: 1 tháng) để xác định dải âm lượng áp dụng.
- Bộ đếm tổng hợp dùng để xác định dải âm lượng áp dụng.
Đối với mỗi mức giá gói giá, bạn cần nêu rõ:
- Loại mức giá gói giá (
RATECARD
). - Giá cho gói. Ví dụ: nếu bạn chỉ định 0,10 và đơn vị tiền tệ là đô la Mỹ, nhà phát triển bị tính phí 0,15 USD cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tuỳ chỉnh như số byte được truyền trong một giao dịch, nhà phát triển phải trả $0,15 cho đang 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 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. Cho
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 âm lượng sẽ bao hàm
tối đa 1000 giao dịch trong thời gian tổng hợp. Nếu đơn vị tiền tệ là đô la Mỹ thì
Kỳ tổng hợp là 1 tháng, và tỷ lệ cho 1000 giao dịch đầu tiên là 0, 15.
nhà phát triển cần trả 0,15 USD cho mỗi giao dịch đối với tối đa 1.000 giao dịch trong tháng.
Để biết thông tin chi tiết về thời điểm đặt lại các gói, hãy xem bài viết Những trường hợp bạn sẽ bị tính phí định kỳ và đặt lại gói theo gói?
Nếu bạn không chỉ định đơn vị kết thúc cho khoảng âm lượng cuối cùng, thì giá cho khoảng đó sẽ là được áp dụng cho tất cả giao dịch sau khi số lượng giao dịch đã vượt quá đơn vị ban đầu cho nhóm đó. Ví dụ: nếu đơn vị bắt đầu của dải cuối là 1000 và bạn không chỉ định đơn vị kết thúc cho dải đó thì mức giá cho dải sẽ được áp dụng cho tất cả các giao dịch sau 1000 giao dịch trong giai đoạn tổng hợp.
Xem Gói giá chế độ cài đặt cấu hình chi tiết để xem danh sách đầy đủ các lựa chọn chi tiết về gói giá.
Ví dụ: sau đây là cách tạo một gói giá theo mô hình tính phí theo dải tần số. Chiến lược phát hành đĩa đơn được đặt ở mức 0,15 đô la cho 1000 giao dịch đầu tiên và 0,10 đô la cho tất cả các giao dịch trên 1000. Cơ sở tổng hợp là 1 tháng. Khoản thanh toán sẽ đến hạn sau 30 ngày nữa. (Chi tiết bảng giá được đánh dấu).
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ột kiểu máy sạc theo gói
Trong mô hình tính phí theo gói, nhà phát triển sẽ thanh toán (trả trước) cho một "gói" số lượng giao dịch (hoặc cho gói dựa trên thuộc tính tuỳ chỉnh như số byte được truyền). Bạn chỉ định một 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 hai gói, trong đó kích thước gói đầu tiên là từ 1 đến 1000 giao dịch và kích thước gói thứ hai là từ 1001 đến 2000 giao dịch. Mức giá là 50 đô la Mỹ gói đầu tiên và 40 USD cho gói thứ hai, cơ sở tổng hợp là 1. Nếu nhà phát triển khi mua gói bảng giá cho gói đầu tiên, họ trả 50 đô la (trả trước) cho 1.000 giao dịch trong một tháng. Nhà phát triển sẽ phải trả một khoản phí đã định cho dù người dùng đã sử dụng toàn bộ gói hay chưa. Sau khi kỳ tổng hợp kết thúc, gói sẽ hết hạn. Nếu nhà phát triển muốn sử dụng gói thì họ phải mua lại gói thuê bao đó (và cả gói).
Thông tin bạn chỉ định trong thông tin chi tiết về gói giá về cơ bản giống với thông tin bạn chỉ định trong thông tin chi tiết về gói giá cho mô hình tính phí theo dải tần suất. Có những điểm khác biệt như sau:
- Mỗi gói giá mà bạn chỉ định là dành cho gói (chứ không phải cho nhóm số lượng).
- Bạn phải chỉ định giới hạn trên cho gói cuối cùng, trừ khi bạn muốn tính phí nhà phát triển một số tiền cố định cho các giao dịch không giới hạn trong gói cuối cùng.
Xem Gói giá chế độ cài đặt cấu hình chi tiết để xem danh sách đầy đủ các lựa chọn chi tiết về gói giá.
Ví dụ: sau đây là cách tạo một gói giá theo một mô hình tính phí đi kèm. Tỷ lệ là đặt ở mức 50 đô la cho gói đầu tiên (tối đa 1.000 giao dịch) và 40 đô la cho gói thứ hai (nhiều hơn hơn 1000 và tối đa 2000 giao dịch). Cơ sở tổng hợp là 1 tháng. Đến hạn thanh toán sau 30 phút nữa 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 thu phí trong miễn phí cho từng sản phẩm bằng API
Trong gói bảng giá, bạn có thể thiết lập gói thu phí trong miễn phí cho từng sản phẩm riêng lẻ (thay vì cho một gói API). Gói thu phí trong miễn phí 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 thời gian cụ thể hoặc dựa trên lượng sử dụng.
Khi thiết lập gói thu phí trong miễn phí cho một sản phẩm API, bạn phải chỉ định trong chi tiết gói giá khoảng thời gian mà nhà phát triển có thể sử dụng các tài nguyên do sản phẩm API cung cấp mà không sạc. Khoảng thời gian này có thể dựa trên một trong các yếu tố sau:
- Thời lượng, tức là 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ố lượng giao dịch liên quan đến sản phẩm API hoặc số lượng liên quan đến thuộc tính tuỳ chỉnh được ghi lại trong chính sách ghi lại giao dịch.
Nếu khoảng thời gian thu phí trong miễn phí dựa trên số lượng, hãy chỉ định khoảng thời gian đó là một số đơn vị thu phí trong miễn phí. Cho Ví dụ: sau đây là cách tạo gói giá trong gói thu phí trong miễn phí dựa trên số lượng 5.000 đơn vị (các thông số kỹ thuật liên quan đến thu phí trong miễn phí đượ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