ユーザー識別
converlay.identify()を使用して、現在の訪問者を顧客データに関連付けます。これにより、Meta CAPIやTikTok Events APIなどの広告プラットフォームでのマッチ率が向上します。
API
identify()
converlay.identify({
customerId: 'cust_12345',
email: 'jane@example.com',
phone: '+15551234567',
firstName: 'Jane',
lastName: 'Doe',
})IdentifyDataフィールド
| フィールド | 型 | 説明 |
|---|---|---|
customerId | string | 内部顧客ID |
email | string | 顧客のメールアドレス |
phone | string | 電話番号（E.164形式推奨） |
firstName | string | 顧客の名 |
lastName | string | 顧客の姓 |
PIIハッシュ化
すべての個人を特定できる情報（メール、電話番号、氏名）はプレーンテキストでConverlay収集エンドポイントに送信され、広告プラットフォームへの転送前にサーバー上でSHA-256でハッシュ化されます。ハッシュ化前に国別の正規化（小文字化、空白トリミング、電話番号フォーマット）が適用されます。
identifyを呼び出すタイミング
- ログイン後 — 顧客が認証されたらすぐに
- チェックアウト時 — 配送先/請求先情報が利用可能になった時
- アカウントページ — 顧客がプロフィールを閲覧または更新した時
識別データは現在のセッション中保持されます。以降の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,
})),
},
})
}