# Purchase Events

Purchase events represent users' in-app purchases engagement. Measuring purchase events allow us to optimize the app monetization, including analyzing pricing, churn, and more.

The purchase events include four events:

1) The `purchase_triggered`, which is sent when the user is triggering a purchase process.
2) The `purchase_success` is sent when the user successfully finishes the purchase process.
3) The `purchase_canceled`, is sent when a user is canceling the purchase process in the middle. 4) The `purchase_failed`, is sent when the OS fails the purchase process.

| event name             | properties                | description                                                                     |
| :--------------------- | ------------------------- | ------------------------------------------------------------------------------- |
| **purchase_triggered** | uuid                      | The uuid of the device, on web platforms we generate a uuid4 and store in local |
|                        | version                   | Version name / number from zapp                                                 |
|                        | build number              | The number describes that last build built by zapp                              |
|                        | bundle_id                 | ID defined in zapp for this specific app version, and platform                  |
|                        | sdk_version               | SDK version selected on zapp                                                    |
|                        | quickbrick_version        | Quick brick version selected on zapp                                            |
|                        | layout_id                 | The UI Builder layout id that is presented on the device                        |
|                        | zapp_platform             | The zapp platform build                                                         |
|                        | analyticsCustomProperties | Custom properties that comes from the extensions object, only shows when used   |
|                        | currency_code             | The purchase currency                                                           |
|                        | purchase_id               | The store product id                                                            |
|                        | price_numeric             | The purchase price, numeric                                                     |
|                        | purchase_price            | The purchase price, can include currency symbols                                |
|                        | purchase_type             | The store purchase type, for example: subscription                              |
|                        | screen_name               | The storefront screen name in Zapp                                              |
|                        | purchase_name             | The purchase name as defined in the store                                       |
| **purchase_success**   | uuid                      | The uuid of the device, on web platforms we generate a uuid4 and store in local |
|                        | version                   | Version name / number from zapp                                                 |
|                        | build number              | The number describes that last build built by zapp                              |
|                        | bundle_id                 | ID defined in zapp for this specific app version, and platform                  |
|                        | sdk_version               | SDK version selected on zapp                                                    |
|                        | quickbrick_version        | Quick brick version selected on zapp                                            |
|                        | layout_id                 | The UI Builder layout id that is presented on the device                        |
|                        | zapp_platform             | The zapp platform build                                                         |
|                        | analyticsCustomProperties | Custom properties that comes from the extensions object, only shows when used   |
|                        | currency_code             | The purchase currency                                                           |
|                        | purchase_id               | The store product id                                                            |
|                        | price_numeric             | The purchase price, numeric                                                     |
|                        | purchase_price            | The purchase price, can include currency symbols                                |
|                        | purchase_type             | The store purchase type, for example: subscription                              |
|                        | screen_name               | The storefront screen name in Zapp                                              |
|                        | purchase_name             | The purchase name as defined in the store                                       |
| **purchase_canceled**  | uuid                      | The uuid of the device, on web platforms we generate a uuid4 and store in local |
|                        | version                   | Version name / number from zapp                                                 |
|                        | build number              | The number describes that last build built by zapp                              |
|                        | bundle_id                 | ID defined in zapp for this specific app version, and platform                  |
|                        | sdk_version               | SDK version selected on zapp                                                    |
|                        | quickbrick_version        | Quick brick version selected on zapp                                            |
|                        | layout_id                 | The UI Builder layout id that is presented on the device                        |
|                        | zapp_platform             | The zapp platform build                                                         |
|                        | analyticsCustomProperties | Custom properties that comes from the extensions object, only shows when used   |
|                        | currency_code             | The purchase currency                                                           |
|                        | purchase_id               | The store product id                                                            |
|                        | price_numeric             | The purchase price, numeric                                                     |
|                        | purchase_price            | The purchase price, can include currency symbols                                |
|                        | purchase_type             | The store purchase type, for example: subscription                              |
|                        | screen_name               | The storefront screen name in Zapp                                              |
|                        | purchase_name             | The purchase name as defined in the store                                       |
| **purchase_failed**    | uuid                      | The uuid of the device, on web platforms we generate a uuid4 and store in local |
|                        | version                   | Version name / number from zapp                                                 |
|                        | build number              | The number describes that last build built by zapp                              |
|                        | bundle_id                 | ID defined in zapp for this specific app version, and platform                  |
|                        | sdk_version               | SDK version selected on zapp                                                    |
|                        | quickbrick_version        | Quick brick version selected on zapp                                            |
|                        | layout_id                 | The UI Builder layout id that is presented on the device                        |
|                        | zapp_platform             | The zapp platform build                                                         |
|                        | analyticsCustomProperties | Custom properties that comes from the extensions object, only shows when used   |
|                        | currency_code             | The purchase currency                                                           |
|                        | purchase_id               | The store product id                                                            |
|                        | price_numeric             | The purchase price, numeric                                                     |
|                        | purchase_price            | The purchase price, can include currency symbols                                |
|                        | purchase_type             | The store purchase type, for example: subscription                              |
|                        | screen_name               | The storefront screen name in Zapp                                              |
|                        | purchase_name             | The purchase name as defined in the store                                       |