שלבים להגדרת מונטיזציה

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

לפני שמתחילים

לפני שמתחילים להשתמש במונטיזציה בארגון Apigee, צריך לבצע את המשימות המוקדמות הבאות:

  • יוצרים חשבון Apigee Edge, כפי שמתואר במאמר יצירת חשבון Apigee Edge.
  • מונטיזציה של רכישה. Edge לא כולל בהתחלה את ממשק ה-API למונטיזציה או משלב את המונטיזציה בממשק המשתמש של הניהול. כדי לשלב את ממשק ה-API למונטיזציה ורכיבי ממשק המשתמש של המונטיזציה ב-Edge של הארגון שלך ב-Apigee, צריך לרכוש את תכונת המונטיזציה.

אחרי שרוכשים מונטיזציה, צריך לבצע את המשימות הבאות:

הגדרה ראשונית באמצעות Apigee

צריך לעבוד עם צוות התצורה של Apigee Edge כדי להשלים את ההגדרה הראשונית של המונטיזציה. על סמך המשוב שלכם, צוות ההגדרות יגדיר את ההגדרות הבאות:

  • אם הארגון שלכם הוא חברת טלקומוניקציה.
  • באיזה סוג חיוב ברצונך לתמוך במפתחים שרוכשים את תוכניות התעריפים שלך: תשלום מראש, תשלום לאחר השימוש (postpay) או שניהם. מידע נוסף מופיע בקטע חשבונות בתשלום מראש לעומת חשבונות בתשלום לאחר השימוש (postpay).
  • האם ברצונך נתונים מפורטים או תמציתיים שחולצו מהמונטיזציה אל מערכת הנהלת החשבונות שלך ופורמט הנתונים הנדרש.
  • כתובת אימייל מותאמת אישית לתשובות. להתראות באימייל בנושא מונטיזציה שנשלחות לחברות ולמפתחים, מוגדרת כתובת ברירת מחדל לכתובת noreply@apigee.com. עליך לבקש שם וכתובת של תשובה מותאמת אישית לארגון שלך.

צוות התצורה של Apigee מריץ סקריפט שמסנכרן את המונטיזציה עם הארגון שלך ועם כל המפתחים, האפליקציות ומוצרי ה-API שיצרת באמצעות Apigee Edge. יכול להיות שצוות התמיכה של Apigee יבקש מכם לסנכרן את הארגון שלכם בעתיד, כפי שמתואר במאמר סנכרון נתוני Apigee Edge עם מונטיזציה. אין לסנכרן נתוני מונטיזציה אלא אם צוין אחרת על ידי Apigee.

הגדרת מונטיזציה

הטבלה הבאה מסכמת את השלבים הנדרשים כדי להגדיר מונטיזציה לארגון Apigee שלך.
שלב תיאור
עריכת הפרופיל של הארגון כחלק מההגדרה הראשונית של המונטיזציה, צוות ההגדרה של Apigee Edge מגדיר את הפרופיל של הארגון שלכם.

כדי להוסיף או לעדכן מידע על הארגון, צריך לערוך את הפרופיל של הארגון. לדוגמה, יכול להיות שתצטרכו לעדכן את סוג החיוב, הגדרות המטבע או מודל המס.

ניהול המטבעות הנתמכים כחלק מההגדרה הראשונית של המונטיזציה, צוות ההגדרה של Apigee Edge מציין את המטבעות שנתמכים על ידי הארגון שלך ומגדיר את מטבע ברירת המחדל.

יש לך אפשרות לאחזר את המטבעות שנתמכים בארגון, ולהוסיף או למחוק מטבעות נתמכים (כדי לשקף את המטבעות שמשמשים את המפתח או את תוכנית התמחור והתשלומים).

הערה: תכונת המונטיזציה מפעילה באופן אוטומטי עבודה יומית שמקבלת את שער החליפין בדולר ארה"ב לכל מטבע נתמך. כברירת מחדל, המשימה פועלת מדי יום בשנייה אחרי חצות. מידע נוסף מופיע במאמר בנושא תזמון משימות מונטיזציה.
ציון תנאים והגבלות אופציונלי: אפשר להוסיף תנאים והגבלות לפרופיל הארגון לפני הפרסום של תוכניות תעריפים. אחרי שמפרסמים תוכנית תעריפים, הגרסה הנוכחית של התנאים וההגבלות מוצגת בפורטל המפתחים.

הערה: התנאים וההגבלות נמצאים מחוץ לפרופיל הארגון. בפרופיל הארגון, עליכם לציין את המיקום (כתובת ה-URL הציבורית) של התנאים וההגבלות. אפשר להוסיף כמה גרסאות של התנאים וההגבלות כדי לשקף את השינויים לאורך זמן.
אכיפה של מגבלות מונטיזציה כדי לאכוף את הגבלות המונטיזציה, צריך לצרף את המדיניות MonetizeLimitsCheck לשרתי proxy של API.

באופן ספציפי, המדיניות מופעלת בתנאים הבאים:

  • המפתח שניגש ל-Monetize API לא רשום לתוכנית התמחור והתשלומים או לא נרשם לתוכנית.
  • המפתח חרג מנפח העסקאות בתוכנית התמחור והתשלומים של המינוי.
  • הגעת ליתרת התשלום מראש בחשבון המפתח או למסגרת האשראי בתשלום לאחר השימוש (postpay).
הגדרת התראות ניתן להגדיר התראות כדי להודיע למפתחים או לספקי ה-API לגבי אירוע ספציפי, כמו תוכנית תעריפים שפורסמה לאחרונה.

ייצור הכנסות מממשקי ה-API

כאשר אתם מייצרים הכנסות מממשקי API, אתם אוספים מוצר API אחד או יותר בתוך חבילת מוצרים של API ומגדירים את תוכנית התעריפים המשויכת.

חבילת מוצרים של API לא תהיה גלויה למפתחים עד שתפרסמו תוכנית תמחור לחבילה (עם תאריך התחלה של התאריך הנוכחי או תאריך עתידי). מפתחים יכולים לרשום את האפליקציות שלהם לשימוש בחבילת מוצרים API רק על ידי רכישה של אחת מתוכניות התעריפים הקיימות כעת. אם חבילת מוצרים של API לא כוללת תוכנית תעריפים שפורסמה ופעילה כרגע, אין אפשרות לייצר הכנסות מהחבילה.

הטבלה הבאה מסכמת את השלבים הנדרשים כדי לייצר הכנסות מממשקי ה-API.

שלב תיאור
ניהול חבילות מוצרים של API

יצירת חבילות מוצרים של API כדי לקבץ את מוצרי ה-API.

הערה: בממשק המשתמש הקלאסי של Edge וב-API למונטיזציה, חבילות מוצרים נקראות חבילות API.

כדי להשתמש ב-API לניהול חבילות מוצרים של ממשק API:
הגדרת המדיניות בנושא תיעוד עסקאות

להגדיר את המדיניות של תיעוד העסקאות לכל אחד ממוצרי ה-API שלכם. המדיניות בנושא תיעוד עסקאות מגדירה מה תרצו לתעד ברשומות הטרנזקציות של מוצר API, כולל מאפיינים מותאמים אישית.

כדי להשתמש ב-API להגדרת מדיניות תיעוד העסקאות, עיינו במאמרים הבאים:
ניהול ופרסום של תוכניות תעריפים

יוצרים תוכנית תמחור ותשלומים כדי להגדיר את גישת המונטיזציה לממשקי ה-API. לדוגמה, אם אתם גובים תעריף קבוע או תעריף משתנה עבור השימוש ב-API.

כדי לנהל תוכניות תעריפים באמצעות ה-API:

רכישת תוכנית תעריפים שפורסמה רוכשים תוכנית תעריפים שפורסמה, מבטלים או מבטלים תוכנית תעריפים שנרכשה באמצעות ה-API.
הגדרת מונטיזציה בפורטל למפתחים עליך להגדיר את המונטיזציה בפורטל למפתחים כדי לתת למפתחים גישה בשירות עצמי למפתחים: מינויים לתוכנית התמחור, עיבוד תשלומים וחיוב אוטומטיים, דוחות, קטלוגים של מוצרים והגדרות נוספות שספציפיות למונטיזציה.

ניהול מונטיזציה

אחרי שמגדירים את המונטיזציה ומונטיזציה (מונטיזציה) ב-API, אפשר לבצע אחד או יותר מהשלבים שמסכמים בטבלה הבאה:

שלב תיאור
ניהול חברות ומפתחים ניהול החברות והמפתחים שמשתמשים בממשקי ה-API שלך. מפתח הוא ישות יחידה, שמזוהה באופן ייחודי לפי כתובת האימייל. חברה היא אוסף של מפתחים שמנוהלים כישות אחת.
יצירת דוחות יצירת דוחות לגבי יתרה ששולמה מראש, הכנסות ושונות. למפתחים ששולמו מראש, אפשר להתאים דוחות יתרה בתשלום מראש עם הפקדות בנק.
ביצוע התאמות חיוב לדוגמה, לבצע התאמות חיוב כדי לתקן פערים בנתונים.
הנפקת זיכויים אם נדרש, מנפיקים קרדיטים למפתחים. במקרה של מפתח ששולם מראש, הזיכוי מופיע כירידה בשימוש שמגדילות את יתרת התשלום מראש של המפתח מעתה ואילך. עבור מפתחים שמשלמים לאחר השימוש (postpay), הזיכוי מופיע בשורה נפרדת בחשבונית, כך שהחיוב בחשבונית מופחת.
ניהול יתרות של חשבונות בתשלום מראש יש לך אפשרות להציג את היתרה הנוכחית בחשבון ששולם מראש, ולטעון מחדש חשבונות בתשלום מראש או על ידי הגדרה של טעינה אוטומטית מחדש באמצעות ספק תשלום של צד שלישי.
ניהול יתרות של תשלום לאחר השימוש (postpay) באמצעות מסגרות אשראי כשמוסיפים מטבע נתמך לארגון, אפשר להגדיר מסגרת אשראי למפתח שמשלמים לאחר השימוש (postpay). מסגרת האשראי חלה על כל המפתחים שמשלמים לאחר השימוש (postpay) בארגון. בנוסף, ניתן להגדיר את מסגרת האשראי למפתח ספציפי שמשלמים לאחר השימוש (postpay). במקרה כזה, מסגרת האשראי מבטלת כל תקרה שהוגדרה למטבע עבור המפתח שצוין בלבד.
פרסום החזרים כספיים לפרסם החזרים כספיים למפתחים עבור עסקאות רכישה.
תזמון משימות למונטיזציה המונטיזציה מספקת מתזמן משימות וקבוצה של משימות שמתוזמנות מראש להפעלה בשעות שצוינו. ניהול לוח הזמנים של משימות המונטיזציה באמצעות ה-API.
הצגת הסטטוס של עסקאות הצגת הסטטוס של עסקאות שבוצעו במהלך טווח זמן מוגדר באמצעות ה-API.
סנכרון נתוני Apigee Edge עם מונטיזציה אם התבקשת לעשות זאת על ידי Apigee, עליך לסנכרן מחדש את הנתונים עם המונטיזציה כדי להבטיח שהנתונים מסונכרנים. ניתן לסנכרן את הנתונים הבאים: ארגון, מוצרי API, מפתחים ואפליקציות.
מחיקת נתוני מונטיזציה מהארגון כדי למחוק ארגון לבדיקה או למחוק ארגון, כדאי למחוק את נתוני המונטיזציה מהארגון.