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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

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

החשבון של המפתח מושעה

תיאור הבעיה

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

הודעות שגיאה

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

אבחון

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

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

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

   2. אם אתם משתמשים ב-Private Cloud, אתם צריכים להשתמש ב-API הבא:

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

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

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

רזולוציה

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

תסמינים

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

• הפונקציונליות של Webhooks לא עובדת
• אי אפשר ליצור webhooks
• ההתראות של Webhook לא מופעלות
• בדוחות המונטיזציה לא מוצגות עסקאות. לדוגמה, נתוני Analytics מצביעים על כך שהמפתח השלים הרבה עסקאות בתקופה מסוימת, אבל בדוחות המונטיזציה לא מופיעות אף אחת מהעסקאות האלה.
• עסקאות לא מתועדות

הודעות שגיאה

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

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

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

אבחון הסיבה

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

   הצגת הסטטוס של עסקאות

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

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

• Monetization Limits Check Policy Not Attached To API Proxy
• ‫APIProduct is not Monetized
• Transaction Recording Policy incorrectly defined
• המפתח לא רכש תוכנית תמחור

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

המדיניות 'בדיקת מגבלות מונטיזציה' לא נמצאת בשימוש ב-API Proxy

אבחון

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. אם אתם משתמשים ב-Private Cloud, אתם צריכים להשתמש ב-API הבא:

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

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

רזולוציה

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

1. הגדרת מדיניות להקלטת עסקאות.

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

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

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

אבחון

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

   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. זו דוגמה למעקב בממשק המשתמש שבו רואים שהמשתנים של תהליך הטבעת האסימון מוגדרים בצורה נכונה.

   

5. אם מופיעה שגיאה במשתנה mint.tx.status, המשמעות היא שמדיניות התיעוד של העסקאות מוגדרת בצורה שגויה.

רזולוציה

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

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

אבחון

1. כדי לוודא אילו תוכניות תמחור נרכשו על ידי המפתח, משתמשים בקריאה הבאה ל-Management 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. אם אתם משתמשים ב-Private Cloud, אתם יכולים להשתמש ב-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.