出海数字营销宝典 Logo
出海数字营销宝典evaoo.com
GTM + Customer Events API

Shopify GTM 与 Web Pixel 追踪代码生成器

基于 Shopify Customer Events API,生成 Google Tag Manager 与 GA4 电商事件追踪脚本。

11. 配置基本信息

22. 选择需要追踪的电商事件

33. 生成的代码片段

复制下方脚本,粘贴到 Shopify 后台 -> 设置 -> 客户事件(Customer Events)-> 添加自定义 Pixel。该沙盒 Pixel 会在全站与结账页捕获行为,并将标准电商数据推送到 GTM dataLayer。
// Shopify Custom Web Pixel (Checkout and Sandbox Compatible)
// Generated by Shopify Marketing & Analytics Hub

(function() {
  // Initialize the sandboxed GTM DataLayer
  window.dataLayer = window.dataLayer || [];

  var ZERO_DECIMAL_CURRENCIES = {
    BIF: 1, CLP: 1, DJF: 1, GNF: 1, ISK: 1, JPY: 1, KMF: 1, KRW: 1,
    MGA: 1, PYG: 1, RWF: 1, UGX: 1, VND: 1, VUV: 1, XAF: 1, XOF: 1, XPF: 1
  };
  var THREE_DECIMAL_CURRENCIES = {
    BHD: 1, IQD: 1, JOD: 1, KWD: 1, LYD: 1, OMR: 1, TND: 1
  };

  function getCurrencyDecimals(currencyCode, sampleValues) {
    var code = String(currencyCode || "USD").toUpperCase();
    var baseDecimals = ZERO_DECIMAL_CURRENCIES[code] ? 0 : (THREE_DECIMAL_CURRENCIES[code] ? 3 : 2);
    if (Array.isArray(sampleValues)) {
      for (var i = 0; i < sampleValues.length; i++) {
        var raw = sampleValues[i];
        if (raw === undefined || raw === null) continue;
        var s = String(raw).trim();
        var dotIdx = s.indexOf(".");
        if (dotIdx !== -1) {
          var frac = s.slice(dotIdx + 1).replace(/0+$/, "");
          if (frac.length > baseDecimals && frac.length <= 4) {
            baseDecimals = frac.length;
          }
        }
      }
    }
    return baseDecimals;
  }

  function toMinorUnits(val, decimals) {
    var d = typeof decimals === "number" ? decimals : 2;
    var n = parseFloat(val || "0");
    if (!Number.isFinite(n)) return 0;
    var factor = Math.pow(10, d);
    return Math.round((n + (n >= 0 ? 1 : -1) * Number.EPSILON) * factor);
  }

  function fromMinorUnits(minor, decimals) {
    var d = typeof decimals === "number" ? decimals : 2;
    var factor = Math.pow(10, d);
    return Math.round(minor) / factor;
  }

  function roundMoney(val, decimals) {
    return fromMinorUnits(toMinorUnits(val, decimals), decimals);
  }

  function expandItemWithRemainder(baseItem, lineNetTotal, decimals) {
    var qty = Number(baseItem.quantity) > 0 ? Math.floor(Number(baseItem.quantity)) : 1;
    var basePriceMinor = Math.max(0, toMinorUnits(baseItem._rawPrice, decimals));
    var netMinor = Math.max(0, toMinorUnits(lineNetTotal, decimals));

    if (qty <= 1) {
      var singleUnit = fromMinorUnits(netMinor, decimals);
      var singleDisc = fromMinorUnits(Math.max(0, basePriceMinor - netMinor), decimals);
      return [{
        item_id: baseItem.item_id,
        item_name: baseItem.item_name,
        price: singleUnit,
        discount: singleDisc,
        quantity: 1
      }];
    }

    var floorUnitMinor = Math.floor(netMinor / qty);
    var remCount = netMinor - floorUnitMinor * qty;

    if (remCount === 0) {
      var exactUnit = fromMinorUnits(floorUnitMinor, decimals);
      var exactDisc = fromMinorUnits(Math.max(0, basePriceMinor - floorUnitMinor), decimals);
      return [{
        item_id: baseItem.item_id,
        item_name: baseItem.item_name,
        price: exactUnit,
        discount: exactDisc,
        quantity: qty
      }];
    }

    var highUnitMinor = floorUnitMinor + 1;
    var highUnit = fromMinorUnits(highUnitMinor, decimals);
    var highDisc = fromMinorUnits(Math.max(0, basePriceMinor - highUnitMinor), decimals);
    var lowUnit = fromMinorUnits(floorUnitMinor, decimals);
    var lowDisc = fromMinorUnits(Math.max(0, basePriceMinor - floorUnitMinor), decimals);

    return [
      {
        item_id: baseItem.item_id,
        item_name: baseItem.item_name,
        price: highUnit,
        discount: highDisc,
        quantity: remCount
      },
      {
        item_id: baseItem.item_id,
        item_name: baseItem.item_name,
        price: lowUnit,
        discount: lowDisc,
        quantity: qty - remCount
      }
    ];
  }

  function mapCheckoutEcommerce(customData) {
    var currency = customData?.currencyCode || "USD";
    var rawItems = Array.isArray(customData?.lineItems) ? customData.lineItems : [];
    var sampleAmounts = [
      customData?.subtotalPrice?.amount,
      customData?.totalPrice?.amount,
      customData?.totalTax?.amount,
      customData?.shippingLine?.price?.amount
    ];
    rawItems.forEach(function(it) {
      sampleAmounts.push(it?.variant?.price?.amount, it?.finalLinePrice?.amount);
    });
    var decimals = getCurrencyDecimals(currency, sampleAmounts);

    var lineRecords = rawItems.map(function(item, idx) {
      var qty = Number(item?.quantity) > 0 ? Math.floor(Number(item.quantity)) : 1;
      var basePriceMinor = Math.max(0, toMinorUnits(item?.variant?.price?.amount, decimals));
      var basePrice = fromMinorUnits(basePriceMinor, decimals);
      var rawLineMinor = basePriceMinor * qty;

      var allocDiscountMinor = 0;
      if (Array.isArray(item?.discountAllocations)) {
        item.discountAllocations.forEach(function(d) {
          allocDiscountMinor += Math.max(0, toMinorUnits(d?.amount?.amount, decimals));
        });
      }
      var finalLineMinor = item?.finalLinePrice?.amount !== undefined && item?.finalLinePrice?.amount !== null
        ? Math.max(0, toMinorUnits(item.finalLinePrice.amount, decimals))
        : Math.max(0, rawLineMinor - allocDiscountMinor);

      return {
        _idx: idx,
        item_id: item?.variant?.id,
        item_name: item?.variant?.product?.title || item?.title,
        quantity: qty,
        _rawPrice: basePrice,
        _rawLineMinor: rawLineMinor,
        _lineNetMinor: finalLineMinor,
        _lineNet: fromMinorUnits(finalLineMinor, decimals)
      };
    });

    var itemsLineSumMinor = lineRecords.reduce(function(acc, r) {
      return acc + r._lineNetMinor;
    }, 0);
    var rawSubtotalMinor = lineRecords.reduce(function(acc, r) {
      return acc + r._rawLineMinor;
    }, 0);

    var explicitSubtotalMinor = customData?.subtotalPrice?.amount !== undefined && customData?.subtotalPrice?.amount !== null
      ? Math.max(0, toMinorUnits(customData.subtotalPrice.amount, decimals))
      : null;
    var taxMinor = Math.max(0, toMinorUnits(customData?.totalTax?.amount, decimals));
    var shippingMinor = Math.max(0, toMinorUnits(customData?.shippingLine?.price?.amount, decimals));
    var derivedFromTotalMinor = customData?.totalPrice?.amount !== undefined && customData?.totalPrice?.amount !== null
      ? Math.max(0, toMinorUnits(customData.totalPrice.amount, decimals) - taxMinor - shippingMinor)
      : null;

    var targetNetMinor = explicitSubtotalMinor !== null
      ? explicitSubtotalMinor
      : (derivedFromTotalMinor !== null ? derivedFromTotalMinor : itemsLineSumMinor);

    var finalItems = [];
    // If order-level subtotal differs from sum of line net amounts, allocate targetNetMinor across lines using Largest Remainder Method in minor units
    if (lineRecords.length > 0 && itemsLineSumMinor !== targetNetMinor) {
      var useLineNetWeight = itemsLineSumMinor > 0;
      var useRawWeight = !useLineNetWeight && rawSubtotalMinor > 0;
      var totalWeight = useLineNetWeight
        ? itemsLineSumMinor
        : (useRawWeight ? rawSubtotalMinor : lineRecords.length);

      var shares = lineRecords.map(function(rec, idx) {
        var w = useLineNetWeight ? rec._lineNetMinor : (useRawWeight ? rec._rawLineMinor : 1);
        var exact = totalWeight > 0 ? (targetNetMinor * w) / totalWeight : 0;
        var fl = Math.floor(exact);
        return {
          idx: idx,
          floorMinor: fl,
          frac: exact - fl
        };
      });

      var allocatedSum = shares.reduce(function(acc, s) { return acc + s.floorMinor; }, 0);
      var leftover = Math.max(0, targetNetMinor - allocatedSum);
      shares
        .slice()
        .sort(function(a, b) {
          if (b.frac !== a.frac) return b.frac - a.frac;
          return a.idx - b.idx;
        })
        .forEach(function(s, rank) {
          if (rank < leftover) {
            shares[s.idx].floorMinor += 1;
          }
        });

      lineRecords.forEach(function(rec, idx) {
        var lineShare = fromMinorUnits(shares[idx].floorMinor, decimals);
        var expanded = expandItemWithRemainder(rec, lineShare, decimals);
        finalItems = finalItems.concat(expanded);
      });
    } else {
      lineRecords.forEach(function(rec) {
        var expanded = expandItemWithRemainder(rec, rec._lineNet, decimals);
        finalItems = finalItems.concat(expanded);
      });
    }

    return {
      currency: currency,
      value: fromMinorUnits(targetNetMinor, decimals),
      tax: fromMinorUnits(taxMinor, decimals),
      shipping: fromMinorUnits(shippingMinor, decimals),
      items: finalItems
    };
  }
  
  // Load GTM library inside sandboxed environment
  (function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
  new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
  j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
  'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
  })(window,document,'script','dataLayer','GTM-XXXXXXX');

  // Event Analytics Subscriptions
  analytics.subscribe("page_viewed", (event) => {
    window.dataLayer.push({
      event: "shopify_page_viewed",
      id: event.id,
      clientId: event.clientId,
      timestamp: event.timestamp,
      url: event.context.document.location.href,
      referrer: event.context.document.referrer
    });
  });

  analytics.subscribe("product_viewed", (event) => {
    const customData = event.data?.productVariant;
    window.dataLayer.push({
      event: "view_item",
      timestamp: event.timestamp,
      ecommerce: {
        currency: customData?.price?.currencyCode || "USD",
        value: parseFloat(customData?.price?.amount || "0"),
        items: [{
          item_id: customData?.id,
          item_name: customData?.title,
          price: parseFloat(customData?.price?.amount || "0"),
          quantity: 1
        }]
      }
    });
  });

  analytics.subscribe("collection_viewed", (event) => {
    const customData = event.data?.collection;
    window.dataLayer.push({
      event: "view_item_list",
      timestamp: event.timestamp,
      ecommerce: {
        item_list_id: customData?.id,
        item_list_name: customData?.title,
        items: []
      }
    });
  });

  analytics.subscribe("product_added_to_cart", (event) => {
    const customData = event.data?.cartLine?.merchandise;
    window.dataLayer.push({
      event: "add_to_cart",
      timestamp: event.timestamp,
      ecommerce: {
        currency: customData?.price?.currencyCode || "USD",
        value: parseFloat(customData?.price?.amount || "0") * (event.data?.cartLine?.quantity || 1),
        items: [{
          item_id: customData?.id,
          item_name: customData?.product?.title,
          item_variant: customData?.title,
          price: parseFloat(customData?.price?.amount || "0"),
          quantity: event.data?.cartLine?.quantity || 1
        }]
      }
    });
  });

  analytics.subscribe("checkout_started", (event) => {
    const customData = event.data?.checkout;
    const mapped = mapCheckoutEcommerce(customData);
    window.dataLayer.push({
      event: "begin_checkout",
      timestamp: event.timestamp,
      ecommerce: {
        currency: mapped.currency,
        value: mapped.value,
        items: mapped.items
      }
    });
  });

  analytics.subscribe("checkout_completed", (event) => {
    const customData = event.data?.checkout;
    const mapped = mapCheckoutEcommerce(customData);
    window.dataLayer.push({
      event: "purchase",
      timestamp: event.timestamp,
      ecommerce: {
        transaction_id: customData?.order?.id || event.id,
        currency: mapped.currency,
        value: mapped.value,
        tax: mapped.tax,
        shipping: mapped.shipping,
        items: mapped.items
      }
    });
  });

  analytics.subscribe("search_submitted", (event) => {
    window.dataLayer.push({
      event: "search",
      search_term: event.data?.searchQuery
    });
  });

})();

部署步骤

  • 1填入你的 Google Tag Manager 容器 ID(例如 GTM-K17AB12)。
  • 2勾选需要在独立站追踪的页面与电商转化事件。
  • 3复制生成的“Shopify 结账沙盒 Pixel”脚本。登录 Shopify 后台,依次进入“设置 -> 客户事件”,点击“添加自定义 Pixel”,命名后粘贴代码并保存连接。
  • 4复制“GTM 主题加载器”代码,打开 Shopify 在线商店的主题代码编辑器,粘贴到 theme.liquid 文件的 <head> 标签首行。