איסוף נתוני מונטיזציה

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

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

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

משתני מונטיזציה

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

בטבלה הבאה מתוארים משתני המונטיזציה שזמינים ב-Apigee:

משתנה מונטיזציה סוג נתונים תיאור
מטבע String המטבע שבו מחושבת ההכנסה מעסקה.
perUnitPriceMultiplier Float מציינים את המקדם (המכפיל) שבו מכפילים את העלות לכל עסקה. העלות לכל עסקה מצוינת בתמחור של העמלות שמבוססות על צריכה בתוכנית התמחור. הכפל מתבצע בעסקה רק אם היא מתאימה למונטיזציה. אפשר לייצר הכנסות מטרנזקציה אם מתקיים אחד מהתנאים הבאים:
  • אם המשתנה transactionSuccess הוא true.
  • אם המשתנה transactionSuccess הוא NULL והמשתנה message.status.code הוא 2xx (הצלחה).
revShareGrossPrice Float

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

    • אם לא תציינו את המשתנה הזה, המונטיזציה של העסקאות תתבסס על הערך של קוד סטטוס ה-HTTP שזמין במשתנה message.status.code. אם קוד הסטטוס של התגובה הוא NULL או >=300, לא מתבצעת מונטיזציה של העסקה. בכל קוד סטטוס אחר, מתבצעת מונטיזציה של העסקה.

דוגמאות להקצאת ערכים

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

מטבע

בדוגמה הבאה מוקצה הערך של רכיב ה-JSON‏ booking[0].currency בתגובה למשתנה currency:

<Capture>
  <Collect>
    <Source>response</Source>
    <JSONPayload>
      <JSONPath>booking[0].currency</JSONPath>
    </JSONPayload>
  </Collect>
  <DataCollector scope="monetization">currency</DataCollector>
</Capture>

perUnitPriceMultiplier

בדוגמה הבאה, הערך של רכיב ה-JSON‏ booking[0].factor בתגובה מוקצה למשתנה perUnitPriceMultiplier:

<Capture>
  <Collect>
    <Source>response</Source>
    <JSONPayload>
      <JSONPath>booking[0].factor</JSONPath>
    </JSONPayload>
  </Collect>
  <DataCollector scope="monetization">perUnitPriceMultiplier</DataCollector>
</Capture>

revShareGrossPrice

בדוגמה הבאה, הערך של המשתנה minPrice בכותרת התגובה מוקצה למשתנה revShareGrossPrice:

<Capture>
  <Collect>
    <Source>response</Source>
    <Header name="minPrice">
      <Pattern ignoreCase="true">{$}</Pattern>
    </Header>
  </Collect>
  <DataCollector scope="monetization">revShareGrossPrice</DataCollector>
</Capture>

transactionSuccess

בדוגמה הבאה, הערך של המשתנה bookingStatus בכותרת התגובה מוקצה למשתנה transactionSuccess:

<Capture>
  <Collect>
    <Source>response</Source>
    <Header name="bookingStatus">
      <Pattern ignoreCase="true">{$}</Pattern>
    </Header>
  </Collect>
  <DataCollector scope="monetization">transactionSuccess</DataCollector>
</Capture>