Skip to main content
A biblioteca pública analytics.js do Topsort permite que marketplaces enviem facilmente eventos de interação do Topsort, como cliques, impressões e compras, com uma integração low-code. Usando uma tag HTML simples, o marketplace pode se conectar ao servidor de anúncios do Topsort e enviar todos os eventos de rastreamento relacionados a um anúncio.

Instalação

Carregue a biblioteca com uma tag <script>, definindo window.TS antes que a biblioteca seja carregada:

Com npm

Os imports são executados antes do restante de um módulo, portanto defina window.TS em um arquivo separado e importe esse arquivo primeiro:
Não substitua window.TS depois que a biblioteca tiver sido carregada. Para definir o token mais tarde, atribua window.TS.token.

Marcando Elementos Promovidos

Para permitir que o Topsort rastreie automaticamente cliques, impressões e compras, use o elemento HTML data-ts-* para marcar elementos promovidos na página.

Elementos orgânicos (não promovidos)

Elementos promovidos

Rastreamento de renders

A biblioteca reporta um evento de render assim que um elemento promovido é inserido na página, e uma impressão depois, quando esse elemento se torna visível. Os renders usam o mesmo atributo data-ts-resolved-bid, portanto nenhuma marcação adicional é necessária:
Os renders exigem um resolvedBidId explícito, portanto não são disparados para elementos orgânicos nem para data-ts-resolved-bid="inherit". Não reporte também renders, impressões ou cliques para esses elementos com um SDK do Topsort, ou eles serão contabilizados duas vezes.

Áreas clicáveis

Use data-ts-clickable para indicar quais áreas devem acionar um evento de clique:

Atribuição de banner

Na página de destino do banner, marque cada produto exibido no banner para que seus eventos sejam atribuídos ao banner:

Rastreamento de compras

Use o array JSON data-ts-items para rastrear compras:

Exemplo Completo

Este exemplo também usa o banners.js para a tag topsort-banner.