Shopyy 2.0 Pixel 安装指南

本指南将帮助您在 Shopyy 2.0 店铺中集成 MKQ Pixel，通过自定义代码实现全站用户行为追踪，包括浏览、加购、下单等关键事件。

步骤 1：进入 Shopyy 后台

1. 登录您的 Shopyy 商家后台管理界面
2. 进入路径：店铺设置 > 系统设置 > 自定义代码
3. 找到页面头部：新建自定义脚本

📸 操作示意图：

步骤 2：安装全站基础 Pixel 代码

1. 在脚本内容区域粘贴以下代码
2. 将 MKQ_PIXEL_ID 替换为您专属的 Pixel ID
3. 保存配置

⚠️ 重要：请将代码中的 MKQ_PIXEL_ID 替换为您专属的 Pixel ID

📸 操作示意图：

<!-- mkq pixel code -->
<script type="text/javascript">
  !function(w,o,s,r,p,k,e){
    if(w.mkq) return;
    p = w.mkq = function(){ p.invokeFunc ? p.invokeFunc.apply(p, arguments) : p.qu.push(arguments) };
    if(!w._mkq) w._mkq = p;
    p.push = p; p.qu = [];
    k = o.createElement(s); k.async = true; k.src = r;
    e = o.getElementsByTagName(s)[0]; e.parentNode.insertBefore(k, e);
  }(window, document, "script", "//pixeltrack.clientgear.com/mkq.min.js");

  mkq('init', 'MKQ_PIXEL_ID');
  mkq('track', 'PageView', {
    title: document.title
  });
</script>
<!-- end mkq pixel code -->

步骤 3：配置行为事件代码

1. ViewContent（浏览商品详情页）

用途：追踪商品详情页浏览行为

说明：建议延迟加载以确保数据可用

📸 示例页面：

<script type="text/javascript">
  setTimeout(function () {
    try {
      var productData = pageProductAll?.[0] || {};
      var params = productData.params || {};

      mkq('track', "ViewContent", {
        value: params.price || null,
        currency: productData.ec_currency_code || null,
        content_name: params.productTitle || null,
        content_type: 'product',
        content_ids: params.product_id || null
      });
    } catch (e) {
      console.error("Error in ViewContent tracking:", e);
    }
  }, 500); // 延迟 0.5 秒
</script>

2. AddToCart（添加到购物车）

用途：追踪用户添加商品到购物车行为

说明：监听购物车按钮点击后的行为，适用于商品页或列表页

📸 示例页面：

<script type="text/javascript">
  try {
    var data = typeof ec_data === "object" && ec_data !== null ? ec_data : {};
    mkq('track', "AddToCart", {
      value: data.ec_data_price || null,
      currency: data.ec_currency_code || null,
      content_name: data.ec_data_name || null,
      content_type: 'product',
      content_ids: data.ec_data_id ? [data.ec_data_id] : [],
      contents: data
    });
  } catch (e) {
    console.error("Error in AddToCart tracking:", e);
  }
</script>

3. Purchase（订单支付成功）

用途：追踪用户完成购买行为

说明：部署于"支付成功页"，用于记录最终转化行为

📸 示例页面：

<script type="text/javascript">
  try {
    mkq('track', "Purchase", {
      order_id: '1',
      value: 1.00,
      currency: 'USD',
      content_name: 'Product Name',
      content_type: 'product',
      content_ids: ['goods-id'],
      num_items: 1,
      contents: []
    });
  } catch (e) {
    console.error("Error in Purchase tracking:", e);
  }
</script>

步骤 4：完成安装

在所有代码配置完成后，保存并发布配置即可。