คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่
เอกสารประกอบเกี่ยวกับ Apigee X. ข้อมูล
บทนำ
ในแผนส่วนแบ่งรายได้ ผู้ให้บริการ API จะแชร์เปอร์เซ็นต์ของ รายได้ที่มาจากธุรกรรมแต่ละรายการ (ตามราคารวมหรือราคาสุทธิของธุรกรรม) วันและเวลา เมื่อคุณสร้างแผนส่วนแบ่งรายได้ คุณจะต้องระบุรูปแบบการแชร์ ซึ่งอาจเป็นการแก้ไข หรือยืดหยุ่นได้ และมีพื้นฐานการกำหนดราคา (เช่น ส่วนแบ่งรายได้อิงตามรายได้รวมหรือสุทธิ ราคาธุรกรรม) คุณกำหนดราคารวมหรือราคาสุทธิสำหรับธุรกรรมเมื่อสร้างนโยบายการบันทึกธุรกรรม
ในรูปแบบการแชร์แบบคงที่ คุณจะแบ่งรายได้กับนักพัฒนาแอปในเปอร์เซ็นต์คงที่ ที่สร้างจากธุรกรรมแต่ละรายการ (ตามราคารวมหรือราคาสุทธิของธุรกรรม) ใน ซึ่งเป็นรูปแบบการแชร์แบบยืดหยุ่น โดยจะแชร์เปอร์เซ็นต์รายได้ให้นักพัฒนาซอฟต์แวร์ ส่วนแบ่งรายได้จะขึ้นอยู่กับรายได้ที่เกิดขึ้นในช่วงเวลาหนึ่ง เปอร์เซ็นต์ที่ใช้ใน การคำนวณส่วนแบ่งรายได้อาจแตกต่างกันไปตามจำนวนรายได้ที่เกิดจากธุรกรรม
การระบุรายละเอียดของแผนส่วนแบ่งรายได้โดยใช้ UI
กำหนดค่าแผนส่วนแบ่งรายได้ตามที่อธิบายไว้ด้านล่าง
Edge
หากต้องการกำหนดค่าแผนส่วนแบ่งรายได้โดยใช้ Edge UI เมื่อสร้างหรือแก้ไข สำหรับแพ็กเกจราคา ให้เลือกประเภทแพ็กเกจราคาส่วนแบ่งรายได้หรือเรตการ์ดและส่วนแบ่งรายได้ และในส่วนส่วนแบ่งรายได้กำหนดค่าข้อมูลต่อไปนี้
| ฟิลด์ | คำอธิบาย |
| รูปแบบการคำนวณ | เลือกประเภทการกำหนดราคาประเภทใดประเภทหนึ่งต่อไปนี้
|
| ความถี่ในการคำนวณ | ระยะเวลาที่จะคำนวณปริมาณธุรกรรม (หรือปริมาณที่เกี่ยวข้องกับแอตทริบิวต์ที่กำหนดเอง) เลือกจำนวนเดือน (1-24 เดือน) |
| กำลังแชร์โมเดล | เลือกส่วนแบ่งรายได้รูปแบบใดรูปแบบหนึ่งต่อไปนี้
|
| ส่วนแบ่งรายได้แบบคงที่ | สำหรับรูปแบบการแชร์คงที่ ให้ระบุเปอร์เซ็นต์ที่ใช้ในการคำนวณส่วนแบ่งรายได้ ป้อนตัวเลขทศนิยม (มีทศนิยมได้สูงสุด 4 ตำแหน่ง) ตัวอย่างเช่น หากคุณป้อน 80.5555 ส่วนแบ่งรายได้คือ 80.5555% ซึ่งหมายความว่าในฐานะผู้ให้บริการ API คุณจะจ่ายเงินให้กับนักพัฒนาแอป 80.5555% ของราคาที่เรียกเก็บสำหรับแต่ละธุรกรรม |
| ช่วงส่วนแบ่งรายได้ | สำหรับรูปแบบการแชร์แบบยืดหยุ่น ช่วงรายได้จากธุรกรรมอย่างน้อย 1 ช่วง (แต่ละช่วงคือ "ช่วงรายได้") ช่วงรายได้แต่ละช่วงสามารถกำหนดเปอร์เซ็นต์ส่วนแบ่งรายได้ ธุรกรรมจะถูกรวบรวมจากรูปแบบการรวมเพื่อคำนวณรายได้รวมและช่วงรายได้จากธุรกรรม เปอร์เซ็นต์ส่วนแบ่งรายได้ที่ใช้กับธุรกรรมแต่ละรายการจะขึ้นอยู่กับช่วงรายได้ของธุรกรรมนั้นๆ เช่น ระบุขีดจำกัดสูงสุดของแบนด์ภาพแรก เช่น ไม่เกิน 1,000 (ค่าขีดจำกัดต่ำสุดถูกกำหนดไว้ล่วงหน้าให้มากกว่า 0) คลิก +ใหม่ เพื่อเพิ่มย่านความถี่เพิ่มเติม ปล่อยขีดจำกัดบนของช่วงสุดท้ายว่างไว้เพื่อระบุธุรกรรมทั้งหมดหลังจากที่รายได้รวมสูงกว่าระดับนี้ ตัวอย่างเช่น หากคุณระบุช่วงรายได้ 2 ในส่วนช่วงรายได้ (>0-1000 และ 1000 ขึ้นไป) คุณอาจป้อน 80.5555 สำหรับช่วงรายได้ >0-1000 และ 90.5 สำหรับช่วงรายได้ 1,000 ขึ้นไป และสมมติว่าสกุลเงินใช้ในสกุลเงินดอลลาร์สหรัฐ จากนั้นสำหรับธุรกรรมที่สร้างรายได้สูงสุด $1,000 ส่วนแบ่งรายได้จะเท่ากับ 80.5555% ของราคาธุรกรรม และสำหรับธุรกรรมที่สร้างรายได้มากกว่า $1,000 ส่วนแบ่งรายได้จะเท่ากับ 90.5% ของราคาธุรกรรม |
คลาสสิก Edge (Private Cloud)
วิธีกำหนดค่าแผนส่วนแบ่งรายได้โดยใช้ UI แบบคลาสสิกของ Edge
- ทำตามขั้นตอนเพื่อสร้างแพ็กเกจราคา
- เลือกส่วนแบ่งรายได้ในเมนูแบบเลื่อนลงประเภทแพ็กเกจราคาเพื่อกำหนดค่ารูปแบบรายได้
- หากแพ็กเกจ API ที่เลือกมีผลิตภัณฑ์ API หลายรายการ ให้เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
หมายเหตุ: หากแพ็กเกจ API มีผลิตภัณฑ์ API รายการเดียว คุณข้ามขั้นตอนนี้ได้
- แพ็กเกจเฉพาะผลิตภัณฑ์เพื่อกำหนดค่ารายละเอียดแพ็กเกจราคาสำหรับผลิตภัณฑ์ API แต่ละรายการ
- แผนทั่วไปสำหรับผลิตภัณฑ์ทั้งหมดเพื่อกำหนดค่ารายละเอียดแพ็กเกจราคาสำหรับผลิตภัณฑ์ API ทั้งหมด
- คลิกส่วนแบ่งรายได้สำหรับแพ็กเกจราคาทั่วไปหรือแพ็กเกจราคาเฉพาะผลิตภัณฑ์ของ API แต่ละรายการ
หมายเหตุ: เมื่อกำหนดค่าแผนเฉพาะผลิตภัณฑ์ API คุณจะต้องกำหนดค่าแผนส่วนแบ่งรายได้ สำหรับผลิตภัณฑ์ API แต่ละรายการ
หน้าต่างส่วนแบ่งรายได้จะเปิดขึ้น
- เลือกโมเดลการแชร์แบบใดแบบหนึ่งต่อไปนี้
- แก้ไขแล้ว: ในโมเดลนี้ ผู้ให้บริการ API จะแชร์เปอร์เซ็นต์คงที่กับนักพัฒนาซอฟต์แวร์ รายได้ที่เกิดจากธุรกรรมแต่ละรายการ (อิงตามราคาขายรวมหรือสุทธิของ ธุรกรรม)
- ยืดหยุ่น: ในโมเดลนี้ ผู้ให้บริการ API จะแชร์ตัวแปรกับนักพัฒนาซอฟต์แวร์ เปอร์เซ็นต์ของรายได้ ส่วนแบ่งรายได้ขึ้นอยู่กับรายได้ที่เกิดขึ้นในช่วงเวลาหนึ่ง เปอร์เซ็นต์ที่ใช้ในการคำนวณส่วนแบ่งรายได้อาจแตกต่างกันไปตามจำนวนเงิน ของรายได้ที่เกิดจากธุรกรรม
สำหรับรูปแบบการแชร์แบบคงที่ ให้ทำดังนี้
หากคุณเลือกรูปแบบการแชร์แบบคงที่ ให้ป้อนข้อมูลต่อไปนี้ในช่องการกำหนดราคา ของหน้าต่างส่วนแบ่งรายได้ทั่วไป
ช่อง คำอธิบาย ผู้ประกอบการ (หรือองค์กร) ชื่อองค์กรของคุณ ฟิลด์นี้ได้กำหนดค่าล่วงหน้าโดยใช้โอเปอเรเตอร์ (หรือ องค์กร) ในโปรไฟล์องค์กร
ประเทศ ประเทศที่ดำเนินการขององค์กร ฟิลด์นี้ได้กำหนดค่าล่วงหน้าโดยใช้ ค่าของช่องประเทศในโปรไฟล์องค์กร
สกุลเงิน "ฐาน" หรือสกุลเงินในบัญชีที่บริษัทของคุณใช้ ช่องนี้เป็นค่าที่กำหนดล่วงหน้า โดยใช้ค่าในช่องสกุลเงินในโปรไฟล์องค์กร
ประเภทการกำหนดราคา พื้นฐานของส่วนแบ่งรายได้ เลือกรายได้รวมหรือสุทธิ หากคุณเลือกรายได้รวม ส่วนแบ่งรายได้จะอิงตามเปอร์เซ็นต์ของราคาขายของธุรกรรม หากคุณ เลือกสุทธิ ส่วนแบ่งรายได้จะเป็นไปตามเปอร์เซ็นต์ของราคาสุทธิของ ธุรกรรม หมายเหตุ: คุณต้องกำหนดราคารวมหรือราคาสุทธิของธุรกรรมเมื่อสร้างนโยบายการบันทึกธุรกรรม
% ส่วนแบ่งคงที่ เปอร์เซ็นต์ที่ใช้ในการคำนวณส่วนแบ่งรายได้ ป้อนจำนวนทศนิยม (ที่มี ทศนิยม 4 ตำแหน่ง) ตัวอย่างเช่น หากคุณป้อน 80.5555 ส่วนแบ่งรายได้จะเป็น 80.5555% ซึ่งหมายความว่าในฐานะผู้ให้บริการ API คุณจะจ่ายเงินให้กับนักพัฒนาแอป 80.5555% ของราคา เรียกเก็บเงินสำหรับธุรกรรมแต่ละรายการ
สำหรับรูปแบบการแชร์แบบยืดหยุ่น
หากคุณเลือกรูปแบบการแชร์แบบยืดหยุ่น คุณจะสังเกตเห็นว่าหน้าต่างส่วนแบ่งรายได้ทั่วไป แสดงฟิลด์เพิ่มเติม โดยใช้ฟิลด์เหล่านี้เพื่อระบุเกณฑ์พื้นฐานสำหรับการรวมและ ระบุ "ช่วงรายได้" ซึ่งหมายถึงช่วงของรายได้ที่เกิดจากธุรกรรม ซึ่งคุณสามารถ ใช้เปอร์เซ็นต์ส่วนแบ่งรายได้ที่ต่างกัน
ป้อนข้อมูลต่อไปนี้ในหน้าต่างส่วนแบ่งรายได้ทั่วไป
ช่อง คำอธิบาย พื้นฐานในการรวม ระยะเวลาที่มีการรวบรวมรายได้ รายได้รวมคือ ใช้ในการคำนวณช่วงรายได้สำหรับธุรกรรมแต่ละรายการ (และรายได้ที่เกี่ยวข้อง เปอร์เซ็นต์ส่วนแบ่ง) เลือกจำนวนเดือน (ระหว่าง 1 ถึง 12)
ช่วงรายได้ ช่วงของรายได้จากธุรกรรมอย่างน้อย 1 ช่วง (แต่ละช่วงคือ "ช่วงรายได้") ชิ้น สามารถกำหนดเปอร์เซ็นต์ส่วนแบ่งรายได้ (คุณตั้งเปอร์เซ็นต์นี้ใน ฟิลด์แถบรายได้ของส่วนการกำหนดราคา) ธุรกรรมจะรวบรวมจาก เกณฑ์ขั้นต่ำในการคํานวณรายได้ทั้งหมดและช่วงรายได้สําหรับ ธุรกรรม เปอร์เซ็นต์ส่วนแบ่งรายได้ที่ใช้กับธุรกรรมแต่ละรายการจะขึ้นอยู่กับ ช่วงรายได้
ระบุขีดจำกัดสูงสุดของย่านความถี่แรก เช่น ไม่เกิน 1000 (ค่าที่ต่ำกว่า มีค่าที่กำหนดล่วงหน้ามากกว่า 0) คลิก + เพื่อเพิ่มแถบที่ 2 เช่น มากกว่า 1,000 และสูงสุด 2,000 คลิก + เพื่อเพิ่มสายอื่นๆ คุณออกจากด้านบนได้ ค่าจำกัดของแบนด์ภาพสุดท้ายว่างเปล่า เพื่อแสดงธุรกรรมทั้งหมดหลังจากการรวม ได้สูงกว่าระดับนี้
ราคา ผู้ประกอบการ (หรือองค์กร) ชื่อองค์กรของคุณ ฟิลด์นี้ได้กำหนดค่าล่วงหน้าโดยใช้โอเปอเรเตอร์ (หรือ องค์กร) ในโปรไฟล์องค์กร
ประเทศ ประเทศที่ดำเนินการขององค์กร ฟิลด์นี้ได้กำหนดค่าล่วงหน้าโดยใช้ ค่าของช่องประเทศในโปรไฟล์องค์กร
สกุลเงิน "ฐาน" หรือสกุลเงินในบัญชีที่องค์กรของคุณใช้ ช่องนี้ ล่วงหน้าโดยใช้ค่าในช่องสกุลเงินในโปรไฟล์องค์กร
ประเภทการกำหนดราคา พื้นฐานของส่วนแบ่งรายได้ เลือกรายได้รวมหรือสุทธิ หากคุณเลือกรายได้รวม ส่วนแบ่งรายได้จะอิงตามเปอร์เซ็นต์ของราคาขายของธุรกรรม หากคุณ เลือกสุทธิ ส่วนแบ่งรายได้จะเป็นไปตามเปอร์เซ็นต์ของราคาสุทธิของ ธุรกรรม หมายเหตุ: คุณต้องกำหนดราคารวมหรือราคาสุทธิของธุรกรรมเมื่อสร้างนโยบายการบันทึกธุรกรรม
แบ่ง % ของช่วงรายได้ เปอร์เซ็นต์ที่ใช้ในการคำนวณส่วนแบ่งรายได้สำหรับธุรกรรมในแต่ละรายการ ช่วงรายได้ คุณจะระบุเปอร์เซ็นต์สำหรับแต่ละแบนด์ภาพ ป้อนตัวเลขทศนิยม (โดยมีขึ้น) ทศนิยม 4 ตำแหน่ง) ตัวอย่างเช่น หากคุณระบุช่วงรายได้ 2 ช่วงในส่วน "รายได้" ส่วนย่านความถี่ (>0-1000 และ 1000 ขึ้นไป) คุณอาจป้อน 80.5555 สำหรับ ช่วงรายได้มากกว่า 0-1,000 และ 90.5 สำหรับช่วงรายได้ 1,000 ขึ้นไป และให้สมมติว่า ใช้สกุลเงินดอลลาร์สหรัฐ จากนั้นสำหรับธุรกรรมที่สร้างรายได้สูงสุด 30,000 บาท ส่วนแบ่งรายได้จะเท่ากับ 80.5555% ของราคาธุรกรรม และสำหรับ ธุรกรรมที่สร้างรายได้มากกว่า $1, 000 โดยส่วนแบ่งรายได้อยู่ที่ 90.5% ราคาธุรกรรม
- คลิกใช้และปิดเพื่อบันทึกรายละเอียดส่วนแบ่งรายได้และกลับไปที่อัตรามาตรฐาน กรอบเวลาของแผน
- สำหรับแพ็กเกจราคาเฉพาะผลิตภัณฑ์ API ให้กำหนดค่ารายละเอียดแพ็กเกจราคาสำหรับผลิตภัณฑ์ API เพิ่มเติมตามต้องการ
การระบุรายละเอียดแผนส่วนแบ่งรายได้โดยใช้ API
คุณต้องระบุรายละเอียดของแพ็กเกจส่วนแบ่งรายได้เมื่อสร้างแพ็กเกจราคา คุณระบุรายละเอียด
ในพร็อพเพอร์ตี้ ratePlanDetails ภายในเนื้อหาคำขอในการเรียกไปยัง
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans สิ่งที่คุณ
ที่ระบุในพร็อพเพอร์ตี้ ratePlanDetails จะขึ้นอยู่กับรูปแบบการแชร์ที่คุณเลือก
แบบคงที่หรือยืดหยุ่น
การระบุรายละเอียดแผนส่วนแบ่งรายได้สำหรับรูปแบบการแชร์แบบคงที่
หากต้องการใช้รูปแบบการแชร์แบบคงที่ คุณจะต้องระบุข้อมูลต่อไปนี้ในรายละเอียดแพ็กเกจราคา
- พารามิเตอร์การให้คะแนนที่ระบุว่าแพ็กเกจราคาอิงตามธุรกรรม
(
VOLUME)VOLUMEคือค่าเริ่มต้น - ประเภทการวัด (
UNIT) ที่ระบุว่าส่วนแบ่งรายได้เป็นค่าคงที่ต่อหน่วย (กล่าวคือ ไม่ได้พิจารณาจากปริมาณธุรกรรม อย่างในกรณีของ โมเดลที่ใช้ร่วมกัน) - ประเภทรายได้ (
GROSSหรือNET) ค่านี้ระบุว่า ส่วนแบ่งรายได้จะอิงตามราคาขายหรือสุทธิของธุรกรรม - ระยะเวลาครบกำหนดชำระเงิน (เช่น 30 วัน)
- รหัสขององค์กร
- "ฐาน" หรือสกุลเงินในบัญชีที่บริษัทของคุณใช้
- ราคาของแพ็กเกจราคาที่มีรายละเอียดเกี่ยวกับวิธีคำนวณส่วนแบ่งรายได้ เพราะ รูปแบบการแชร์จะอิงตามราคาคงที่ คุณระบุเพียงอัตราเดียวของแพ็กเกจราคา
ดูพร็อพเพอร์ตี้การกำหนดค่าสำหรับรายละเอียดแพ็กเกจราคาสำหรับรายการพร็อพเพอร์ตี้รายละเอียดแพ็กเกจราคาทั้งหมด
ในราคาแพ็กเกจราคา คุณจะระบุสิ่งต่อไปนี้
- ประเภทของแพ็กเกจราคา (
REVSHARE) - เปอร์เซ็นต์ที่ใช้ในการคำนวณส่วนแบ่งรายได้ ตัวอย่างเช่น หากคุณระบุ 80.5555 ส่วนแบ่งรายได้คือ 80.5555% ซึ่งหมายความว่าในฐานะผู้ให้บริการ API คุณจะจ่ายเงินให้กับนักพัฒนาซอฟต์แวร์ 80.5555% ราคาที่เรียกเก็บสำหรับแต่ละธุรกรรม (หรือหากอิงตามแอตทริบิวต์ที่กำหนดเอง เช่น จำนวน จำนวนไบต์ที่ส่งในธุรกรรม คุณจะชำระเงินให้กับนักพัฒนาซอฟต์แวร์ 80.5555% ของราคาที่เรียกเก็บ ส่งผ่านจำนวนไบต์ที่ระบุ)
- หน่วยเริ่มต้นของแอปพลิเคชันอัตรา (
0) ซึ่งหมายความว่าราคานี้จะ จะใช้กับธุรกรรมแต่ละรายการ โดยเริ่มจากธุรกรรมแรก
ดูที่พักการกำหนดค่าสำหรับแพ็กเกจราคาเพื่อดูรายการที่พักทั้งหมดของแพ็กเกจราคา
ตัวอย่างต่อไปนี้เป็นการสร้างแผนส่วนแบ่งรายได้ที่มีรูปแบบการแชร์แบบคงที่ เปอร์เซ็นต์ส่วนแบ่งรายได้อยู่ที่ 80.5555% ส่วนแบ่งรายได้จะอิงตามราคาสุทธิของ ธุรกรรม สัญญาจะมีผลในวันที่ 15 กันยายน 2013 และครบกำหนดชำระเงินภายใน 30 วัน (พารามิเตอร์ รายละเอียดเกี่ยวกับส่วนแบ่งรายได้จะถูกไฮไลต์ไว้)
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Fixed share plan",
"developer":null,
"developerCategory":null,
"advance": false,
"currency": {
"id": "usd"
},
"description": "Fixed share plan",
"displayName": "Fixed share plan",
"earlyTerminationFee": 10,
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": false,
"published": true,
"ratePlanDetails": [
{
"aggregateStandardCounters": true,
"currency": {
"id": "usd"
},
"duration": 1,
"durationType": "MONTH",
"meteringType": "UNIT",
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"ratePlanRates": [
{
"revshare": 80.8555,
"startUnit": 0,
"type": "REVSHARE"
}
],
"ratingParameter": "VOLUME",
"revenueType": "NET",
"type": "REVSHARE"
}
],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"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
คำตอบควรมีลักษณะดังนี้ (แสดงเพียงบางส่วนของคำตอบ)
{ "advance" : false, "currency" : { "id" : "usd", "name" : "USD", ... "organization" : { ... }, ... }, "description" : "Fixed share plan", "displayName" : "Fixed share plan", "earlyTerminationFee" : 10, "id" : "location_fixed_share_plan", "monetizationPackage" : { "description" : "Location", "displayName" : "Location", "id" : "location", "name" : "Location", "organization" : { ... }, "product" : [ { "customAtt1Name" : "user", "description" : "Location", "displayName" : "Location", "id" : "location", "name" : "location", "organization" : { ... }, "status" : "CREATED" } ], "status" : "CREATED" }, "name" : "Fixed share plan", "organization" : { ... }, "paymentDueDays" : "30", "prorate" : false, "published" : true, "ratePlanDetails" : [ { "aggregateFreemiumCounters" : true, "aggregateStandardCounters" : true, "currency" : { "id" : "usd", "name" : "USD", ... "organization" : { ... }, ... }, "duration" : 1, "durationType" : "MONTH", "id" : "c1720153-c60f-4f7f-b4e5-cdc7bc7bec5b", "meteringType" : "UNIT", "organization" : { ... }, "paymentDueDays" : "30", "ratePlanRates" : [ { "id" : "01c4d544-d907-423b-964e-4e2aed2816a3", "revshare" : 80.8555, "startUnit" : 0, "type" : "REVSHARE" } ], "ratingParameter" : "VOLUME", "revenueType" : "NET", "type" : "REVSHARE" } ], "recurringStartUnit" : 1, "recurringType" : "CALENDAR", "setUpFee" : 10, "startDate" : "2013-09-15 00:00:00", "type" : "STANDARD" }
การระบุรายละเอียดแผนส่วนแบ่งรายได้สำหรับโมเดลการแชร์แบบยืดหยุ่น
ในรูปแบบการแชร์แบบยืดหยุ่น คุณจะระบุรายละเอียดแพ็กเกจราคาที่มีแพ็กเกจราคาอย่างน้อย 1 รายการ อัตราของแผนราคาแต่ละราคาครอบคลุมช่วงของรายได้จากธุรกรรม (แต่ละช่วงเรียกว่า "รายได้" ") คุณกำหนดเปอร์เซ็นต์ส่วนแบ่งรายได้สำหรับช่วงรายได้แต่ละช่วง
นอกจากราคาของแพ็กเกจราคาแล้ว คุณจะระบุข้อมูลต่อไปนี้ในรายละเอียดแพ็กเกจราคาด้วย
- พารามิเตอร์การให้คะแนนที่ระบุว่าแพ็กเกจราคาอิงตามธุรกรรม
(
VOLUME)VOLUMEคือค่าเริ่มต้น - ประเภทการจำกัดปริมาณ (
VOLUME) ที่บ่งบอกว่าส่วนแบ่งรายได้ไม่ได้อิงจาก ปริมาณธุรกรรม (กล่าวคือ ไม่ได้คงที่ ในกรณีของการแชร์แบบคงที่ รุ่น) - ประเภทรายได้ (
GROSSหรือNET) ค่านี้ระบุว่า ส่วนแบ่งรายได้จะอิงตามราคาขายหรือสุทธิของธุรกรรม - ระยะเวลาครบกำหนดชำระเงิน (เช่น 30 วัน)
- รหัสขององค์กร
- "ฐาน" หรือสกุลเงินในบัญชีที่บริษัทของคุณใช้
- ระยะเวลาและประเภทระยะเวลาที่เมื่อรวมกันแล้วจะเป็นตัวระบุระยะเวลาที่มีรายได้ แบบรวม (เรียกอีกอย่างหนึ่งว่า "เกณฑ์การรวบรวมข้อมูล") ธุรกรรมจะรวบรวมจาก เกณฑ์การรวม (เช่น 1 เดือน) เพื่อคำนวณรายได้ทั้งหมดและ ช่วงรายได้ เปอร์เซ็นต์ส่วนแบ่งรายได้ที่ใช้กับธุรกรรมแต่ละรายการจะขึ้นอยู่กับรายได้ของธุรกรรมนั้นๆ สายนาฬิกา
- ตัวนับการรวมที่ใช้ในการกำหนดช่วงรายได้ที่เกี่ยวข้อง
ดูพร็อพเพอร์ตี้การกำหนดค่าสำหรับรายละเอียดแพ็กเกจราคาสำหรับรายการพร็อพเพอร์ตี้รายละเอียดแพ็กเกจราคาทั้งหมด
สำหรับราคาของแพ็กเกจราคาแต่ละรายการ คุณจะระบุสิ่งต่อไปนี้
- ประเภทของอัตราแพ็กเกจราคาสำหรับช่วงรายได้ (
REVSHARE) - เปอร์เซ็นต์ที่ใช้ในการคำนวณส่วนแบ่งรายได้สำหรับช่วงรายได้ ตัวอย่างเช่น หาก คุณระบุ 80.5555 ส่วนแบ่งรายได้สำหรับช่วงรายได้คือ 80.5555% ซึ่งก็คือแบบ API คุณจะชำระเงินให้กับนักพัฒนาซอฟต์แวร์ 80.5555% ของราคาที่เรียกเก็บสำหรับแต่ละธุรกรรมใน ช่วงรายได้
- หน่วยเริ่มต้นและหน่วยสุดท้ายของช่วงรายได้ โดยหน่วยเริ่มต้นจะระบุค่า
ของช่วงรายได้ และหน่วยสุดท้ายจะระบุขีดจำกัดสูงสุดของช่วงรายได้ สำหรับ
เช่น หากคุณระบุหน่วยเริ่มต้นเป็น 0 และหน่วยสิ้นสุดเป็น 1000 ช่วงรายได้
ครอบคลุมรายได้จากธุรกรรมมากกว่า 0 และสูงสุด 1000 ในสกุลเงินที่ระบุ หาก
สกุลเงินคือดอลลาร์สหรัฐ พื้นฐานการสรุปรวมคือ 1 เดือน และเปอร์เซ็นต์ของรายได้
คือ 80.5555% จากนั้นสำหรับธุรกรรมที่สร้างรายได้สูงสุด $1,000 ใน 1 เดือน ค่า
ส่วนแบ่งรายได้อยู่ที่ 80.5555% ของราคาธุรกรรม
หากคุณไม่ได้ระบุหน่วยสุดท้ายสำหรับช่วงรายได้สุดท้าย เปอร์เซ็นต์ส่วนแบ่งของ ขอบเขตดังกล่าวจะมีผลกับธุรกรรมทั้งหมดหลังจากที่รายได้รวมสูงกว่า หน่วยเริ่มต้นของแถบนั้น ตัวอย่างเช่น ถ้าหน่วยเริ่มต้นสำหรับย่านความถี่สุดท้ายคือ 1000 (สมมติว่าเป็นดอลลาร์สหรัฐฯ) และคุณไม่ได้ระบุหน่วยสุดท้ายสำหรับวงนั้น รายได้ เปอร์เซ็นต์ของช่วงดังกล่าวจะใช้กับธุรกรรมทุกรายการที่เกิน $1,000 ระหว่าง ระยะเวลารวม
ดูที่พักการกำหนดค่าสำหรับแพ็กเกจราคาเพื่อดูรายการที่พักทั้งหมดของแพ็กเกจราคา
ตัวอย่างต่อไปนี้เป็นการสร้างแผนส่วนแบ่งรายได้ที่มีรูปแบบการแชร์ที่ยืดหยุ่น ทั้งนี้ ระบุช่วงรายได้ 2 ช่วง แถบแรกครอบคลุมรายได้จากธุรกรรมมากกว่าสูงสุด 1,000 ดอลลาร์สหรัฐ (USD $) แถบที่สองครอบคลุมรายได้จากธุรกรรมมากกว่า 1,000 ดอลลาร์สหรัฐ รายได้ เปอร์เซ็นต์ส่วนแบ่งคือ 80.5555% สำหรับช่วงรายได้แรก และ 90.5% สำหรับช่วงรายได้ที่สอง ส่วนแบ่งรายได้จะอิงตามราคาสุทธิของธุรกรรม เกณฑ์สำหรับการรวมคือ 1 เดือน ระยะเวลาของสัญญาเริ่มมีผลในวันที่ 15 กันยายน 2013 และครบกำหนดชำระเงินภายใน 30 วัน (รายได้ รายละเอียดที่เกี่ยวข้องกับการแบ่งปัน)
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flexible share plan",
"developer":null,
"developerCategory":null,
"advance": "true",
"currency": {
"id": "usd"
},
"description": "Flexible share plan",
"displayName": "Flexible share plan",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id": "usd"
},
"duration": "1",
"durationType": "MONTH",
"meteringType": "VOLUME",
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"ratePlanRates" : [ {
"endUnit" : 1000,
"revshare" : 80.5555,
"startUnit" : 0,
"type" : "REVSHARE"
}, {
"revshare" : 90.5,
"startUnit" : 1000,
"type" : "REVSHARE"
} ],
"ratingParameter" : "VOLUME",
"revenueType" : "NET",
"type" : "REVSHARE"
} ],
"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
คำตอบควรมีลักษณะดังนี้ (แสดงเพียงบางส่วนของคำตอบ)
{ "advance" : true, "currency" : { "id" : "usd", "name" : "USD", "organization" : { ... }, ... }, "description" : "Flexible share plan", "displayName" : "Flexible share plan", "earlyTerminationFee" : 10, "frequencyDuration" : 30, "frequencyDurationType" : "DAY", "id" : "location_flexible_share_plan", "monetizationPackage" : { "description" : "Location", "displayName" : "Location", "id" : "location", "name" : "Location", "organization" : { ... }, "product" : [ { "customAtt1Name" : "user", "description" : "Location", "displayName" : "Location", "id" : "location", "name" : "location", "organization" : { ... }, "status" : "CREATED" } ], "status" : "CREATED" }, "name" : "Flexible share plan", "organization" : { ... }, "paymentDueDays" : "30", "prorate" : false, "published" : false, "ratePlanDetails" : [ { "aggregateFreemiumCounters" : true, "aggregateStandardCounters" : true, "currency" : { "id" : "usd", "name" : "USD", … "organization" : { ... }, ... }, "duration" : 1, "durationType" : "MONTH", "id" : "ba3353e3-14f4-4bc5-a9f1-c723fd34131c", "meteringType" : "VOLUME", "organization" : { ... }, "paymentDueDays" : "30", "ratePlanRates" : [ { "endUnit" : 1000, "id" : "5f13a51e-2250-4383-9aad-35e9a008ab40", "revshare" : 80.5555, "startUnit" : 0, "type" : "REVSHARE" }, { "id" : "d4196250-4ecc-480e-a7ed-dfab8e1c92ed", "revshare" : 90.5, "startUnit" : 1000, "type" : "REVSHARE" } ], "ratingParameter" : "VOLUME", "revenueType" : "NET", "type" : "REVSHARE" } ], "recurringFee" : 10, "recurringStartUnit" : 1, "recurringType" : "CALENDAR", "setUpFee" : 10, "startDate" : "2013-09-15 00:00:00", "type" : "STANDARD" }