Data Layer Parameters

Here's everything you need to know about understanding data layers' parameters.

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.

Table Of Contents