תיעוד נתוני מונטיזציה

הדף הזה רלוונטי ל-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. אם קוד הסטטוס של התגובה ב-HTTP הוא 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>