如何从无头 Shopify 商店向 Shoply AI 发送购物者事件

Shoply AI 会跟踪购物者行为（加入购物车、结账、浏览商品等），以改进搜索排名和推荐。在标准 Shopify 店面中，这会通过我们的 Web Pixel 扩展自动完成。但是，Shopify Web Pixels 无法在无头店面运行，因为它们依赖 Shopify 的店面渲染引擎注入像素沙箱。

如果你运营无头 Shopify 商店（例如使用 Next.js、Hydrogen 或自定义前端），则需要直接通过前端代码发送这些事件。

前提条件

你已经安装 Shoply AI，并且店面已加载 Shoply AI 脚本。

发送事件

Shoply AI 脚本加载后，会自动公开 window.shoplyLogEvent。直接调用即可，无需自行管理会话 ID、商店密钥或 API 端点：


window.shoplyLogEvent(eventName, data)

data 对象的结构取决于事件类型（见下文）。

支持转化跟踪所必需的事件

`product_added_to_cart`

购物者将商品变体加入购物车时触发此事件。


await window.shoplyLogEvent('product_added_to_cart', {
  "cartLine": {
    "cost": {
      "totalAmount": {
        "amount": 769,
        "currencyCode": "USD"
      }
    },
    "merchandise": {
      "id": "42553607094387",  // Variant ID
      "title": "25.5 Mondo",
      "price": {
        "amount": 769,
        "currencyCode": "USD"
      },
      "product": {
        "id": "7834124058739"  // Product ID
      }
    },
    "quantity": 1
  },
  "clientId": "35214700-144e-4022-974e-fe008736e973",  // Not used
  "referrer": "https://demo.shoplyai.ai/collections/all"
})

`checkout_completed`

如果使用 Shopify 原生结账，通常无需发送此事件，因为我们会使用 Web Pixel 事件自动跟踪结账完成情况。但是，如果你使用自己的结账流程，请在购物者完成结账时（例如在订单确认页面）触发此事件。


await window.shoplyLogEvent('checkout_completed', {
  "token": "8cea7db9ce551f0a8c9113a0f7f2dce0",  // Not used
  "order": {
    "id": "7251060916339",  // Shopify Order ID
    "customer": {
      "id": "9903183265907",  // Shopify Customer ID
      "isFirstOrder": true
    }
  },
  "lineItems": [
    {
      "finalLinePrice": {
        "amount": 1538,
        "currencyCode": "USD"
      },
      "quantity": 2,
      "variant": {
        "id": "42553607094387",  // Variant ID
        "title": "25.5 Mondo",
        "price": {
          "amount": 769,
          "currencyCode": "USD"
        },
        "product": {
          "id": "7834124058739"  // Product ID
        }
      }
    },
    {
      "finalLinePrice": {
        "amount": 384.93,
        "currencyCode": "USD"
      },
      "quantity": 1,
      "variant": {
        "id": "42553643958387",
        "title": "157 CM",
        "price": {
          "amount": 384.93,
          "currencyCode": "USD"
        },
        "product": {
          "id": "7834140180595"
        }
      }
    }
  ],
  "clientId": "35214700-144e-4022-974e-fe008736e973",  // Not used
  "referrer": "https://demo.shoplyai.ai/cart"
})

需要帮助？

欢迎预约与我们会面，我们会帮助你在无头店面中集成事件跟踪。