ConverlayConverlay

Identificación de usuarios

Usa converlay.identify() para asociar al visitante actual con datos de cliente. Esto mejora las tasas de coincidencia en plataformas publicitarias como Meta CAPI y TikTok Events API.

API

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

Campos de IdentifyData

CampoTipoDescripción
customerIdstringTu ID interno de cliente
emailstringCorreo electrónico del cliente
phonestringNúmero de teléfono (se recomienda formato E.164)
firstNamestringNombre del cliente
lastNamestringApellido del cliente

Hashing de PII

Toda la información de identificación personal (correo electrónico, teléfono, nombre) se envía en texto plano al endpoint de recopilación de Converlay y luego se hashea con SHA-256 en el servidor antes de reenviarse a las plataformas publicitarias. Se aplica normalización específica por país (conversión a minúsculas, eliminación de espacios, formato de teléfono) antes del hashing.

Cuándo llamar a identify

  • Tras el inicio de sesión — en cuanto el cliente se autentique
  • En el checkout — cuando la información de envío/facturación esté disponible
  • En la página de cuenta — cuando el cliente vea o actualice su perfil

Los datos de identidad persisten durante la sesión actual. Las llamadas posteriores a track() incluirán automáticamente los datos del usuario identificado.

Ejemplos

Tras el inicio de sesión

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,
  })
}

Al completar el checkout

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,
      })),
    },
  })
}
Anterior← Seguimiento de eventosSiguienteConsentimiento y privacidad →