이러한 작업의 핵심은 판매하는 제품 및 서비스입니다. 전자상거래 이벤트에 추가할 수 있는 항목의 배열로 제품과 서비스를 나타낼 수 있습니다. 사전 정의된 매개변수 외에도 최대 27개의 맞춤 매개변수를 항목 배열에 포함할 수 있습니다.
다음 예시는 이 가이드에서 언급하는 items 컬렉션을 만드는 방법을 보여줍니다. items 배열에는 최대 200개의 요소가 포함될 수 있습니다.
목록에서 항목 선택
사용자에게 결과 목록이 표시되면 표시된 항목을 포함하는 items 배열 매개변수를 비롯한 view_item_list 이벤트를 전송합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
사용자가 목록에서 항목을 선택하면 items 배열 매개변수에서 선택한 항목과 함께 select_item 이벤트를 전송합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
항목 세부정보 보기
항목 세부정보가 조회된 횟수를 측정하려면 사용자가 항목의 세부정보 화면을 볼 때마다 view_item 이벤트를 전송합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
장바구니에서 항목 추가 또는 삭제
items 배열에서 관련성 높은 항목이 포함된 add_to_cart 이벤트를 전송하여 장바구니에 추가되는 항목을 측정합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
items 배열에 있는 관련 항목이 포함된 add_to_wishlist 이벤트를 전송하여 항목이 위시리스트에 추가된 시점을 측정할 수도 있습니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
사용자가 이후에 장바구니를 볼 때 view_cart 이벤트를 장바구니에 있는 모든 항목과 함께 전송합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
사용자가 장바구니에서 항목을 삭제하는 시점을 측정하려면 remove_from_cart 이벤트를 전송합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
결제 프로세스 시작
관련성 높은 필드로 정의된 하나 이상의 항목을 통해 begin_checkout 이벤트를 전송하여 결제 프로세스의 첫 번째 단계를 측정합니다. 쿠폰을 이벤트에 추가하여 이 단계에서 전체 주문에 추가하거나, items 배열의 특정 요소에 추가하여 특정 상품에 적용할 수 있습니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
사용자가 결제 과정의 다음 단계로 이동하여 배송 정보를 추가하면 add_shipping_info 이벤트를 전송합니다. shipping_tier 매개변수를 사용하여 사용자의 배송 옵션(예: '지상', '항공' 또는 '익일')을 지정합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
사용자가 결제 정보를 제출하면 add_payment_info 이벤트를 전송합니다.
해당하는 경우 선택한 결제 수단에 대해 이 이벤트에 payment_type을 추가합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
구매 또는 환불 처리
관련성 높은 필드로 정의된 하나 이상의 항목과 함께 purchase 이벤트를 전송하여 구매를 측정합니다. 전송할 매개변수에 대한 자세한 내용은 이벤트 참조를 참고하세요.
관련 transaction_id가 지정된 refund 이벤트의 경우 item_id 및 quantity로 정의된 하나 이상의 항목을 전송하여 환불을 측정합니다. refund참고: 애널리틱스에서 상품 수준의 환불 측정항목을 확인하려면 이벤트에 상품 정보를 포함하는 것이 좋습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-23(UTC)"],[[["\u003cp\u003eEcommerce events in Google Analytics 4 allow you to track and analyze user shopping behavior, including product popularity and the impact of promotions.\u003c/p\u003e\n"],["\u003cp\u003eThis guide details how to implement various ecommerce events, such as viewing items, adding to cart, initiating checkout, and making purchases, using an \u003ccode\u003eitems\u003c/code\u003e array to represent products.\u003c/p\u003e\n"],["\u003cp\u003eEach ecommerce event requires specific parameters outlined in the Events reference provided for accurate data collection and analysis.\u003c/p\u003e\n"],["\u003cp\u003eYou can track internal promotions using \u003ccode\u003eview_promotion\u003c/code\u003e and \u003ccode\u003eselect_promotion\u003c/code\u003e events to measure impressions and clicks, respectively.\u003c/p\u003e\n"],["\u003cp\u003eTo ensure accurate revenue calculation, always set the \u003ccode\u003ecurrency\u003c/code\u003e parameter when sending \u003ccode\u003evalue\u003c/code\u003e (revenue) data with your ecommerce events.\u003c/p\u003e\n"]]],["Ecommerce events track user shopping behavior, quantifying popular products and promotion impacts. Key actions to measure include: selecting items, viewing details, adding/removing from carts, initiating checkout, making purchases/refunds, and applying promotions. These actions use an `items` array, representing products with up to 27 custom parameters. Specific events like `view_item_list`, `select_item`, `add_to_cart`, `begin_checkout`, `purchase`, and `refund`, along with promotion events, track these user interactions.\n"],null,["# Measure ecommerce\n\nYou can set up ecommerce events to collect information about the shopping\nbehavior of your users. The events enable you to quantify your most popular\nproducts and see the influence of promotions and product placement on revenue.\n\nThis document describes each ecommerce event and when to set up the event. For a\nstep-by-step example of how to set up an ecommerce event, see [Set up a purchase\nevent](/analytics/devguides/collection/ga4/set-up-ecommerce).\n| **Got 3 mins?** Help us improve the Google Analytics ecommerce documentation by taking [a quick online survey](https://forms.gle/tVx6iijCWP2zWyUU9).\n\ngtag.js Tag Manager\n\nBefore you begin\n----------------\n\nRecommendations\n---------------\n\n- [Enable debug mode](https://support.google.com/analytics/answer/7201382) so you can see events in realtime and troubleshoot issues.\n- Review [the custom dimension and metric limits](https://support.google.com/analytics/answer/10075209#limits) when sending custom parameters with ecommerce events.\n- Set `currency` when sending `value` (revenue) data to ensure revenue metrics are calculated correctly.\n- Set each ecommerce parameter you have data for, regardless of whether the parameter is optional.\n- Use [the sample ecommerce website](https://enhancedecommerce.appspot.com/) to see an example of how to tag your website.\n- To ensure data populates properly in reports, follow the format in this document. If you need to set the items array outside of the ecommerce array, set the `currency` parameter at the event level when you send `value` (revenue) data.\n\nImplementation\n--------------\n\nA typical ecommerce implementation measures any of the following actions:\n\n- [Select an item from a list](#select_an_item_from_a_list)\n- [View item details](#view_item_details)\n- [Add/remove a product from a shopping cart](#add_or_remove_an_item_from_a_shopping_cart)\n- [Initiate the checkout process](#initiate_the_checkout_process)\n- [Make purchases or refunds](#make_a_purchase_or_issue_a_refund)\n- [Apply promotions](#apply_promotions)\n\nAt the heart of these actions are the products and services you sell. You can\nrepresent products and services as an array of items that can be added to\necommerce events. You can include up to 27 custom parameters in the items array,\nin addition to the prescribed parameters.\n\nThe following example demonstrates how to create the collection of `items` that\nare referenced throughout this guide. The `items` array can include up to 200\nelements.\n\nSelect an item from a list\n--------------------------\n\nWhen a user is presented with a list of results, send a `view_item_list` event\nincluding an `items` array parameter containing the displayed items. For details\non the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#view_item_list).\n\nOnce a user selects an item from the list, send the `select_item` event with the\nselected item in an `items` array parameter. For details on the parameters to\nsend, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#select_item).\n\nView item details\n-----------------\n\nTo measure how many times item details are viewed, send a `view_item` event\nwhenever a user views an item's details screen. For details on the parameters to\nsend, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#view_item).\n\nAdd or remove an item from a shopping cart\n------------------------------------------\n\nMeasure an item being added to a shopping cart by sending an `add_to_cart` event\nwith the relevant items in an `items` array. For details on the parameters to\nsend, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#add_to_cart).\n\nYou can also measure when an item is added to a wishlist by sending an\n`add_to_wishlist` event with the relevant items in an `items` array. For details\non the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#add_to_wishlist).\n\nWhen a user subsequently views the cart, send the `view_cart` event with all\nitems in the cart. For details on the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#view_cart).\n\nTo measure when a user removes an item from a cart, send the `remove_from_cart`\nevent. For details on the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#remove_from_cart).\n\nInitiate the checkout process\n-----------------------------\n\nMeasure the first step in a checkout process by sending a `begin_checkout` event\nwith one or more items defined with the relevant fields. A coupon can also be\nadded at this stage to the entire order by adding it to the event or applied to\na particular item by adding it to specific elements in the `items` array. For\ndetails on the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#begin_checkout).\n\nWhen a user proceeds to the next step in the checkout process and adds shipping\ninformation, send an `add_shipping_info` event. Use the parameter\n`shipping_tier` to specify the user's delivery option, such as \"Ground\", \"Air\",\nor \"Next-day\". For details on the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#add_shipping_info).\n\nSend the `add_payment_info` event when a user submits their payment information.\nIf applicable, include `payment_type` with this event for the chosen method of\npayment. For details on the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#add_payment_info).\n\nMake a purchase or issue a refund\n---------------------------------\n\nMeasure a purchase by sending a `purchase` event with one or more items defined\nwith the relevant fields. For details on the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#purchase).\n| **Note:** The `purchase` event replaces ecommerce_purchase and is different from the in_app_purchase event, which is reported automatically.\n\nMeasure refunds by sending a `refund` event with the relevant `transaction_id`\nspecified and one or more items defined with `item_id` and `quantity`. We\nrecommend that you include item information in your `refund` event to see\nitem-level refund metrics in Analytics.\n\nFor details on the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#refund).\n| **Note:** The refund event replaces `ecommerce_refund`.\n\nApply promotions\n----------------\n\nEcommerce includes support for measuring impressions and clicks of internal\npromotions, such as banners displayed to promote a sale.\n\nPromotion impressions are typically measured with the initial screen view by\nsending the `view_promotion` event with an items parameter to specify the\npromoted item. For details on the parameters to send, see the [Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#view_promotion).\n\nTo indicate a user clicked on a promotion, send a `select_promotion` event with\nthat item as an item parameter. For details on the parameters to send, see the\n[Events\nreference](https://developers.google.com/analytics/devguides/collection/ga4/reference/events#select_promotion)."]]
