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> 标签首行。