Saltar para o conteúdo principal
Se você está usando Twilio Segment para rastrear eventos no seu site, pode enviar eventos ao Topsort diretamente adicionando o Destino Topsort na sua conta Segment. Por favor, consulte a documentação do Topsort na base de conhecimento do Twilio Segment. Como pré-requisito para esta integração, você deve ter uma conta Segment e uma Fonte (site ou aplicativo) funcionando.
1

Entenda os Eventos Necessários

O Topsort usa três eventos principais, todos mapeados da Especificação de eCommerce do Segment:
Evento TopsortMapeamento Padrão do SegmentMapeamento Alternativo
impressionsProduct ViewedProduct List Viewed
clicksProduct ClickedProduct Added
purchasesOrder Completed—
  • Evite enviar cliques duplicados. Se tanto Product Clicked quanto Product Added forem disparados pela mesma ação do usuário, escolha apenas um.
  • Se você estiver usando eventos personalizados, entre em contato em support@topsort.com para mapeá-los adequadamente.
2

Adicione o Destino Topsort no Segment

  1. No Segment, vá para Connections > Catalog > Destinations
  2. Busque por Topsort, depois clique em Add Destination
  3. Selecione a Fonte relevante (seu site ou aplicativo)
Segment App
3

Configure as Configurações do Destino

  1. Na Plataforma de Gerenciamento do Topsort, vá para Configurações > Integração de API
  2. Copie ou crie sua Chave de API do Marketplace
  3. De volta ao Segment, abra a aba Settings do destino Topsort e cole sua Chave de API
Segment Settings
A Chave de API permite que o Segment envie eventos para sua conta Topsort.
4

Habilite Eventos de Track e Adicione Metadados

  1. Habilite apenas os eventos de Track que você está enviando ativamente do seu site
Segment Mappings
Previna contagem dupla revisando sua lógica de disparo de eventos.
  1. Adicione o campo resolvedBidId para:
  • Eventos Product Viewed
  • Eventos Product Clicked
O resolvedBidId identifica exclusivamente o vencedor promovido do leilão. Você pode recuperá-lo da API de Leilões ou resposta do Proxy.Exemplo de chamada:
analytics.track('Product Clicked', {
  productId: '12345',
  resolvedBidId: '67890' // obrigatório para atribuição do Topsort
});
5

Identifique Usuários

O Topsort recomenda identificar usuários logados com o método identify do Segment. Exemplo:
analytics.identify('361b1fdfbeaa9d64a13c033eb9f970dc6740f6bc', {
  email: 'joao.silva@exemplo.com'
});
Usuários deslogados são rastreados com um anonymousId. Se usar fontes do lado do servidor, inclua pelo menos userId ou anonymousId. Uma vez que um usuário é identificado, cada chamada ao método Track do Segment registra automaticamente o ID do usuário. Usuários que não estão logados podem ser rastreados usando um anonymousId.

Precisa de ajuda com sua integração Topsort?

Fale conosco, a equipe de engenharia de integrações.Entre em contato através do seu canal de mensagens dedicado ou em support@topsort.com.Se você ainda não é cliente, agende uma demo com nossa equipe de vendas.