# Conversion metrics

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

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:

```json
"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.