יצירת דוחות מונטיזציה

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

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

באמצעות התכונה דוחות בהתאמה אישית של Apigee, אתם יכולים ליצור דוחות כדי לראות את פרטי המונטיזציה של ממשקי ה-API שלכם. כדי ליצור את הדוחות, אפשר להשתמש בממשק המשתמש של Apigee, ב-stats API או ב-queries API, כמו שמתואר בקטעים הבאים:

מדדים ומאפיינים של מונטיזציה

‫Apigee מספק את המדדים והמאפיינים הבאים של מונטיזציה:

  • מדדים ומאפיינים של עסקאות באמצעות proxy ל-API
  • מדדים ומאפיינים של עסקאות בתשלום

מדדים ומאפיינים של עסקאות באמצעות proxy ל-API

בטבלאות הבאות מפורטים x_apigee_mintng_*המדדים והמאפיינים שזמינים לעסקאות באמצעות proxy ל-API:

  • מדדים
    שם בממשק המשתמש שם ב-API תיאור
    API price multiplier x_apigee_mintng_price_multiplier המכפיל שבו מכפילים את העלות לכל עסקה.
    חלקם של המפתחים בהכנסות x_apigee_mintng_dev_share החלק של מפתח האפליקציה או של קבוצת האפליקציות בהכנסות מעסקה.
    מחיר המונטיזציה x_apigee_mintng_price ההכנסה הכוללת מעסקה.
    שיעורי מונטיזציה x_apigee_mintng_rate התעריף שחויב על עסקה.
  • מאפיינים
    שם בממשק המשתמש שם ב-API תיאור
    מזהה תוכנית תמחור x_apigee_mintng_rate_plan_id

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

מדדים ומאפיינים של עסקאות בתשלום

בטבלאות הבאות מפורטים המדדים והמאפיינים שזמינים רק לטרנזקציות בתשלום:

  • מדדים
    שם בממשק המשתמש שם ב-API תיאור
    עמלות עמלות סכום העמלה.
  • מאפיינים
    שם בממשק המשתמש שם ב-API תיאור
    שם קבוצת האפליקציות app_group_name השם של קבוצת האפליקציות שעליה חלות העמלות, אם רלוונטי. למפתחי אפליקציות, השדה הזה ריק.
    סוג העמלה fees_type סוג העמלה: עמלת הקמה, עמלה חוזרת, טעינה מראש או החזר כספי. המאפיין הזה יהיה null כשמשתמשים בו עם מדד כלשהו מלבד fees.
    מועד יצירת העמלה ההגדרות האישיות נוצרו

    חותמת זמן של Unix שבה העמלה נוספה למפתח האפליקציה ולמוצר ה-API. המאפיין הזה הוא null כשמשתמשים בו עם מדד כלשהו מלבד fees.
    מטבע ההכנסות x_apigee_mintng_currency המטבע שבו מתבצע התשלום.
    כתובת האימייל של המפתח developer_email מפתח האפליקציה או AppGroup שיחויבו בעמלת ההגדרה, בעמלות חוזרות או בטעינה מראש.
    מזהה מפתח / מזהה קבוצת אפליקציות מפתח המזהה של מפתח האפליקציה או של קבוצת האפליקציות שרשומים ב-Apigee, שאליהם מתייחסות העמלות. אפשר להשתמש בערך הזה לחישובים לצורכי חיוב.
    מוצר API api_product מוצר API שתואם לתוכנית התמחור שעליה חל התשלום. הערך ריק עבור סוגים מסוימים של עמלות, כמו טעינה מראש.
    מזהה תוכנית תמחור x_apigee_mintng_rate_plan_id

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

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

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

תיאורים מפורטים של המדדים והמאפיינים האלה זמינים במאמר הפניה למדדים, למאפיינים ולמסננים ב-Analytics.

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

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

בדוגמה של כל אפליקציה למפתחים מוצגת העלות הכוללת של כל העסקאות מ-1-Apr-2021 to 15-Apr-2021. העלות מחושבת על בסיס תמחור לפי צריכה, כפי שהוגדר בתוכנית התמחור שלכם. שימו לב שבדוגמה הזו, המדד (x_apigee_mintng_rate) הוא שדה מונטיזציה, אבל המאפיין (developer_app) הוא שדה שאינו שדה מונטיזציה. לכן, בהתאם לדרישות שלכם, אתם יכולים ליצור דוחות עם שילוב של שדות שקשורים למונטיזציה ושדות שלא קשורים למונטיזציה.

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

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

ייצוא נתוני ניתוח של מונטיזציה

ב-Apigee, לא צריך לבצע פעולות נוספות כדי לייצא את נתוני הניתוח של המונטיזציה. אם אתם מייצאים נתוני ניתוח, מערכת Apigee מייצאת את שדות המונטיזציה הבאים יחד עם נתוני ניתוח רגילים. כשמייצאים יחד עסקאות שמבוססות על עמלות ועסקאות שמשתמשות ב-proxy ל-API, כל רשומה מיוצאת עם המדדים והמאפיינים המשותפים, והמדדים והמאפיינים האחרים (שלא קשורים) מוגדרים כ-NULL.
  • client_received_start_timestamp
  • period_end
  • period_start
  • x_apigee_mintng_currency
  • x_apigee_mintng_dev_share
  • x_apigee_mintng_price
  • x_apigee_mintng_price_multiplier
  • x_apigee_mintng_rate
  • x_apigee_mintng_rate_plan_id
  • x_apigee_mintng_tx_success