Saltar al contenido principal
Si estás usando Twilio Segment para rastrear eventos en tu sitio, puedes enviar eventos a Topsort directamente agregando el Destino Topsort en tu cuenta de Segment. Por favor consulta la documentación de Topsort en la base de conocimiento de Twilio Segments. Como prerrequisito para esta integración, debes tener una cuenta de Segment y una Fuente (sitio web o app) funcionando.
1

Entender los Eventos Requeridos

Topsort usa tres eventos principales, todos mapeados desde la Especificación de eCommerce de Segment:
Evento de TopsortMapeo por Defecto de SegmentMapeo Alternativo
impressionsProduct ViewedProduct List Viewed
clicksProduct ClickedProduct Added
purchasesOrder Completed—
  • Evita enviar clics duplicados. Si tanto Product Clicked como Product Added se disparan desde la misma acción del usuario, elige solo uno.
  • Si estás usando eventos personalizados, contacta a support@topsort.com para mapearlos correctamente.
2

Agregar el Destino Topsort en Segment

  1. En Segment, ve a Connections > Catalog > Destinations
  2. Busca Topsort, luego haz clic en Add Destination
  3. Selecciona la Fuente relevante (tu sitio o app)
Segment App
3

Configurar Ajustes de Destino

  1. En la Plataforma de Gestión de Topsort, ve a Settings > API Integration
  2. Copia o crea tu Marketplace API Key
  3. De vuelta en Segment, abre la pestaña Settings del destino Topsort y pega tu API Key
Segment Settings
La API Key permite a Segment enviar eventos a tu cuenta de Topsort.
4

Habilitar Eventos de Track y Agregar Metadatos

  1. Solo habilita los eventos de Track que estás enviando activamente desde tu sitio
Segment Mappings
Prevén el doble conteo revisando tu lógica de disparo de eventos.
  1. Agrega el campo resolvedBidId a:
  • Eventos de Product Viewed
  • Eventos de Product Clicked
El resolvedBidId identifica únicamente al ganador promovido de la subasta. Puedes recuperarlo desde la respuesta de la Auctions API o Proxy.Ejemplo de llamada:
analytics.track('Product Clicked', {
  productId: '12345',
  resolvedBidId: '67890' // requerido para atribución de Topsort
});
5

Identificar Usuarios

Topsort recomienda identificar usuarios logueados con el método identify de Segment. Ejemplo:
analytics.identify('361b1fdfbeaa9d64a13c033eb9f970dc6740f6bc', {
  email: 'john.doe@example.com'
});
Los usuarios sin sesión iniciada se rastrean con un anonymousId. Si usas fuentes del lado del servidor, incluye al menos userId o anonymousId. Una vez que se identifica un usuario, cada llamada al método Track de Segment registra automáticamente el ID del usuario. Los usuarios que no han iniciado sesión pueden rastrearse usando un anonymousId.

¿Necesitas ayuda con tu integración de Topsort?

Habla con nosotros, el equipo de ingeniería de integraciones.Contáctanos a través de tu canal de mensajería dedicado o en support@topsort.com.Si aún no eres cliente, agenda una demo con nuestro equipo de ventas.