กําหนดค่าแพ็กเกจส่วนแบ่งรายได้

คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

บทนำ

ในแพ็กเกจส่วนแบ่งรายได้ ผู้ให้บริการ API จะแบ่งรายได้จากธุรกรรมแต่ละรายการ (อิงตามราคารวมหรือราคาสุทธิของธุรกรรม) กับนักพัฒนาแอปตามเปอร์เซ็นต์ เมื่อสร้างแผนส่วนแบ่งรายได้ คุณต้องระบุรูปแบบการแบ่งรายได้ ซึ่งอาจเป็นแบบคงที่หรือแบบยืดหยุ่น และพื้นฐานการกำหนดราคา (เช่น ส่วนแบ่งรายได้จะอิงตามราคารวมหรือราคาสุทธิของธุรกรรม) คุณกำหนดราคารวมหรือราคาสุทธิสำหรับธุรกรรมเมื่อสร้างนโยบายการบันทึกธุรกรรม

ในรูปแบบการแบ่งรายได้แบบคงที่ คุณจะได้รับส่วนแบ่งรายได้จากธุรกรรมแต่ละรายการในเปอร์เซ็นต์คงที่ (อิงตามราคารวมหรือราคาสุทธิของธุรกรรม) ในรูปแบบการแบ่งรายได้แบบยืดหยุ่น คุณจะได้รับส่วนแบ่งรายได้จากนักพัฒนาแอปในเปอร์เซ็นต์ที่เปลี่ยนแปลงได้ ส่วนแบ่งรายได้จะขึ้นอยู่กับรายได้ที่เกิดขึ้นในช่วงระยะเวลาหนึ่งๆ เปอร์เซ็นต์ที่ใช้ในการคำนวณส่วนแบ่งรายได้อาจแตกต่างกันไปตามจำนวนรายได้ที่เกิดจากธุรกรรม

การระบุรายละเอียดแผนส่วนแบ่งรายได้โดยใช้ UI

กำหนดค่าแพ็กเกจส่วนแบ่งรายได้ตามที่อธิบายไว้ด้านล่าง

ระบุรายละเอียดของแผนส่วนแบ่งรายได้โดยใช้ 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 และหน่วยสิ้นสุดเป็น 1, 000 กลุ่มรายได้จะครอบคลุมรายได้จากธุรกรรมที่มากกว่า 0 แต่ไม่เกิน 1, 000 ในสกุลเงินที่ระบุ หากสกุลเงินคือดอลลาร์สหรัฐ พื้นฐานการรวมข้อมูลคือ 1 เดือน และเปอร์เซ็นต์ของกลุ่มรายได้คือ 80.5555% ส่วนแบ่งรายได้ของธุรกรรมที่สร้างรายได้ไม่เกิน $1,000 ใน 1 เดือนจะเป็น 80.5555% ของราคาธุรกรรม

  หากคุณไม่ได้ระบุหน่วยสิ้นสุดสำหรับกลุ่มรายได้สุดท้าย ระบบจะใช้เปอร์เซ็นต์ส่วนแบ่งของกลุ่มนั้นกับธุรกรรมทั้งหมดหลังจากที่รายได้รวมสูงกว่าหน่วยเริ่มต้นของกลุ่มนั้น ตัวอย่างเช่น หากหน่วยเริ่มต้นของกลุ่มสุดท้ายคือ 1,000 (สมมติเป็นดอลลาร์สหรัฐ) และคุณไม่ได้ระบุหน่วยสิ้นสุดของกลุ่มนั้น ระบบจะใช้เปอร์เซ็นต์รายได้ของกลุ่มกับธุรกรรมทั้งหมดที่มีรายได้มากกว่า $1, 000 ในช่วงระยะเวลารวม

ดูรายการพร็อพเพอร์ตี้แพ็กเกจราคาทั้งหมดได้ที่พร็อพเพอร์ตี้การกําหนดค่าสําหรับแพ็กเกจราคา

ตัวอย่างเช่น คำสั่งต่อไปนี้จะสร้างแผนส่วนแบ่งรายได้ที่มีรูปแบบการแบ่งที่ยืดหยุ่น โดยระบุกลุ่มรายได้ 2 กลุ่ม แถบแรกครอบคลุมรายได้จากธุรกรรมมากกว่า 1,000 ดอลลาร์สหรัฐ ส่วนกลุ่มที่ 2 จะครอบคลุมรายได้จากธุรกรรมมากกว่า 1,000 ดอลลาร์สหรัฐ เปอร์เซ็นต์ส่วนแบ่งรายได้คือ 80.5555% สำหรับกลุ่มรายได้แรก และ 90.5% สำหรับกลุ่มรายได้ที่ 2 ส่วนแบ่งรายได้จะอิงตามราคาสุทธิของธุรกรรม พื้นฐานการรวมข้อมูลคือ 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"
}