אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
תוכנית פרימיום מאפשרת למפתחי אפליקציות להשתמש בתוכנית התמחור בחינם למשך תקופה שמבוססת על שימוש, משך זמן או שניהם. אפשר להגדיר תוכנית פרימיום לכל סוג של תוכנית תמחור, למעט תוכנית תמחור עם התראות שניתנות להתאמה.
הגדרת תוכנית פרימיום באמצעות ממשק המשתמש
מגדירים תוכנית פרימיום לתוכנית תמחור, כמו שמתואר בהמשך.
Edge
כדי להגדיר תוכנית פרימיום באמצעות ממשק המשתמש של Edge כשיוצרים או עורכים תוכנית תמחור, בוחרים סוג כלשהו של תוכנית תמחור (חוץ מ'התראה על שינוי מחיר'), ובקטע Freemium מפעילים את תוכנית הפרימיום ובוחרים באחת מהאפשרויות הבאות:
- מבצע לפי שימוש (מספר קריאות ל-API)
- מבצע לפי תקופה
- מה שיקרה קודם
בהתאם לבחירה, מגדירים אחד מהשדות הבאים או את שניהם:
| שדה | תיאור |
|---|---|
| שימוש בגרסת Freemium (קריאות ל-API) | הערה: חובה אם בוחרים באפשרות מבצע לפי כמות או המוקדם מביניהם.
מספר העסקאות (או הערך שקשור למאפיין מותאם אישית שתועד במדיניות תיעוד העסקאות) שעליהן לא מחויבים מפתחים. הנפח נמדד עבור מוצר ה-API. |
| תקופה של גרסה חינמית מוגבלת | הערה: חובה אם בוחרים באפשרות מבצע לפי משך זמן או המוקדם מביניהם.
מרווח הזמן שבמהלכו המפתחים לא מחויבים. לדוגמה, 30 ימים. מציינים את המספר ואת היחידה (יום, שבוע או חודש). |
Classic Edge (ענן פרטי)
כדי להגדיר תוכנית פרימיום באמצעות ממשק המשתמש הקלאסי של Edge:
- בוחרים בכרטיסייה 'Freemium'.
- הזן את המידע הבא:
שדה תיאור חבילת פרימיום? משך תקופת הניסיון בחינם. בוחרים באחד מלחצני האפשרויות הבאים:
- לפי כמות. התקופה החינמית מבוססת על כמות שצוינה בשדה Volume (נפח).
- לפי משך הזמן. תקופת הניסיון בחינם מבוססת על מרווח זמן שצוין בשדה Freemium Duration (משך תקופת הניסיון בחינם).
- המוקדם מביניהם. תקופת השימוש בחינם מסתיימת כשמגיעים לכמות בשדה Volume או למרווח הזמן בשדה Freemium Duration, לפי מה שקורה קודם.
- לא. זה לא מינוי Freemium. זוהי אפשרות ברירת המחדל.
נפח Freemium נפח העסקאות (או נפח שקשור למאפיין מותאם אישית שתועד במדיניות תיעוד העסקאות) שעליו מחויבים המפתחים. הנפח נמדד בכל המוצרים בחבילת ה-API. מזינים מספר נפח, למשל 5,000. כלומר, כשהמפתחים מתחילים את התוכנית, הם לא מחויבים על 5,000 העסקאות הראשונות (או על 5,000 השימושים הראשונים בפריט שקשור למאפיין מותאם אישית). השדה הזה מופעל רק אם בוחרים באפשרות 'לפי כמות' או 'המוקדם מביניהם' בשדה 'חבילת פרימיום?'.
משך השימוש בגרסת Freemium מרווח הזמן שבמהלכו המפתחים לא מחויבים. מזינים מספר ובוחרים תקופת זמן, למשל חודש אחד. המשמעות היא שהמפתחים לא מחויבים במשך חודש אחד מתאריך ההתחלה של התוכנית שנרכשה. השדה הזה מופעל רק אם בוחרים באפשרות 'לפי משך הזמן' או באפשרות 'המוקדם מביניהם' בשדה 'חבילת פרימיום?'.
הגדרת תוכנית פרימיום לתוכנית תמחור באמצעות ה-API
אפשר להוסיף תוכנית פרימיום כשיוצרים או מעדכנים את תוכנית התמחור. מציינים את מאפייני הפרימיום בגוף הבקשה של הקריאה.
לדוגמה, הבקשה הבאה יוצרת תוכנית מחירים רגילה עם תקופת פרימיום של 30 יום. (ההדגשה היא על המפרטים שקשורים ל-freemium).
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Simple rate plan",
"currency": {
"id" : "usd"
},
"description": "Simple rate plan",
"displayName" : "Simple rate plan",
"freemiumDuration": "30",
"freemiumDurationType": "DAY",
"monetizationPackage": {
"id": "location_package"
},
"organization": {
"id": "{org_name}
},
"published": "true",
"ratePlanDetails": [
{
…
}
],
"startDate": "2013-09-15",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location_package/rate-plans" \
-u email:password
כדי לציין כמות שמבוססת על מודל פרימיום (למשל, מספר העסקאות שכוללות את חבילת ה-API או הנפח שקשור למאפיין מותאם אישית שמתועד במדיניות תיעוד העסקאות), צריך לציין אותה כמספר יחידות פרימיום. לדוגמה, בהקצאת המאפיין הבאה מצוין שהמודל העסקי של פרימיום מבוסס על 5, 000 יחידות פרימיום:
"freemiumUnit": "5000"
רשימה מלאה של אפשרויות התוכנית מופיעה במאמר הגדרות של תוכניות תמחור.