Dokumentation durchsuchen

Wascer Conversion Tracking app for Shopify dataLayer

Below is a list of data layer events and their respective payloads generated by the Conversion Tracking application: page_view Fired on every page load across the storefront. Does not include an ecommerce object. page_type values: home · product · category · basket · checkout · purchase · other The

11 Min. LesezeitAktualisiert am 6. November 2026

Below is a list of data layer events and their respective payloads generated by the Conversion Tracking application:

page_view

Fired on every page load across the storefront. Does not include an ecommerce object.

json
{
  "event": "page_view_wascer",
  "page_type": "product",
  "page_url": "https://sua-loja.myshopify.com/products/camiseta-basica",
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "phone": "+5511999999999",
    "city": "São Paulo",
    "region": "SP",
    "country": "BR",
    "zip": "01310-100",
    "customer_id": "1234567890",
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "abc123token",
    "cart_quantity": 2,
    "cart_value": 199.8,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 2,
        "price": 99.9,
        "line_total_price": 199.8
      }
    ]
  }
}

page_type values: home · product · category · basket · checkout · purchase · other

The Custom Pixel also emits market_id and market_handle at the top level when the store uses Shopify
Markets.

view_item

Fired when a customer views a product detail page. Re-fires on variant change.

json
{
  "event": "view_item_wascer",
  "page_type": "product",
  "page_url": "https://sua-loja.myshopify.com/products/camiseta-basica",
  "ecommerce": {
    "value": "99.90",
    "currency": "BRL",
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 1,
        "index": 1
      }
    ]
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "phone": "+5511999999999",
    "city": "São Paulo",
    "region": "SP",
    "country": "BR",
    "zip": "01310-100",
    "customer_id": "1234567890",
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "abc123token",
    "cart_quantity": 0,
    "cart_value": 0,
    "currency": "BRL",
    "lines": []
  }
}

view_item_list

Fired when a customer views a collection page.

json
{
  "event": "view_item_list_wascer",
  "page_type": "category",
  "page_url": "https://sua-loja.myshopify.com/collections/camisetas",
  "ecommerce": {
    "item_list_id": "gid://shopify/Collection/987654321",
    "item_list_name": "Camisetas",
    "currency": "BRL",
    "items": [
      {
        "item_id": "shopify_BR_1234567890",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 1,
        "index": 1
      },
      {
        "item_id": "shopify_BR_1234567891",
        "item_sku": "CAM-M-BRN",
        "item_variant": "9876543211",
        "item_name": "Camiseta Premium",
        "variant_name": "M / Branco",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-premium",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta-premium.jpg",
        "affiliation": "Minha Loja",
        "price": 149.9,
        "quantity": 1,
        "index": 2
      }
    ]
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "customer_id": "1234567890",
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "abc123token",
    "cart_quantity": 0,
    "cart_value": 0,
    "currency": "BRL",
    "lines": []
  }
}

For view_item_list , item_id omits the variant part ( shopify_BR_{productId} only) since the page
represents the product as a whole.

search_submitted

Fired when a customer submits a search query.

json
{
  "event": "search_wascer",
  "page_type": "other",
  "page_url": "https://sua-loja.myshopify.com/search?q=camiseta",
  "ecommerce": {
    "search_term": "camiseta",
    "currency": "BRL",
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 1,
        "index": 1
      }
    ]
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "customer_id": "1234567890",
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "abc123token",
    "cart_quantity": 0,
    "cart_value": 0,
    "currency": "BRL",
    "lines": []
  }
}

add_to_cart

Fired when a customer adds a product to the cart.

json
{
  "event": "add_to_cart_wascer",
  "page_type": "product",
  "page_url": "https://sua-loja.myshopify.com/products/camiseta-basica",
  "ecommerce": {
    "value": "99.90",
    "currency": "BRL",
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 1,
        "index": 1
      }
    ]
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "customer_id": "1234567890",
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "abc123token",
    "cart_quantity": 1,
    "cart_value": 99.9,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 1,
        "price": 99.9,
        "line_total_price": 99.9
      }
    ]
  }
}

remove_from_cart

Fired when a customer removes a product from the cart or reduces its quantity to zero.

json
{
  "event": "remove_from_cart_wascer",
  "page_type": "basket",
  "page_url": "https://sua-loja.myshopify.com/cart",
  "ecommerce": {
    "value": "99.90",
    "currency": "BRL",
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 1,
        "index": 1
      }
    ]
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "customer_id": "1234567890",
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "abc123token",
    "cart_quantity": 0,
    "cart_value": 0,
    "currency": "BRL",
    "lines": []
  }
}

view_cart

Fired when a customer views the cart page or opens the cart drawer.

json
{
  "event": "view_cart_wascer",
  "page_type": "basket",
  "page_url": "https://sua-loja.myshopify.com/cart",
  "ecommerce": {
    "value": "199.80",
    "currency": "BRL",
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 2,
        "index": 1
      }
    ]
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "customer_id": "1234567890",
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "abc123token",
    "cart_quantity": 2,
    "cart_value": 199.8,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 2,
        "price": 99.9,
        "line_total_price": 199.8
      }
    ]
  }
}

begin_checkout

Fired when a customer starts the checkout process. Custom Pixel only — the Theme App Block does not
have access to the checkout context.

json
{
  "event": "begin_checkout_wascer",
  "page_type": "checkout",
  "page_url": "https://sua-loja.myshopify.com/checkouts/abc123",
  "checkout_token": "abc123def456",
  "ecommerce": {
    "value": "199.80",
    "currency": "BRL",
    "cart_total": "199.80",
    "cart_quantity": 2,
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 2,
        "index": 1
      }
    ]
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "phone": "+5511999999999",
    "street": "Rua das Flores, 123",
    "city": "São Paulo",
    "region": "SP",
    "country": "BR",
    "zip": "01310-100",
    "customer_id": "1234567890",
    "new_customer": false,
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "gid://shopify/Cart/abc123",
    "cart_quantity": 2,
    "cart_value": 199.8,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 2,
        "price": 99.9,
        "line_total_price": 199.8
      }
    ]
  }
}

add_contact_info

Fired when a customer submits their contact information (email/phone) at checkout. Custom Pixel only.

json
{
  "event": "add_contact_info_wascer",
  "page_type": "checkout",
  "page_url": "https://sua-loja.myshopify.com/checkouts/abc123/contact",
  "checkout_token": "abc123def456",
  "ecommerce": {
    "value": "199.80",
    "currency": "BRL",
    "cart_total": "199.80",
    "cart_quantity": 2,
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 2,
        "index": 1
      }
    ]
  },
  "user_data": {
    "email": "[email protected]",
    "phone": "+5511999999999",
    "customer_id": "1234567890",
    "new_customer": false,
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "gid://shopify/Cart/abc123",
    "cart_quantity": 2,
    "cart_value": 199.8,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 2,
        "price": 99.9,
        "line_total_price": 199.8
      }
    ]
  }
}

add_address_info

Fired when a customer submits their shipping address at checkout. Custom Pixel only.

json
{
  "event": "add_address_info_wascer",
  "page_type": "checkout",
  "page_url": "https://sua-loja.myshopify.com/checkouts/abc123/shipping",
  "checkout_token": "abc123def456",
  "ecommerce": {
    "value": "199.80",
    "currency": "BRL",
    "cart_total": "199.80",
    "cart_quantity": 2,
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "price": 99.9,
        "quantity": 2,
        "index": 1
      }
    ]
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "phone": "+5511999999999",
    "street": "Rua das Flores, 123",
    "city": "São Paulo",
    "region": "SP",
    "country": "BR",
    "zip": "01310-100",
    "customer_id": "1234567890",
    "new_customer": false,
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "gid://shopify/Cart/abc123",
    "cart_quantity": 2,
    "cart_value": 199.8,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 2,
        "price": 99.9,
        "line_total_price": 199.8
      }
    ]
  }
}

add_shipping_info

Fired when a customer selects a shipping method at checkout. Custom Pixel only.

json
{
  "event": "add_shipping_info_wascer",
  "page_type": "checkout",
  "page_url": "https://sua-loja.myshopify.com/checkouts/abc123/shipping",
  "checkout_token": "abc123def456",
  "ecommerce": {
    "value": "199.80",
    "currency": "BRL",
    "cart_total": "199.80",
    "cart_quantity": 2,
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 2,
        "index": 1
      }
    ]
  },
  "delivery": {
    "shipping_tier": "Sedex",
    "shipping_amount": 15.9,
    "shipping_discount_amount": 0,
    "delivery_method_type": "shipping",
    "currency": "BRL",
    "address_province_code": "SP",
    "address_zip": "01310-100"
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "phone": "+5511999999999",
    "street": "Rua das Flores, 123",
    "city": "São Paulo",
    "region": "SP",
    "country": "BR",
    "zip": "01310-100",
    "customer_id": "1234567890",
    "new_customer": false,
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "gid://shopify/Cart/abc123",
    "cart_quantity": 2,
    "cart_value": 199.8,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 2,
        "price": 99.9,
        "line_total_price": 199.8
      }
    ]
  }
}

add_payment_info

Fired when a customer submits their payment information at checkout. Custom Pixel only.

json
{
  "event": "add_payment_info_wascer",
  "page_type": "checkout",
  "page_url": "https://sua-loja.myshopify.com/checkouts/abc123/payment",
  "checkout_token": "abc123def456",
  "ecommerce": {
    "value": "199.80",
    "currency": "BRL",
    "cart_total": "199.80",
    "cart_quantity": 2,
    "payment_type": "credit_card",
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 2,
        "index": 1
      }
    ]
  },
  "delivery": {
    "shipping_tier": "Sedex",
    "shipping_amount": 15.9,
    "shipping_discount_amount": 0,
    "delivery_method_type": "shipping",
    "currency": "BRL",
    "address_province_code": "SP",
    "address_zip": "01310-100"
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "phone": "+5511999999999",
    "street": "Rua das Flores, 123",
    "city": "São Paulo",
    "region": "SP",
    "country": "BR",
    "zip": "01310-100",
    "customer_id": "1234567890",
    "new_customer": false,
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "gid://shopify/Cart/abc123",
    "cart_quantity": 2,
    "cart_value": 199.8,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 2,
        "price": 99.9,
        "line_total_price": 199.8
      }
    ]
  }
}

purchase

Fired when a customer completes an order (thank you page). Custom Pixel only.

json
{
  "event": "purchase_wascer",
  "page_type": "purchase",
  "page_url": "https://sua-loja.myshopify.com/thank-you/orders/abc123",
  "checkout_token": "abc123def456",
  "ecommerce": {
    "transaction_id": "gid://shopify/Order/1122334455",
    "value": "215.70",
    "currency": "BRL",
    "cart_total": "215.70",
    "cart_quantity": 2,
    "sub_total": 199.8,
    "tax": 0,
    "shipping": 15.9,
    "coupon": "DESCONTO10",
    "discount": "DESCONTO10",
    "discount_amount": 10.0,
    "discount_percentage": null,
    "payment_type": "credit_card",
    "items": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "item_name": "Camiseta Básica",
        "variant_name": "P / Preto",
        "item_brand": "Nike",
        "item_category": "Camisetas",
        "item_url": "/products/camiseta-basica",
        "imageURL": "https://cdn.shopify.com/s/files/1/0000/0001/products/camiseta.jpg",
        "affiliation": "Minha Loja",
        "price": 99.9,
        "quantity": 2,
        "index": 1,
        "discount": 10.0
      }
    ]
  },
  "delivery": {
    "shipping_tier": "Sedex",
    "shipping_amount": 15.9,
    "shipping_discount_amount": 0,
    "delivery_method_type": "shipping",
    "currency": "BRL",
    "address_province_code": "SP",
    "address_zip": "01310-100"
  },
  "user_data": {
    "first_name": "João",
    "last_name": "Silva",
    "email": "[email protected]",
    "phone": "+5511999999999",
    "street": "Rua das Flores, 123",
    "city": "São Paulo",
    "region": "SP",
    "country": "BR",
    "zip": "01310-100",
    "customer_id": "1234567890",
    "new_customer": false,
    "shopify_client_id": "abc123def456"
  },
  "cart_state": {
    "cart_id": "gid://shopify/Cart/abc123",
    "cart_quantity": 2,
    "cart_value": 215.7,
    "currency": "BRL",
    "lines": [
      {
        "item_id": "shopify_BR_1234567890_9876543210",
        "item_name": "Camiseta Básica",
        "item_sku": "CAM-P-PRT",
        "item_variant": "9876543210",
        "quantity": 2,
        "price": 99.9,
        "line_total_price": 199.8
      }
    ]
  }
}

Field Reference

item object

Field

Type

Description

item_id

string

Proshopify_BR_{productId}{variantId} . For view_item_list , variant part is omitted: shopify_BR{productId}

item_sku

string

Product SKU

item_variant

string

Numeric Shopify variant ID

item_name

string

Product title

variant_name

string

Variant title (e.g. “P / Preto” )

item_brand

string

Product vendor

item_category

string

Product type

item_url

string

Product URL path

imageURL

string

Featured image URL

affiliation

string

Shop name (configured in app settings)

price

number

Unit price in the store currency

quantity

number

Quantity

index

number

Position in the list (1-based)

discount

number

Discount amount applied to the line item (Custom Pixel only)

item_selling_plan_id

string

Selling plan ID — subscriptions (Custom Pixel only)

item_selling_plan_name

string

Selling plan name — subscriptions (Custom Pixel only)

user_data object

Field

Type

Description

first_name

string

Customer first name

last_name

string

Customer last name

email

string

Customer email

phone

string

Customer phone

street

string

Street address (Custom Pixel / checkout only)

city

string

City

region

string

Province/state code (e.g. “SP” )

country

string

Country code (e.g. “BR” )

zip

string

Postal code

customer_id

string

Shopify customer ID

new_customer

boolean

true if this is the customer’s first order (Custom Pixel / checkout only)

shopify_client_id

string

Shopify browser client identifier (Custom Pixel only)

delivery object

Presente nos eventos de finalização de compra (begin_checkout through purchase). Somente Pixel personalizado.

Field

Type

Description

shipping_tier

string

Shipping method name (e.g. “Sedex” )

shipping_amount

number

Shipping cost

shipping_discount_amount

number

Discount applied to shipping

delivery_method_type

string

“shipping” , “pickup” , etc.

currency

string

Currency code

address_province_code

string

Province/state code of shipping address

address_zip

string

Postal code of shipping address

cart_state object

Field

Type

Description

cart_id

string

Cart token (Theme App Block) or Cart GID (Custom Pixel)

cart_quantity

number

Total number of items in cart

cart_value

number

Total cart value

currency

number

Currency code

lines

array

Cart line items

lines[].item_id

string

shopify_BR_{productId}_{variantId}

lines[].item_name

string

Product title

lines[].item_sku

string

Product SKU

lines[].item_variant

string

Numeric variant ID

lines[].quantity

number

Line item quantity

lines[].price

number

Unit price

lines[].line_total_price

number

Total price for the line

top-level fields (Custom Pixel only)

Field

Type

Description

market_id

string

Shopify Market numeric ID (omitted if no market)

market_handle

string

Shopify Market handle (omitted if no market)

checkout_token

string

Checkout token — present on all checkout events only

Architecture Notes

  • Null / empty fields are automatically stripped from all payloads — fields with null , undefined or “” values are not included.
  • Deduplication — the Theme App Block waits 500 ms after page load and skips any event already emitted by the Custom Pixel within the last 1.5 s.
  • Checkout events ( begin_checkout through purchase ) are fired exclusively by the Custom Pixel, which has access to Shopify’s checkout context.
  • Storefront events ( page_view through view_cart ) can be fired by both sources; the Custom Pixel takes priority.
  • ecommerce: null is pushed to the dataLayer before each ecommerce event to clear the previous ecommerce object, following Google’s GA4 recommendation.
  • page_view does not include an ecommerce object.