# Set up a purchase event This tutorial shows you how to set up a `purchase` event on your website so you can measure when someone makes a purchase. The tutorial includes the dimensions, metrics, and reports that Analytics populates with data from the event. To learn more about the ecommerce events, see [Measure ecommerce](https://developers.google.com/analytics/devguides/collection/ga4/ecommerce). > [!NOTE] > **Got 3 mins?** Help us improve the Google Analytics ecommerce documentation by taking [a quick online survey](https://forms.gle/7CVQx2XgneNT35u46). ## Before you begin This tutorial assumes that you've done the following: - [Create a Google Analytics account and property](https://support.google.com/analytics/answer/9304153#account) - [Create a web data stream for your website](https://support.google.com/analytics/answer/9304153#stream&zippy=%2Cweb) - [Place the Google Analytics tag on your website](https://support.google.com/analytics/answer/9304153#add-tag&zippy=%2Cadd-the-google-tag-directly-to-your-web-pages) It also assumes that you have the following: - Access to your website source code - The Editor (or above) role to the Google Analytics account ## Step 1: Add the event to your website You should place [the `purchase` event](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#purchase) on the page of your website where someone makes a purchase. For example, you could add the event on the confirmation page that appears when someone makes a purchase. This tutorial shows you how to add the event to a page where someone clicks a "Purchase" button. Place the event in a `
This is where the purchase form would go
\ gtag("event", "purchase", { transaction_id: "T_12345_1", value: 30.03, tax: 4.90, shipping: 5.99, currency: "USD", coupon: "SUMMER_SALE", items: \[ // If someone purchases more than one item, // you can add those items to the items array { item_id: "SKU_12345", item_name: "Stan and Friends Tee", affiliation: "Google Merchandise Store", coupon: "SUMMER_FUN", discount: 2.22, index: 0, item_brand: "Google", item_category: "Apparel", item_category2: "Adult", item_category3: "Shirts", item_category4: "Crew", item_category5: "Short sleeve", item_list_id: "related_products", item_list_name: "Related Products", item_variant: "green", location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo", price: 10.01, quantity: 3 }\] }); \ ## Step 2: Connect the event to a button You can set up the `purchase` event so it triggers when someone clicks a "Purchase" button in a few ways. One way is to add an ID to the "Purchase" button and then place the event code in an event listener. In the following example, the event is only sent when someone clicks a button with the ID `purchase`. \
This is where the purchase form would go
\ Once you enable debug mode, you will start to see events populate the *DebugView* report as people use your website. For example, clicking the "Purchase" button on your website populates the report with the following data. You can select an event to see the parameters, user properties, and items associated with the event. ![A screenshot of the DebugView report](https://developers.google.com/analytics/devguides/collection/ga4/img/debug-view.png) ## Step 4: See your ecommerce data After about 24 hours, the data you sent with the `purchase` event becomes available in your [reports](https://support.google.com/analytics/answer/9212670), [explorations](https://support.google.com/analytics/answer/7579450), and [Google Analytics Data API](https://developers.google.com/analytics/devguides/reporting/data/v1). You can also access the data in BigQuery when you [set up BigQuery Export](https://support.google.com/analytics/answer/9823238). The "purchase" event automatically populates a variety of prebuilt [dimensions and metrics](https://support.google.com/analytics/answer/9143382), which are used in reports and explorations. The following are some of the dimensions that are populated with data from the `purchase` event in the first step: | Parameter | Dimension | Value | |---|---|---| | `affiliation` | *Item affiliation* | Google Merchandise Store | | `currency` | *Currency* | USD | | `discount` | *Item discount amount* | 2.22 | | `index` | *Item list position* | 0 | | `item_brand` | *Item brand* | Google | | `item_category` | *Item category* | Apparel | | `item_id` | *Item ID* | SKU_12345 | | `item_list_id` | *Item list ID* | related_products | | `item_list_name` | *Item list name* | Related Products | | `item_name` | *Item name* | Stan and Friends Tee | | `item_variant` | *Item variant* | green | | `location_id` | *Item location ID* | ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) | | `shipping` | *Shipping amount* | 5.99 | | `tax` | *Tax amount* | 4.90 | | `transaction_id` | *Transaction ID* | T_12345 | In addition to the dimensions, Google Analytics populates a number of ecommerce and revenue-related metrics. For example, if a user clicks the "Purchase" button once, then the following metrics are populated in Google Analytics: - *Item revenue* metric has a value of $30.03 - *Total revenue* metric has a value of $30.03 - *Ecommerce purchases* metric has a value of 1 You can use these dimensions and metrics to build explorations and custom reports, but you can also use the following prebuilt [*Ecommerce purchases* report](https://support.google.com/analytics/answer/9786881) to see your ecommerce data: ![A screenshot of the Ecommerce purchases report](https://developers.google.com/static/analytics/devguides/collection/ga4/img/ecommerce-purchases-report.png)