ניפוי באגים במונטיזציה באמצעות הכלי לניפוי באגים

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

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

ניפוי באגים בשלב של מדיניות האימות

ב-Apigee monetization נעשה שימוש במדיניות 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 אין השפעה אם לא נמצאה תוכנית תמחור פעילה שפורסמה, והמשתנה mint.mintng_is_apiproduct_monetized של Flow מוגדר ל-false.

לדוגמה, בתמונה הבאה מוצגים הפרטים של שלב המדיניות 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.

הערה: למדיניות MonetizationLimitsCheck אין השפעה אם לא נמצאה תוכנית תמחור פעילה שפורסמה, והמשתנה mint.mintng_is_apiproduct_monetized של Flow מוגדר ל-false.

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

בדוגמה הזו, חרגנו מהמכסה, קוד הסטטוס 429 Too Many Requests‏ HTTP מוחזר, והמשתנים של זרימת ratelimit.* flow מאוכלסים כדי לספק פרטים נוספים על החריגה מהמכסה. תיאור של ratelimit.* מופיע במאמר משתני זרימה של מדיניות מכסת משאבים.

ניפוי באגים בשלב המדיניות DataCapture

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

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

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

משתנה זרימה	תיאור
mint.mintng_currency	המטבע שבו מחושבת ההכנסה. משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה currency.
mint.mintng_price	ההכנסה שמשמשת לחישוב החלק של מפתח האפליקציה או של קבוצת האפליקציות. משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה revShareGrossPrice.
mint.mintng_price_multiplier	פקטור (מכפיל) שבו מכפילים את העלות לכל עסקה. משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה perUnitPriceMultiplier.
mint.mintng_tx_success	המאפיין הזה מציין אם העסקה מניבה רווחים. משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה transactionSuccess.

ניפוי באגים בשלב הביצוע של ה-proxy ל-API עם מונטיזציה

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

לדוגמה, בתמונה הבאה מוצגים הפרטים של השלב Proxy Execution (הפעלת שרת proxy) בתהליך 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	השדה מציין אם המונטיזציה של העסקה הצליחה.

תיאור מפורט של כל המשתנים זמין במאמר משתני תהליך יצירת האסימון.