Skip to main content
La biblioteca pública analytics.js de Topsort permite a los marketplaces enviar fácilmente eventos de interacción de Topsort, como clics, impresiones y compras, con una integración de bajo código. Al usar una simple etiqueta HTML, el marketplace puede conectarse al servidor de anuncios de Topsort y enviar todos los eventos de seguimiento relacionados con un anuncio.

Instalación

Carga la biblioteca con una etiqueta <script>, definiendo window.TS antes de que la biblioteca se cargue:

Con npm

Las importaciones se ejecutan antes que el resto de un módulo, así que define window.TS en un archivo separado e importa ese archivo primero:
No reemplaces window.TS después de que la biblioteca se haya cargado. Para definir el token más tarde, asigna window.TS.token en su lugar.

Marcando Elementos Promocionados

Para permitir que Topsort rastree automáticamente clics, impresiones y compras, usa el elemento HTML data-ts-* para marcar elementos promocionados en la página.

Elementos orgánicos (no promocionados)

Elementos promocionados

Seguimiento de renders

La biblioteca reporta un evento de render apenas un elemento promocionado se inserta en la página, y una impresión después, cuando ese elemento se vuelve visible. Los renders usan el mismo atributo data-ts-resolved-bid, por lo que no se necesita marcado adicional:
Los renders requieren un resolvedBidId explícito, por lo que no se disparan para elementos orgánicos ni para data-ts-resolved-bid="inherit". No reportes también renders, impresiones o clics para estos elementos con un SDK de Topsort, o se contarán dos veces.

Áreas clicables

Usa data-ts-clickable para indicar qué áreas deben activar un evento de clic:

Atribución de banner

En la página de destino del banner, marca cada producto destacado en el banner para que sus eventos se atribuyan al banner:

Seguimiento de compras

Usa el array JSON data-ts-items para rastrear compras:

Ejemplo End to End

Este ejemplo también usa banners.js para la etiqueta topsort-banner.