ConverlayConverlay

快速入门

在 2 分钟内即可运行跟踪。请在下面选择您的方法。

普通 JavaScript

导入并初始化 createConverlay,然后为每个事件调用 track()。

tracking.ts
import { createConverlay } from '@converlay/sdk'

const converlay = createConverlay({
  shopDomain: 'my-store.myshopify.com',
  autoPageView: true,
  debug: true,
})

// Track a product view
converlay.track('view_item', {
  ecommerce: {
    items: [{
      item_id: 'SKU-001',
      item_name: 'Classic Tee',
      price: 29.99,
      quantity: 1,
    }],
  },
})

// Track a purchase
converlay.track('purchase', {
  ecommerce: {
    transaction_id: 'ORD-5678',
    value: 59.98,
    currency: 'USD',
    items: [
      { item_id: 'SKU-001', item_name: 'Classic Tee', price: 29.99, quantity: 2 },
    ],
  },
  userData: {
    email: 'customer@example.com',
  },
})

反应

使用 ConverlayProvider 包装您的应用程序,并在任何组件中使用 useConverlay() 挂钩。

App.tsx
'use client'

import { ConverlayProvider, useConverlay } from '@converlay/sdk/react'

// Wrap your app
export default function App({ children }) {
  return (
    <ConverlayProvider
      shopDomain="my-store.myshopify.com"
      autoPageView={true}
    >
      {children}
    </ConverlayProvider>
  )
}

// Use in any component
function AddToCartButton({ product }) {
  const { track } = useConverlay()

  return (
    <button onClick={() => {
      track('add_to_cart', {
        ecommerce: {
          items: [{
            item_id: product.id,
            item_name: product.title,
            price: product.price,
            quantity: 1,
          }],
        },
      })
    }}>
      Add to Cart
    </button>
  )
}

接下来会发生什么

  1. SDK 生成持久的 client_id 并通过 localStorage 管理 30 分钟的会话
  2. 自动捕获 UTM 参数和点击 ID(gclid、fbclid、ttclid)
  3. 事件通过 sendBeacon 发送到 Converlay 的收集端点(带有 fetch 后备)
  4. Converlay 将事件服务器到服务器转发到您连接的目标平台(GA4、Meta、TikTok 等)

后续步骤