Ecommerce

Ecommerce reporting provides insights into the shopping behavior of your users and allows you to quantify your most popular products and see how promotions and product placement affect revenues.

This guide outlines how to measure user interactions with products on ecommerce sites.

Example report: Average purchase revenue per user and purchases by item name.

Before you begin

Review the following to learn more about how ecommerce implementation and reporting works with Google Analytics 4.

Required vs optional ecommerce data

To improve the functionality of ecommerce reports, the following is recommended:

1. Set each ecommerce parameter for which you have available data, regardless of whether the parameter is optional.
2. Refer to Google Analytics 4 Events to review event parameter requirements and behavior for each ecommerce event you send.
3. Set currency when sending value (revenue) data to ensure revenue metrics can be calculated correctly.

Custom parameters and item limits

• If needed, custom parameters can be sent with ecommerce events. Custom dimensions and metrics limits will apply.
• The items array for any ecommerce event can include up to 200 elements.

Reporting

Ecommerce data is available through the following interfaces, each with varying levels of capabilities to provide insights into the shopping behavior of your users:

• Monetization reports in the Web UI.
• Free-form exploration in the Web UI.
• Google Analytics 4 Data API.
• BigQuery Export.

Product views and interactions

Measuring product views and interactions provides insights on how often products are shown, viewed, and selected by users. Combined with promotion data the following events can also help you measure the effectiveness of campaigns:

• view_item_list
• view_item
• select_item

view_item_list

Send when a user is shown a list of items/offerings.

See the view_item_list reference for details on parameter requirements and behaviors.

Example

A user visits a page and is shown a Related Products list.

gtag("event", "view_item_list", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

view_item

Send when a user is shown one specific item/offering.

See the view_item reference for details on parameter requirements and behaviors.

Example

A user views a product page.

See the view_item reference for details on parameter requirements and behaviors.

gtag("event", "view_item", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

select_item

Send when a user selects an item from a list.

See the select_item reference for details on parameter requirements and behaviors.

Example

A user clicks a product link from a Related products list.

gtag("event", "select_item", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

Promotion views and interactions

Measuring promotion views and interactions provides insights on how often promotions are shown, viewed, and selected by users. Combined with product data, the following events can also help you measure the effectiveness of campaigns:

• view_promotion
• select_promotion

view_promotion

Send when a user is shown one specific promotion.

See the view_promotion reference for details on parameter requirements and behaviors.

Example

A user views a page with a banner promoting a sale.

gtag("event", "view_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  location_id: "L_12345",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }
  ]
});

select_promotion

Send when a user selects a promotion.

See the select_promotion reference for details on parameter requirements and behaviors.

Example

A user clicks on a banner promoting a sale.

gtag("event", "select_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  location_id: "L_12345",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }
  ],
});

Pre-purchase interactions

To measure user behavior before checkout and gain insights on item performance, send the following events:

• add_to_wishlist
• add_to_cart
• remove_from_cart
• view_cart

add_to_wishlist

Send when a user adds an item to their wishlist.

See the add_to_wishlist reference for details on parameter requirements and behaviors.

Example

gtag("event", "add_to_wishlist", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ],
});

add_to_cart

Send when a user adds an item to their cart.

See the add_to_cart reference for details on parameter requirements and behaviors.

Example

gtag("event", "add_to_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

remove_from_cart

Send when a user removes an item from their cart.

See the remove_from_cart reference for details on parameter requirements and behaviors.

Example

gtag("event", "remove_from_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

view_cart

Send when a user views their cart.

See the view_cart reference for details on parameter requirements and behaviors.

Example

gtag("event", "view_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

Purchases, checkouts, and refunds

To measure product purchases and gain insights on item performance, send the following events:

• begin_checkout
• add_payment_info
• add_shipping_info
• purchase
• refund

begin_checkout

Send when a user starts the checkout process.

See the begin_checkout reference for details on parameter requirements and behaviors.

Example

gtag("event", "begin_checkout", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

add_payment_info

Send when a user adds their payment info during the checkout process.

See the add_payment_info reference for details on parameter requirements and behaviors.

Example

gtag("event", "add_payment_info", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  payment_type: "Credit Card",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

add_shipping_info

Send when a user adds their shipping information during the checkout process.

See the add_shipping_info reference for details on parameter requirements and behaviors.

Example

gtag("event", "add_shipping_info", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  shipping_tier: "Ground",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

purchase

Send when a user completes the purchase process.

See the purchase reference for details on parameter requirements and behaviors.

Example

gtag("event", "purchase", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 21.09,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 2.22,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    },
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 7,
      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: "black",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ],
});

refund

Send when a user requests a refund.

The are two supported types of refunds:

1. Partial - When only some of the purchased items are refunded.
2. Full - When all of the purchased items are refunded.

Note: The partial refund format can be used for a full refund, but all products from the original transaction must be included, otherwise your refund measurement will be inaccurate.

See the refund reference for details on parameter requirements and behaviors.

Partial refund example

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 12.21,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      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: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

Full refund example

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 12.21,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11
});