识别用户
使用 converlay.identify() 将当前访客与客户数据关联。这可以提高 Meta CAPI 和 TikTok Events API 等广告平台上的匹配率。
API
identify()
converlay.identify({
customerId: 'cust_12345',
email: 'jane@example.com',
phone: '+15551234567',
firstName: 'Jane',
lastName: 'Doe',
})识别数据字段
| 领域 | 类型 | 描述 |
|---|---|---|
customerId | string | 您的内部客户 ID |
email | string | 客户电子邮件地址 |
phone | string | 电话号码(推荐 E.164 格式) |
firstName | string | 客户名字 |
lastName | string | 客户姓氏 |
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,
})),
},
})
}