ConverlayConverlay

识别用户

使用 converlay.identify() 将当前访客与客户数据关联。这可以提高 Meta CAPI 和 TikTok Events API 等广告平台上的匹配率。

API

identify()
converlay.identify({
  customerId: 'cust_12345',
  email: 'jane@example.com',
  phone: '+15551234567',
  firstName: 'Jane',
  lastName: 'Doe',
})

识别数据字段

领域类型描述
customerIdstring您的内部客户 ID
emailstring客户电子邮件地址
phonestring电话号码(推荐 E.164 格式)
firstNamestring客户名字
lastNamestring客户姓氏

PII 哈希

所有个人身份信息(电子邮件、电话、姓名)均以纯文本形式发送到 Converlay 收集端点,然后在服务器上使用 SHA-256 进行哈希处理,然后转发到广告平台。在散列之前应用特定于国家/地区的标准化(小写、空白修剪、电话格式)。

何时调用识别

  • 登录后 — 客户通过身份验证后
  • 结账时 — 当运输/账单信息可用时
  • 在帐户页面 — 当客户查看或更新其个人资料时

身份数据在当前会话中保留。后续的 track() 调用将自动包含已识别用户的数据。

示例

登录后

typescript
async function handleLogin(email, password) {
  const user = await api.login(email, password)

  // Identify after login
  converlay.identify({
    customerId: user.id,
    email: user.email,
    firstName: user.firstName,
    lastName: user.lastName,
  })
}

结账完成时

typescript
function onCheckoutComplete(order) {
  // Identify + track purchase
  converlay.identify({
    customerId: order.customerId,
    email: order.email,
    phone: order.phone,
    firstName: order.shippingAddress.firstName,
    lastName: order.shippingAddress.lastName,
  })

  converlay.track('purchase', {
    ecommerce: {
      transaction_id: order.id,
      value: order.total,
      currency: order.currency,
      items: order.lineItems.map(item => ({
        item_id: item.variantId,
        item_name: item.title,
        price: item.price,
        quantity: item.quantity,
      })),
    },
  })
}