Conversion metrics

Conversion metrics establish when a player converts from non-paying to paying, or when a churned player returns to the game and becomes a paying player again.

While either of these data points are sufficient to determine this information, the last purchase date is preferable if it is available.

These metrics appear under the metrics object:

"metrics": {
  "joinDate": "2017-07-22T17:32:28.000Z",
  "conversion": {
    "lastPurchase": { "date": "2023-12-14T07:57:18.000Z", "platform": "Android" },
    "totalSpendToDate": { "total": 129.99, "currency": "USD" }
  }
}

Last purchase

lastPurchaseDate is the date of the player’s most recent purchase before the current transaction.

lastPurchasePlatform is the platform where that prior purchase happened.

Both are optional, but strongly recommended to allow us to understand conversion, reactivation, and channel changes.

Total spend to date

The total spend to date is the amount of money that this player has spent to date, not including the purchase represented by this transaction.