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

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info

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

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

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

אחרי שתרכשו את האפשרות לייצר הכנסות, תצטרכו לבצע את הפעולות הבאות:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

במאמרים הבאים מוסבר איך מנהלים תוכניות תמחור באמצעות ה-API:

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

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

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

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