הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של
Apigee Edge
כדי לנפות באגים במונטיזציה, משתמשים בכלי Debug כמו שמתואר בקטעים הבאים.
ניפוי באגים בשלב של מדיניות האימות
התכונה 'מונטיזציה ב-Apigee' משתמשת במדיניות VerifyAPIKey או VerifyAccessToken כדי לקבוע אם בקשה נכנסת מתאימה למונטיזציה, על ידי בדיקה של תוכנית התמחור הפעילה שפורסמה. מידע נוסף על הוספת המדיניות זמין במאמר בנושא הוספת מדיניות אימות.
לדוגמה, בתמונה הבאה מוצגים הפרטים של שלב המדיניות VerifyAPIKey בתהליך הבקשה.
אחרי אימות המשתמש, המדיניות VerifyAPIKey בודקת את כל התוכניות שפורסמו כדי לקבוע איזו מהן פעילה, אם בכלל, על סמך זמני ההפעלה והתפוגה שלהן. אם נמצאה תוכנית מחירים פעילה שפורסמה, משתני הזרימה הבאים יאוכלסו:
| משתנה בתהליך | הגדרה |
|---|---|
mint.mintng_is_apiproduct_monetized |
true אם נמצאה תוכנית מחירים פעילה שפורסמה. |
mint.mintng_rate_plan_id |
מזהה תוכנית התמחור. |
mint.rateplan_end_time_ms |
תאריך התפוגה של תוכנית התמחור. לדוגמה: 1619433556408 |
mint.rateplan_start_time_ms |
שעת ההפעלה של תוכנית התמחור. לדוגמה: 1618433956209 |
אם לא נמצאה תוכנית מחירים פעילה שפורסמה, משתנה הזרימה mint.mintng_is_apiproduct_monetized מוגדר לערך false ומשתני הזרימה הנוספים לא מאוכלסים.
מידע נוסף זמין במאמר בנושא משתני זרימה של mint.
ניפוי באגים בשלב המדיניות MonetizationLimitsCheck
המונטיזציה ב-Apigee משתמשת במדיניות MonetizationLimitsCheck כדי לאכוף מינויים של מפתחי אפליקציות ושל AppGroup למוצר ה-API. מידע נוסף על הוספת המדיניות זמין במאמר החלת מינויים על מוצרי API.
לדוגמה, בתמונה הבאה מוצגים הפרטים של שלב המדיניות MonetizationLimitsCheck בתהליך הבקשה.
אם מפתח האפליקציה או AppGroup רכשו מינוי למוצר ה-API, משתני הזרימה הבאים מאוכלסים:
| משתנה בתהליך | תיאור |
|---|---|
mint.limitscheck.is_request_blocked |
true לבקשות חסומות. |
mint.limitscheck.is_subscription_found |
true אם נמצא מינוי ל-API. |
mint.limitscheck_purchased_product_name |
השם של מוצר ה-API שנרכש. לדוגמה: MyProduct |
mint.limitscheck.status_message |
הודעת סטטוס. לדוגמה: limits_check_success |
mint.prepaid_developer_balance |
היתרה הנוכחית בארנק של חשבון התשלום מראש של מפתח האפליקציה או של קבוצת האפליקציות שמשויך למטבע של תוכנית התמחור. |
mint.prepaid_developer_currency |
המטבע של היתרה שזמינה במשתנה mint.prepaid_developer_balance. |
mint.subscription_end_time_ms |
שעת הסיום של המינוי למוצר ה-API. |
mint.subscription_start_time_ms |
שעת ההתחלה של המינוי למוצר ה-API. לדוגמה: 1618433956209 |
אם מפתח האפליקציה או AppGroup לא רכשו מינוי למוצר ה-API:
- המשתנה של התהליך
mint.limitscheck_is_subscription_foundמוגדר ל-false - הערך של
mint.limitscheck.is_request_blockedהואtrue - לא מתבצעת אכלוס של משתני זרימה אחרים.
מידע נוסף זמין במאמר בנושא משתני זרימה של mint.
ניפוי באגים בשלב של מדיניות המכסות
ב-Apigee monetization נעשה שימוש במדיניות המכסות כדי לאכוף את המכסות שהוגדרו ברמת מוצר ה-API. מכסות מגדירות את מספר הבקשות שמותר לשלוח למוצר API במהלך פרק זמן מסוים. מידע נוסף על הוספת המדיניות זמין במאמר אכיפת מכסות מונטיזציה בשרתי proxy של API.
לדוגמה, בתמונה הבאה מוצגים הפרטים של שלב מדיניות המכסה בתהליך הבקשה, שבו חרגתם מהמכסה.
בדוגמה הזו, חרגנו מהמכסה, קוד הסטטוס 429 Too Many Requests HTTP מוחזר, והמשתנים של זרימת ratelimit.* flow מאוכלסים כדי לספק פרטים נוספים על חריגת המכסה. תיאור של ratelimit.* מופיע במאמר משתני זרימה של מדיניות מכסת משאבים.
ניפוי באגים בשלב המדיניות DataCapture
Apigee משתמש במשתני המונטיזציה שנלכדים על ידי מדיניות DataCapture לצורך דירוג, חישוב של חלוקת ההכנסות וניתוח. מידע נוסף על תיעוד משתני המונטיזציה במדיניות זמין במאמר תיעוד נתוני מונטיזציה.
לדוגמה, בתמונה הבאה מוצגים הפרטים של שלב ההפעלה של מדיניות DataCapture בתהליך התגובה.
אם לא מופיעות שגיאות בזמן תיעוד משתני המונטיזציה, משתני הזרימה הבאים מאוכלסים עבור עסקה:
| משתנה בתהליך | תיאור |
|---|---|
mint.mintng_currency |
המטבע שבו מחושבות ההכנסות. משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה |
mint.mintng_price |
ההכנסה שמשמשת לחישוב החלק של מפתח האפליקציה או של קבוצת האפליקציות. משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה |
mint.mintng_price_multiplier |
פקטור (מכפיל) שבו מכפילים את העלות לכל עסקה. משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה |
mint.mintng_tx_success |
המאפיין מציין אם העסקה מניבה רווחים. משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה |
ניפוי באגים בשלב הביצוע של proxy ל-API עם מונטיזציה
אחרי ההרצה המוצלחת של proxy ל-API שמוניטיזציה מופעלת בו, קבוצה של משתני זרימה מאוכלסת במידע על העמלות והתעריפים שנגבים על בסיס צריכה.
לדוגמה, בתמונה הבאה מוצגים הפרטים של השלב Proxy Execution בתהליך PostClient שבו המשתנים מאוכלסים.
אם ההרצה של proxy ל-API שמניב הכנסות מצליחה, משתני הזרימה הבאים מאוכלסים:
| משתנה בתהליך | תיאור |
|---|---|
message.status.code |
קוד הסטטוס של ה-HTTP של הודעת התגובה מהיעד.
אם יש מדיניות בתגובה, הערך של המשתנה הזה מוחלף על ידי קוד הסטטוס שמוחזר על ידי המדיניות. |
mint.limitscheck.is_request_blocked |
סימון שמציין אם בקשת ה-API חסומה. |
mint.mintng_consumption_pricing_rates |
עמלות מבוססות-צריכה שמוגדרות בתוכנית התמחור. |
mint.mintng_consumption_pricing_type |
סוג התמחור מבוסס-הצריכה מוגדר בתוכנית התמחור. לדוגמה: FIXED_PER_UNIT |
mint.mintng_dev_share |
ההכנסות שיש לשתף עם מפתח האפליקציה או עם AppGroup. |
mint.mintng_price_multiplier |
גורם (מכפיל) שנרשם ממדיניות DataCapture. העלות לכל עסקה מוכפלת בפקטור הזה. |
mint.mintng_rate |
התעריף שחויב עבור הקריאה ל-API. |
mint.mintng_rate_before_multipliers |
התעריף שבו מחויבת הקריאה ל-API ללא החישוב של perUnitPriceMultiplier. |
mint.mintng_revenue_share_rates |
שיעורי חלוקת ההכנסות שמוגדרים בתוכנית התעריפים. |
mint.mintng_revenue_share_type |
סוג חלוקת ההכנסות שמוגדר בתוכנית התמחור. |
mint.prepaid_updated_developer_usage |
השימוש הנוכחי של מפתח האפליקציה או של קבוצת האפליקציות שמשלמים עליהם מראש. |
mint.status |
הסטטוס של השיחה שמניבה הכנסות. השדה הזה מאוכלס רק אם יש שגיאה. |
mint.status_code |
קוד סטטוס של HTTP של השיחה שמניבה הכנסות. הערך מאוכלס רק אם יש שגיאה. |
mint.tx_success_result |
מציין אם המונטיזציה של העסקה בוצעה בהצלחה. |
תיאור מפורט של כל המשתנים זמין במאמר משתני תהליך יצירת האסימון.