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

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

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

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

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

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

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

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

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

  • מדדים
    שם בממשק המשתמש שם ב-API תיאור
    מכפיל מחיר של API 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