This article provides an explanation of the data layers' parameters and their ability to capture and analyze crucial data related to your customers, orders, products, and pages. In this article, we will take a deep dive into these parameters and provide their user descriptions to give you a better understanding.
User (Customer) Parameters
User parameters capture relevant data about your customers and attach it to relevant events for tracking across Google Analytics 4, Google Ads, and other integrations. Example values include User ID, total spent, order count, phone number, address, email, and more.
user.type |
User type refers to a person's category or group on Shopify, such as member or visitor. |
user.page_currency_rate |
Shopify currency rate value; default: 1.0 (https://help.shopify.com/en/manual/payments/shopify-payments/multi-currency/conversion-fees) |
user.id |
The Shopify ID, which is a unique identification number for a users on the Shopify |
user.last_order |
The date of the logged-in user's latest order date on the Shopify platform. |
user.order_count |
The logged-in user's total number of orders on the Shopify platform. |
user.total_spent |
The total amount of revenue of the logged-in user |
user.email_sha256 |
The hashed(sha 256) email address of the logged-in user is a unique identifier generated by applying a cryptographic hash function to the user's email address. It is used for secure authentication and other purposes. |
user.email_sha1 |
The hashed(sha 1) email address of the logged-in user is a unique identifier generated by applying a cryptographic hash function to the user's email address. It is used for secure authentication and other purposes. |
user.email |
The email address(string) filled in by the customer in the Information step of the checkout process |
user.phone |
The phone number (string) filled in by the customer in the Information step of the checkout process |
user.address.firstName |
First Name filled in by the customer in the Information step of the checkout process |
user.address.lastName |
Last Name filled in by the customer in the Information step of the checkout process |
user.address.city |
City filled in by the customer in the Information step of the checkout process |
user.address.zip |
Zip Code (Postal Code) filled in by the customer in the Information step of the checkout process |
user.address.address1 |
The first line of the Address section(required) filled in by the customer in the Information step of the checkout process |
user.address.address2 |
The second line of the Address section(optional) filled in by the customer in the Information step of the checkout process |
user.address.country |
Country chosen by the customer in the Information step of the checkout process |
user.address.countryCode |
Country Code generated by Shopify depending on the chosen country in the Information step of the checkout process. |
user.address.province |
Province filled in by the customer in the Information step of the checkout process |
user.address.provinceCode |
Province Code generated by Shopify depending on the chosen province in the Information step of the checkout process. |
user.tags |
The logged-in user's statuses. i.e: Active Subscriber, New Customer |
Order Parameters
Order Parameters provide complete details of an order and enable you to capture important data. Example values may include Order ID, customer name, total value, products purchased, checkout ID, shipping method, payment type, and more.
order_id |
The Order Id is a unique identifier automatically generated by Shopify after transaction is completed. e.g 4878748221639 |
order_name |
The Order Name is a unique identifier assigned to a transaction created in the specified format through the Shopify interface. e.g #AB123 |
product(s) |
All available data of the product(s) that are purchased. Check product parameters for more details. |
currency |
The type of money that the user is currently using on the page |
quantity |
The number of each product in the cart, used to calculate the total and displayed to the customer. |
tax |
The tax price of the transaction |
shipping |
The shipping price of the transaction |
payment_type |
Payment Gateway which was selected by the customer while adding payment info |
checkout_id |
The Checkout Id is a unique identifier automatically generated by Shopify after transaction is completed.e.g 25736303935687 |
discount_amount |
The total discount amount of a transaction |
coupon |
The coupon code of the discount amount. |
totalValue |
The total cost of all products in the cart. Used to calculate the final price of the cart. |
totalQuantity |
The total number of products in the cart, used to calculate the total and displayed to the customer. |
shipping_method |
Shipping method which was selected by the customer while adding shipping info |
totalValue_presentment_money |
Amount in presentment currency |
currency_presentment_money |
Amount in shop currency |
category_handle |
The handle is used to build the URL for the resource, or to return properties for the resource. |
product_handle |
The handle is used to build the URL for the resource, or to return properties for the resource. |
Product Parameters
Product Parameters are used in a variety of events, such as "view item list", "select item", "view product", "add-to-cart", "begin checkout", "purchase", and many others. When multiple products are available, they are listed in an array. Example values for these parameters include Product ID, SKU, variant ID, price, discounted price, collection, and more.
product_id |
The Product Id is a unique identifier automatically generated by Shopify for each product in a store. This string of numbers, such as "6724874371230", is used to identify and manage the product. |
product_name |
The Product Title is the name or description of a product entered into the Shopify interface. It is displayed to customers and used to help them identify and learn more about the product. |
product_type |
The Product Type is a category or group assigned to a product through the Shopify interface, and is used to organize and classify products within a store. |
product_brand |
The Product Brand (Vendor) is the name of the company or individual that manufactures or sells the product. It is entered into the Shopify interface and displayed to customers for identification and searching. |
product_sku |
The Product SKU is a unique identifier assigned to a product through the Shopify interface and used to track and manage the product. For example, "PB2SEATAR". |
product_price |
The price of the product viewed. |
currency |
The type of money that the user is currently using on the page |
category_id |
Category Id the last element of the category list the product is included in |
category_name |
Category Name the last element of the category list the product is included in |
g_product_id |
The id format used by default in the Shopify Google Ads app that identifies a specific product. For example, "shopify_GB_11111111111_22222222222 (shopify_CountryCode_productID_variantID)", where "GB" represents the country code and the numbers represent the product or group of products. |
variant_id |
The Variant Id is a unique identifier automatically generated by Shopify for each product variant within a store. For example, "39952220061854". |
variant_title |
The Variant Title is the name or description of a product variant within a cart, and is used to help customers identify the specific product variant. |
category_handle |
The handle is used to build the URL for the resource, or to return properties for the resource. |
product_handle |
The handle is used to build the URL for the resource, or to return properties for the resource. |
Page Parameters
Page Parameters include all the attribution and navigation data related to a particular page. This includes information such as page type, page name, click IDs, UTM parameters, browser, referral, and more.
page_type |
Page type: refers to the type of content or purpose of a web page. Ex: product, blog, and purchase pages. |
page_currency |
The type of money that the user is currently using on the page |
page_data |
Classic page-level data such as page path, referrer, page title, etc. |