פתרון בעיות הקשורות למונטיזציה

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

הנושא הזה מספק מידע והדרכה לפתרון בעיות שקשורות למונטיזציה, או בעיות.

המפתח הושעה

תיאור הבעיה

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

הודעות שגיאה

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

אבחון

כדי לקבוע את הסיבה להשעיית המפתח, מבצעים את הפעולות הבאות שלבים:

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

      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
      

   2. אם אתם משתמשים בענן פרטי, אתם יכולים להשתמש ב-API הבא:

      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
      

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

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

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

רזולוציה

שגיאה	השלבים לפתרון הבעיה
INSUFFICIENT_FUNDS	המפתח צריך לוודא שהיתרה בחשבון מספיקה, או אשראי זמין כדי להשלים עסקאות נוספות כלשהן.
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	כדי לקבל את תוכנית התעריפים למפתחים, צריך לבצע את הקריאות הבאות ל-API ופרטי העסקה, בהתאמה: מריצים את הקריאה הבאה ל-API כדי לקבל את תאריכי ההתחלה והסיום של תוכניות התמחור והתשלומים שהמפתח רכש: http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans מריצים את הקריאה הבאה ל-API כדי לקבל את מספר עסקאות שבוצעו על ידי המפתח: http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D בממשק המשתמש של Edge ניתן גם לבדוק את מספר השיחות למפתחים מותר לבצע על ידי בחירה של: חבילות > PackageName > RatePlanName (שם התוכנית) > מחירון לדוגמה, אם שם החבילה הוא Pro Package, והוא הוא תוכנית חינמית, אז הנתיב יהיה: חבילות > חבילה מקצועית > תוכנית חינמית > מחירון
NO_CURRENT_PUBLISHABLE_ENTITY	המפתח צריך לרכוש תוכנית תמחור ותשלומים כדי לבצע קריאות ל-API.

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

תיאורי בעיות

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

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

הודעות שגיאה

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

סיבות אפשריות

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

אבחון הגורם

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

   צפייה בסטטוס העסקאות

2. אם לא מופיעות עסקאות בסטטוס SUCCESS. תוך פרק הזמן שצוין, לא תתבצע מונטיזציה של העסקאות.

הסיבות הטיפוסיות לכך שעסקאות לא מייצרים הכנסות:

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

בקטעים הבאים מתואר איך לאבחן כל בעיה ולפתור אותה.

המדיניות בנושא בדיקת הגבלות מונטיזציה שלא נעשה בה שימוש בשרת proxy ל-API

אבחון

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

רזולוציה

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

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

לא הופעלה מונטיזציה במוצר API

אבחון

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

      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
      

   2. אם אתם משתמשים בענן פרטי, אתם יכולים להשתמש ב-API הבא:

      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
      

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

רזולוציה

כדי לייצר הכנסות ממוצר API, צריך לבצע את השלבים הבאים:

1. הגדרת מדיניות לתיעוד טרנזקציות.

2. צריך לוודא שלמוצר ה-API יש תוכנית תעריפים פעילה.

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

המדיניות בנושא תיעוד עסקאות הוגדרה באופן שגוי

אבחון

1. הפעלת מעקב אחר ממשק המשתמש עבור שרת ה-proxy ל-API עם המדיניות בנושא בדיקת הגבלות מונטיזציה מצורף.
2. בוחרים בקשת API מסוימת ממעקב ממשק המשתמש.
3. בוחרים את התהליך AX ב-Analytics ובודקים אם המונטיזציה הבאה (נעה) משתני הזרימה כוללים את הערכים הנכונים:

   mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
   mint.tx.app_id - Application id of API product.
   mint.tx.prod_id - API product id.
   

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

   

5. אם הבחנתם בשגיאה במשתנה mint.tx.status, הוא מציין שמדיניות תיעוד הטרנזקציות שגויה מוגדר.

רזולוציה

1. מוודאים שכל השלבים המתועדים ב יש לוודא שיצירת מדיניות בנושא תיעוד עסקאות בוצעה כמו שצריך במהלך יצירת המדיניות בנושא תיעוד טרנזקציות.
2. הערך המרכזי הוא 'הקריטריונים להצלחת העסקה' שמוגדרים מדיניות תיעוד הטרנזקציות. ראו דוגמאות להגדרת קריטריונים להצלחה של עסקאות במדיניות תיעוד עסקאות

מפתחים לא רכשת תוכנית תעריפים

אבחון

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

      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
      

   2. אם אתם משתמשים בענן פרטי, אתם יכולים להשתמש ב-API הבא:

      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
      

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

רזולוציה

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

אם הבעיה נמשכת, צריך לפנות לתמיכה של Apigee Edge.