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

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

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

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

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

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

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

פרטים על השלב במדיניות VerifyAPIKey, כולל משתני תהליך המונטיזציה

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

משתנה Flow הגדרה
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 בתהליך הבקשה.

פרטים על שלב המדיניות MonetizationLimitsCheck, כולל משתני זרימת המונטיזציה

אם מפתח האפליקציה או AppGroup רכשו מינוי למוצר ה-API, משתני הזרימה הבאים יאוכלסו:

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

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

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

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

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

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

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

שלב ההפעלה של המדיניות DataCapture עם משתני תהליך המונטיזציה

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

משתנה Flow תיאור
mint.mintng_currency

המטבע שבו מחושבות ההכנסות.

משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה currency.
mint.mintng_price

ההכנסה שמשמשת לחישוב החלק של מפתח האפליקציה או קבוצת האפליקציות.

משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה revShareGrossPrice.
mint.mintng_price_multiplier

גורם (כופל) שלפיו מכפילים את העלות לכל עסקה.

משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה perUnitPriceMultiplier.
mint.mintng_tx_success

המדיניות הזו קובעת אם העסקה מניבה רווחים.

משתנה ה-Flow הזה מקבל את הערך של משתנה המונטיזציה transactionSuccess.

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

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

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

פרטים על שלב ההרצה של ה-Proxy, כולל משתני תהליך המונטיזציה

אם ההרצה של proxy ל-API שמניב הכנסות מצליחה, משתני ה-Flow הבאים מאוכלסים:

משתנה Flow תיאור
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 מציין אם המונטיזציה של העסקה הצליחה.

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